PandaColour/dsh-cmd-starter
30Last commit Aug 14, 2026
dsh-cmd-starter DSH plugin
dsh-cmd-starter is a DSH plugin that extends the official headless profile with a scriptable CLI. It adds flags like --resume, --continue, --name, --append-prompt, and --output-format json, making DeepSeek Harness controllable via subprocess similar to Claude CLI. It is designed to support Python-driven agent pipelines like panda-pipline.
How to install the dsh-cmd-starter DSH plugin
dsh plugin --profile headless add github:PandaColour/dsh-cmd-starterCopying does not run this command. Review the repository and version before installing the dsh-cmd-starter DSH plugin.
dsh-cmd-starter DSH plugin data source
dsh-cmd-starter DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-cmd-starter DSH plugin can do
- Resume a session by ID or name alias with --resume
- Continue the last session with -c/--continue
- Persist session aliases with --name, resolved across processes
- Output single-line JSON with sessionId, finalResponse, and finishReason
- Override model parameters (--provider, --model, --max-tokens, --effort) per run
- Temporarily append system prompt with --append-prompt without persisting
Where the dsh-cmd-starter DSH plugin fits
- Scripting DSH in Python via subprocess.Popen with structured JSON output
- Integrating DeepSeek Harness into CI/CD pipelines or automated workflows
- Resuming long-running conversations across multiple terminal sessions
- Naming sessions for easier recall in complex multi-task orchestrations
- A/B testing different model configurations without modifying config files
Who the dsh-cmd-starter DSH plugin is for
- Developers who want to drive DeepSeek Harness programmatically from scripts
- Users familiar with Claude CLI who want a similar command-line experience for DSH
dsh-cmd-starter DSH plugin limitations
- Requires a global installation of `dsh` (`npm i -g @deepseek-ai/dsh@next`) and Node.js ^22.19 or >=24
- First install may fail due to pnpm's allowBuilds restriction; manual ws config needed
- Only works with the headless profile; not compatible with other profiles out of the box
- --append-prompt is ephemeral per process invocation and does not affect session history
dsh-cmd-starter DSH plugin: from the repository README
Quoted from the PandaColour/dsh-cmd-starter README, the upstream source of the dsh-cmd-starter DSH plugin. Copyright remains with the original authors.
Claude-Code 风格的 DeepSeek Harness 无头调度 bundle。它在官方 `@deepseek-ai/dsh-headless` profile 之上，把一次性任务入口升级成可脚本化的 CLI： - `--append-prompt <text>`：本次运行临时追加系统提示词（可重复；不落盘、不进会话历史） - `--resume <session-id>`：恢复已有会话（支持 id 或 `--name` 别名） - `-c, --continue`：续最近的会话 - `--name <name>`：给会话起持久化别名，之后 `--resume <name>` 恢复 - `--output-format json`：stdout 输出单行 JSON，含 `sessionId` - `--provider / --model / --max-tokens / --effort`：覆盖本次运行的模型参数 ## 为什么做这个 这个插件是为了支持 [panda-pipline](https://github.com/PandaColour/panda-pipline) 而开发的。`panda-pipline` 是一个用 Python 直接驱动 Claude / Codex / Cursor 这类编码 agent，把它们编排成流水线干活的框架。 `dsh-cmd-starter` 的角色，是让 **DeepSeek Harness** 也能被同一套 Python 流水线驱动——通过补齐 Claude-Code 风格的 `--resume` / `--continue` / `--name` / `--append-prompt` / `--output-format json` 调度参数，使 `dsh` 在 Python 眼里和 `claude` / `codex` / `cursor` 一样，是一个「可以用 `subprocess.Popen` 启动、带结构化输出、能按会话恢复」的可编排单元。 ## 安装 要求：Node `^22.19 || >=24`，已全局安装 `dsh`（`npm i -g @deepseek-ai/dsh@next`）。 ```sh dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter ``` > 首次 `add` 若因 pnpm 的 `allowBuilds` 拦截，按提示在 > `~/.dsh/profiles/headless/pnpm-workspace.yaml` 里补 `allowBuilds` 键后重跑。 ## 用法 ```sh # 一次性任务（等价官方 headless） dsh --profil
Read the full READMEThe repository declares no license. Check with the authors before using it.
dsh-cmd-starter DSH plugin questions
How do I install dsh-cmd-starter?
First ensure you have Node.js ^22.19 or >=24 and dsh installed globally (`npm i -g @deepseek-ai/dsh@next`). Then run `dsh plugin --profile headless add github:PandaColour/dsh-cmd-starter`. If the first add fails due to pnpm's allowBuilds restriction, follow the instructions to add the allowBuilds key in `~/.dsh/profiles/headless/pnpm-workspace.yaml` and retry.
Can I use dsh-cmd-starter without the dsh base tool?
No, dsh-cmd-starter is a plugin that extends the official @deepseek-ai/dsh-headless profile. You must have dsh (the DeepSeek Harness CLI) installed globally and the headless profile available. The plugin adds commands on top of that profile; it does not work standalone.
How do I resume a session by name?
Use `--name <alias>` when starting a session to give it a persistent alias. Later, use `--resume <alias>` to resume that session. The alias is stored in `$DSH_HOME/cmd-starter/aliases.json` and is resolved across processes. If you pass a value that is not an alias, it will be treated as a session ID directly.
What does the --output-format json return?
The JSON output includes fields: `sessionId` (camelCase), `name` (only if --name was used), `finalResponse`, `finishReason` (one of: completed, max-tokens, blocked, aborted, error), and `errorCode` (only on error). The output is a single JSON line printed to stdout, making it easy to parse in scripts.
Is --append-prompt persistent across runs?
No, --append-prompt is temporary. It injects the prompt via the agent's systemPrompt.section() and disappears when the process exits. It does not write to session logs. Only --resume or -c will continue the conversation history from previous runs.