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 next	Print the next one-slice agent prompt. It does not run an agent.
ds task checkpoint <target>	Record files, tests, misses, learnings, and decision gate.
ds task finish <target>	Finish one target with promote, improve, rework, rollback, or block.

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 and follow-up commands.
ds recent [topic]	Show recently active local git topics.
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 prompt <target>	Emit a prompt bounded to one task target.
ds task start <target>	Mark one target active.
ds task next <task-id>	Show the intended next target.
ds task status <task-id>	Show series, slice, and iteration state.
ds task sync <task-id>	Recapture edited task artifacts into the local index.
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 quick <query>	Create a compact one-off workspace for smaller slices.

Setup And Maintenance

Command	Use
ds scan	Index configured intent-artifact 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.

Most read commands support --json for scripts and editor adapters.