troytse/dsh-plugin-subagent-roles
Defines DSH subagent roles as Markdown files - persona, route, tool policy and an optional tool-call budget - and delegates to them through one tool.
Each role is one Markdown file whose YAML frontmatter carries a display name, a routing description, an optional LLM route (provider, model, reasoning effort), a tool policy and an optional tool-call budget; the body is the persona the child receives. The plugin registers a single delegation tool, subagent_role, which resolves the role against the delegating agent's working directory and starts a child through ctx.subagents with that persona, route and tool filter, and it advertises the roles for the current workspace as a compact catalog line in the prompt (rendered empty, at no cost, when no roles exist). A host-plane observer counts the committed tool calls of every child the row started and enforces the budget at the cap, telling both child and parent. Multiple rows can be mounted, each namespacing its catalog and diagnostic tool after the row.
Install
dsh plugin --profile web add dsh-plugin-subagent-rolesCopied verbatim from the README's "from npm" CLI line for CLI profiles. package dsh-plugin-subagent-roles, registry latest 0.5.0, and its repository field resolves back to github.com/troytse/dsh-plugin-subagent-roles. Desktop installs go through the app's Plugins page instead, because the desktop profile is managed by the Electron application.
Compatibility
The README states that 0.5.x supports DSH 0.2.1-rc.1 and newer only, and that 0.2.0 and earlier must stay on 0.4.3 - the jump happened because 0.2.1 removed subagents.start/startContinuable, the request's persona/toolFilter and the client settings service. Node.js 20 or newer is required, together with a DSH deployment that provides @deepseek-ai/dsh-tools.
Details
- Repo: troytse/dsh-plugin-subagent-roles
- Category: Agent Capabilities
- Stars: 1
- Version: 1 star, JavaScript, MIT, created 2026-09-13; install source is npm (dsh-plugin-subagent-roles, latest 0.5.0, registry repository field resolves back to this repo); English README with a README.zh.md translation.
Alternatives
heiheiha798/dsh-plugin-subagent-delete · lynx-gt/dsh-subagent-tools · YYTbit/dsh-plugin-agent-dashboard