Match the command to the lifecycle.
Compose layers without booting a model, tool, Host, or Agent.
--dump-configLong-lived browser Host with Sessions, settings, and streaming UI.
dsh webOne task, one fresh persisted Session, final text, then process exit.
--profile headlessInstall and compose an out-of-tree bundle under its own contract.
dsh pluginHeadless owns one interval.
npx @deepseek-ai/dsh@0.1.0-rc.7 --profile headless \
"Inspect this repository. Do not edit files. Report risks with file evidence."
Read three process signals separately.
Useful review output. Not proof that a requested side effect exists.
Empty on success; terminal Agent errors or boot diagnostics on failure.
0 only when the final owned turn/end is completed.
Tests, files, diffs, artifacts, and deployment probes decide real completion.
Inspect before spending.
01Defaultshipped bundle layers02Resolvedprofile + home + argv patches03Reviewprovider, tools, policy, persistence04Runexact workspace + bounded taskWant terminal chat? Audit the profile.
dsh --profile tui --dump-configdsh --profile tui --helpPrimary evidence.
- Official CLI entry modes
- Exact CLI lifecycle and precedence
- Headless bundle contract
- Headless durable outcome implementation
- Community terminal UI discussion #67
Keep the CI contract.
The full guide includes exact stdout, stderr, exit-status, approval, configuration, app-argument, failure, and TUI audit behavior.
Read the full guide