subagent/
August 14, 2026 · View on GitHub
English | 中文
This family lets an agent delegate work to child agents. Multiple named providers may coexist in one context.
| Package | Role | ctx key |
|---|---|---|
subagent/ | Defines provider registration, delegation, and continuation | ctx.subagents |
subagent-inprocess/ | Provides the shared in-process run driver | — |
subagent-spawn-in-process/ | Starts a fresh in-process child | registers on ctx.subagents |
subagent-fork-in-process/ | Starts an in-process child from the parent's completed history | registers on ctx.subagents |
subagent-acp/ | Starts an out-of-process child over ACP | registers on ctx.subagents |
subagent-codex/ | Starts a real Codex app-server child | registers on ctx.subagents |
subagent-claude-code/ | Starts a real Claude Code child through the official Claude Agent SDK | registers on ctx.subagents |
subagent-dsh-sdk/ | Starts an out-of-process Harness child through the TypeScript SDK | registers on ctx.subagents |
tool-subagent/ | Exposes delegation to the model | registers on ctx.tools |
tool-subagent-control/ | Exposes child messaging and listing to the model | registers on ctx.tools |
tool-subagent-report/ | Provides the child-to-parent report channel | registers in child scopes |
The Codex and Claude Code packages are independent optional Profile Bundles. Install either or both with dsh plugin --profile <name> add @deepseek-ai/dsh-subagent-codex @deepseek-ai/dsh-subagent-claude-code, then restart that Profile; each package registers only its dormant Host provider. To grant a tool, copy a complete Agent Preset, remove disabled from each matching tool row, and start a new Session. Removing one package withdraws only that provider and its private runtime closure on the next Profile start.
See the decisions for the capability family, continuable children, and control tools.
The subsystem reference — start requests, results, live runs, the provider contract, continuable background children — is docs/subsystems/subagent.md; design rationale in the subagent capability seam, continuable background subagents, and merged subagent control service Agent Notes.