dsh-subagent-max
English | 中文
Multi-panel live subagent viewer for DeepSeek Harness (DSH), plus a subagent_with_model tool for per-call model/provider override.
Screenshots
Subagents tab — a card grid grouped into active / inactive and sorted by last activity.
Subagents tab
Floating viewer panel — a draggable panel streaming a subagent's live output: task, reasoning, tool calls, and text.
Floating viewer
A two-face DSH plugin:
- Host face (
lib/index.js) — a Cordis plugin that registers the subagent_with_model tool, a thin wrapper over ctx.subagents that forwards model / provider into the child's agentOptions.
- Client face (
lib/client.js) — a Web UI that renders every subagent as a draggable, resizable floating panel with live token-by-token output, plus a Subagents tab with a card grid.
Features
- Per-call model / provider override — delegate to a subagent and pick its model explicitly.
- Smart provider selection — when no provider is given, prefer the parent's provider if it serves the requested model, otherwise auto-find a provider that carries it.
- Multi-panel live viewer — open several subagent panels at once; each streams output in real time.
- Rich block rendering — prompt block, reasoning (think) blocks, tool-call cards with input/output, streaming shimmer, markdown.
- Subagents tab — card grid grouped into active / inactive and sorted by last activity; shows model, tokens, steps, context % and relative update time.
- Drag to pop out — drag a card onto the canvas to open its panel exactly where you drop it (with a ghost preview).
- Notifications — side-top toasts when a subagent starts or receives a message.
- i18n — zh / en, switchable from DSH settings.
Install
dsh plugin --profile web add @aaravarr/dsh-subagent-max
or, manually, place the package under <profile>/node_modules/@aaravarr/dsh-subagent-max/ and add the entry to cordis.patch.yml (see Config).
Config
- insert:
- id: dsh-subagent-max
name: '@aaravarr/dsh-subagent-max'
config:
subagentProvider: spawn # spawn | fork | acp
toolName: subagent_with_model
backgroundMode: continuable # one-shot | continuable
maxDepth: 3
| Field | Type | Default | Description |
|---|
subagentProvider | string | spawn | Subagent transport provider. |
toolName | string | subagent_with_model | Model-facing tool name; must be unique among loaded tools. |
backgroundMode | string | one-shot | continuable returns a durable subagent id; one-shot runs foreground. |
maxDepth | number | 3 | Absolute delegation-depth cap for children (0 forbids further delegation). |
Usage
Ask the model to delegate with an explicit model:
Start a subagent with deepseek-v4-flash to review this repo's test coverage.
Tool parameters:
| Arg | Type | Required | Notes |
|---|
model | string | yes | Child model id (e.g. deepseek-v4-pro, deepseek-v4-flash, k3-256k). |
provider | string | no | LLM provider route. Omitted -> auto-selected: the parent's own provider is preferred when it can serve the requested model; otherwise the first provider carrying that model is used; if none does, the parent's provider is inherited (the child may then fail with UNKNOWN_MODEL). |
description | string | yes | Short (3-5 word) task label. |
prompt | string | yes | Complete, self-contained task. |
run_in_background | bool | no | Background routing; default follows backgroundMode. |
Known Limitations
- Model display is derived from the session's
request/header; it can be absent for some children.
- Last-activity time is tracked client-side and cached in
localStorage; the first open after a fresh load may fall back to the session's updatedAt.
- Client UI targets the web platform only.
Development
pnpm install
node --check lib/index.js lib/client.js
License
MIT
