shaokeyibb/dsh-plugin-product-subagents

Role-based Codex / Claude Code / ACP subagent providers for the DeepSeek Harness — continuable children, durab

dsh-plugin-product-subagents turns external agent CLIs (Codex, Claude Code, ACP agents) into durable, continuable subagents for DeepSeek Harness. Features: continuable children (one-shot sync or async with send_message/list_agents/interrupt_agent, attach synchronously with product_wait), session continuity where a child's remote product session survives idle disposal and process restarts (claude/codex resume by id, ACP reconnects), declarative roles (general, code-review, explore, debug) with delegation defaults ON and per-role product permissions, a two-layer permission model (relay model is always a read-only pipe; permissionMode readonly/default/full maps to each product's own CLI flags), a permission ceiling so a child can never spawn a descendant with more permission than it has, pluggable ACP providers (Cursor, CodeBuddy, Gemini via config.providers, no code needed), idle disposal with configurable timeouts and a concurrency cap, and cross-platform process launching.

Coding & Development ★ 18 updated 2026-09-10 ✅ runtime-tested
View on GitHub ↗

Install

dsh plugin --profile web add dsh-plugin-product-subagents

dsh plugin --profile web add dsh-plugin-product-subagents installs the package and wires the host-plane row automatically — the plugin ships a cordis.patch.yml declared via dsh.bundle in its package.json, so no manual cordis.patch.yml editing is needed. Restart the harness afterwards so the plugin loads. Manual install via pnpm (not npm) inside the profile directory is also documented, plus a one-line agent-install path.

Compatibility

DeepSeek Harness deployment (web profile); at least one product CLI on PATH and authenticated: claude, codex, or an ACP CLI (opencode, agent, cbc, ...). Node >= 18. Cross-platform (Windows .cmd shims; CI runs macOS/Ubuntu/Windows).

Details

Recent updates

The current README documents the six-model tool surface (product_delegate, product_roles, product_submit, subagent_progress, product_wait, product_agents), the role/permission model with permission ceiling, custom ACP providers, and the config keys (idleTimeoutMs, maxConcurrentChildren, rolesDir, registryPath).

FAQ

Does install need manual cordis.patch.yml editing?
No — the package ships a cordis.patch.yml declared via dsh.bundle, so dsh plugin add registers it as a profile layer automatically; just restart the harness.
Can children delegate further?
Only within a permission ceiling: readonly < default < full, and a child can never spawn a descendant with a higher mode.
Which CLIs are supported?
Built-ins are claude-code, codex, and acp; any ACP-capable CLI (Cursor, CodeBuddy, Gemini, opencode) can be added via config.providers with no code.

Alternatives

cofy-x/axern · openma-ai/deepseek-harness-acp · anweat/dsh-web-search-pro

More plugins in Coding & Development

Browse more in Coding & Development

Guides for Coding & Development plugins