Preface¶
DSH extends its capabilities through plugins. After subagent delegation, it is often necessary to inspect tasks, outputs, and invocation processes. When multiple subagents run simultaneously, viewing them one by one is inconvenient. dsh-subagent-max addresses this use case: it provides a multi-panel, real-time view of subagents on the web side, along with a subagent_with_model tool that supports overriding the model or provider per invocation.
What This Is¶
dsh-subagent-max is maintained by aaravarr and is licensed under MIT. It is a DSH plugin that includes the subagent_with_model tool and a web UI for real-time, multi-panel viewing of subagent output.
Core Features¶
Below is a breakdown by capability:
- Per-invocation model/provider override: Explicitly select a model or provider in a single subagent delegation.
- Intelligent provider selection: When no provider is specified, automatically choose one based on rules.
- Multi-panel real-time view: Open multiple subagent panels simultaneously to view output in real time.
- Block-level rendering: Display subagent output in a block-based layout.
- Subagents tab: Provides an entry point for the subagent list.
- Drag-out opening: Supports dragging subagent cards out to open panels.
- Notifications: Alerts when a subagent starts or receives a message.
- i18n: Supports Chinese/English.
Installation and Enablement¶
First, install the plugin for the web profile:
dsh plugin --profile web add @aaravarr/dsh-subagent-max
After installation, you can use the subagent tool and the viewing interface provided by the plugin in the DSH web interface.
Typical Usage¶
You can ask the model to launch a subagent with a specified model:
Start a subagent with
deepseek-v4-flashto review this repo’s test coverage.
The parameters for subagent_with_model are as follows:
| Parameter | Type | Required | Description |
|---|---|---|---|
model |
string | Yes | The model ID used by the subagent, e.g., deepseek-v4-flash. |
provider |
string | No | Provider routing. Omitted when using automatic selection. |
description |
string | Yes | A brief task label. |
prompt |
string | Yes | The task prompt. |
run_in_background |
bool | No | Optional parameter. |
When provider is omitted, the parent provider is used first if it can serve the requested model; otherwise, the first provider carrying that model is used; if none exist, the parent provider is inherited, and the subagent may fail with UNKNOWN_MODEL.
Applicable Scenarios and Notes¶
Suitable for DSH web use cases where you need to watch multiple subagents simultaneously or select models/providers per delegation.
Notes:
- The client UI is only available on the web platform.
- Model display comes from the session’s
request/header; some subagents may lack this. - Last activity time is tracked on the client and cached in
localStorage; the first open after a fresh load may fall back to the session’supdatedAt. - The plugin runs with the permissions of the current
dshprocess. It is recommended to review the source code and license before installation; this plugin is licensed under MIT.
Links¶
GitHub repository: https://github.com/aaravarr/dsh-subagent-max
For browsing from the community directory, please refer to the DSH community directory page you use. The community directory is an independent site and has no official affiliation with DeepSeek / High-Flyer.
