Command Reference
Run ds <command> --help for exact current flags.
Start Here
| Command | Use |
|---|---|
ds init | Initialize local state, repo config, and optional agent adapter files. |
ds task <query> | Create a bounded task workspace with packed context. |
ds apply | Print the next one-slice agent prompt. It does not run an agent. |
ds task checkpoint <task-id|target> | Record files, tests, misses, learnings, and decision gate. |
Trust Layer
Use these when the target is unclear or you want evidence before creating or continuing a task.
| Command | Use |
|---|---|
ds map [area] | Show architecture/system boundaries from local repo evidence and suggest follow-up commands. |
ds recent [topic] | Show recently active local work, boundary hints, and follow-up context commands. |
ds find <query> | Build packed context for a query. |
ds find <query> --plain | Show flat ranked results instead of the default context pack. |
ds context <id> | Export one exact indexed artifact as agent-ready context. |
ds show <id> | Show artifact details. |
Task Lifecycle
| Command | Use |
|---|---|
ds task show <target> | Show exact context for one task target. |
ds task next <task-id> | Show the intended next target. |
ds task status <task-id> | Show series, slice, and iteration state. |
ds task slice add <task-id> "<title>" --after A01 --reason improve | Create a follow-up such as A01-1 under an existing slice after improve or rework. |
ds task refresh <task-id> | Refresh task artifacts in the index without rewriting task docs. |
ds task audit <target> | Compare observed work against target scope. |
ds task "<query>" --quick | Create a compact one-off workspace for smaller slices. |
Setup And Maintenance
| Command | Use |
|---|---|
ds scan | Index configured intent, source, test, docs, and git evidence paths. Most workflows can let task/find/map refresh automatically. |
ds config show | Inspect effective repo discovery config. |
ds update | Check latest release and print update guidance. |
ds tldr | Show LLM-oriented quickstarts by workflow type. |
Workspace Coordination
Workspace coordination is experimental and explicit. Use it when one umbrella directory coordinates work across several child repos.
| Command | Use |
|---|---|
ds workspace init . | Create an umbrella workspace manifest and change directory. |
ds workspace change create "<title>" | Create a workspace-level change record. |
ds workspace slice create <change-id> | Create a repo-local task slice linked to a workspace change. |
ds workspace trace <change-id|task-id> | Trace known workspace changes and linked repo-local slices. |
ds ws is a shortcut for ds workspace.
For task lifecycle work, prefer ds apply, ds task checkpoint,
ds task refresh, and ds task "<query>" --quick.
Most read commands support --json for scripts and editor adapters.
Non-quiet cold indexing progress is written to stderr. Use --quiet or
--json for result-only automation, and --verbose when you need lower-level
phase details.