aaravarr/dsh-subagent-max
40Last commit Aug 14, 2026
dsh-subagent-max DSH plugin
This plugin adds a `subagent_with_model` tool that lets you delegate subagent tasks with an explicit model or provider. It also provides a Web UI with floating panels that stream live subagent output, including reasoning, tool calls, and markdown.
How to install the dsh-subagent-max DSH plugin
dsh plugin --profile web add @aaravarr/dsh-subagent-maxCopying does not run this command. Review the repository and version before installing the dsh-subagent-max DSH plugin.
dsh-subagent-max DSH plugin data source
dsh-subagent-max DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-subagent-max DSH plugin can do
- Per-call model/provider override via the `subagent_with_model` tool
- Multi-panel floating viewer with live token-by-token streaming
- Rich block rendering: prompt, reasoning, tool-call cards, markdown
- Subagents tab with card grid grouped by active/inactive status
- Drag-to-pop-out: drag a card to open a floating panel at the drop point
- Notifications for subagent start and message events
- Built-in i18n support (zh/en) switchable via DSH settings
Where the dsh-subagent-max DSH plugin fits
- Review code coverage by delegating a subagent with a specific model
- Monitor multiple subagent tasks simultaneously in real-time
- Debug tool-call flows by inspecting subagent reasoning and output
- Organize complex workflows by delegating subtasks with explicit model choices
- Use the Subagents tab to track active vs. completed subagents
Who the dsh-subagent-max DSH plugin is for
- DSH users who need fine-grained control over subagent models
- Developers debugging multi-agent workflows and wanting live output visibility
dsh-subagent-max DSH plugin limitations
- Model display depends on session request/header and may be absent for some children
- Last-activity time is tracked client-side and cached in localStorage; first open after fresh load may fall back to session's updatedAt
- Client UI is designed for the web platform only
dsh-subagent-max DSH plugin: from the repository README
Quoted from the aaravarr/dsh-subagent-max README, the upstream source of the dsh-subagent-max DSH plugin. Copyright remains with the original authors.
English | [中文](README.zh.md) [](https://www.npmjs.com/package/@aaravarr/dsh-subagent-max) [](LICENSE) > Multi-panel live subagent viewer for [DeepSeek Harness (DSH)](https://github.com/deepseek-ai/DeepSeek-Harness), 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. <img src="docs/subagents-tab.png" alt="Subagents tab" width="720"> **Floating viewer panel** — a draggable panel streaming a subagent's live output: task, reasoning, tool calls, and text. <img src="docs/viewer-panel.png" alt="Floating viewer" width="720"> 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
Read the full READMERepository license: MIT
dsh-subagent-max DSH plugin questions
How do I install the dsh-subagent-max plugin?
Run `dsh plugin --profile web add @aaravarr/dsh-subagent-max` in your DSH environment. This will download and register the plugin. If you prefer manual installation, place the package under `<profile>/node_modules/@aaravarr/dsh-subagent-max/` and add an entry to `cordis.patch.yml`.
Can I use the subagent_with_model tool without the Web UI?
Yes, the plugin has two faces: the host face (server-side tool) and the client face (Web UI). The tool is registered automatically when the plugin is loaded, even if you don't use the Web UI. The client UI is only available when running the DSH web profile.
How do I open a floating panel for a subagent?
In the Subagents tab, you can either click on a card to open its panel, or drag a card onto the canvas to open the panel exactly where you drop it. You can open multiple panels simultaneously and they are draggable and resizable.
What does the backgroundMode config option do?
The `backgroundMode` config accepts two values: `one-shot` (default) runs the subagent in the foreground, while `continuable` returns a durable subagent ID that allows you to reference the subagent later. You can also override this per-call using the `run_in_background` parameter in the tool.
Why is the model name missing for some subagents?
The model display is derived from the session's `request/header`. For some child subagents, this header may not be present, so the model name will be absent. This is a known limitation of the plugin.