Start with the built-in command surface

Run the package help before copying a third-party command. This confirms the command surface installed in your environment rather than the surface a guide observed on another release.

Inspect current CLI · shell
npx @deepseek-ai/dsh --help
npx @deepseek-ai/dsh web --help

Choose the mode that matches the task

Use Web UI for interactive setup and task work. Use profiles to keep named configuration shapes separate. Use headless execution only after credentials, workspace, permission policy, and output handling are understood. Configuration dumps are valuable for diagnosis but must be checked for sensitive values before sharing.

  • web: interactive browser workflow.
  • profile: named configuration boundary.
  • headless: automation-friendly execution with stricter output and failure handling needs.
  • plugin: package operations forwarded through the plugin command surface.
  • dump/config inspection: useful for diagnosis; review before publishing.

Plugin commands need a verification step

An add command returning successfully is not equivalent to the plugin loading or completing its feature task. After add or update, restart when required, confirm the plugin is discovered, run a narrow smoke test, and preserve the remove or rollback command. Build-script permissions such as allowBuilds deserve explicit review.

Discover plugin subcommands · shell
npx @deepseek-ai/dsh plugin --help

Keep automation inside the permission boundary

Headless execution can make permission prompts and filesystem consequences less visible. Lock the workspace, sandbox, approval policy, network expectations, and output destination before treating it as a CI command.

Command verification still required

HarnessBase will run the major commands against the tracked release, capture exit states and representative output, and only then convert this draft into an indexable reference.

Sources and evidence boundary

Primary sources establish product facts. HarnessBase labels direct testing separately and does not convert community observations into verified results.

Target query cluster: DeepSeek Harness CLI · dsh command · DeepSeek Harness headless