Mombrane/dsh-subagent-monitor
91Last commit Aug 15, 2026
dsh-subagent-monitor DSH plugin
This plugin adds a "Sub-agent" entry in the sidebar of DSH Web and displays a persistent card panel in the top-right corner. It shows real-time status for each sub-agent, including running, completed, failed, interrupted, token limit, and rejected. The panel is mobile-friendly and survives page refresh.
How to install the dsh-subagent-monitor DSH plugin
dsh plugin --profile <your-profile> add @leetoners/dsh-ui-subagent-monitorThis source command needs manual review. Copying does not run it.
dsh-subagent-monitor DSH plugin data source
dsh-subagent-monitor DSH plugin snapshot date: Aug 16, 2026
discovered
What the dsh-subagent-monitor DSH plugin can do
- Real-time status display with colored indicators and live stopwatch for running tasks
- Card-based list with each sub-agent as a rounded card, showing task name and status
- Tree indentation for nested sub-agents (grandchild agents)
- One-click return to main session from sub-agent conversation
- Auto-recovery after page refresh or service restart
- Mobile-friendly: collapses on small viewports but can be manually opened
Where the dsh-subagent-monitor DSH plugin fits
- Monitor the progress of multiple sub-agents during a complex DSH session
- Quickly identify failed or interrupted sub-agents and take action
- Review completed sub-agent results with elapsed time
- Navigate between sub-agent conversations and main session easily
- Use on mobile devices to keep track of sub-agent activities
Who the dsh-subagent-monitor DSH plugin is for
- DSH users who frequently spawn sub-agents and need real-time visibility
- Developers debugging or testing sub-agent behavior in DSH
dsh-subagent-monitor DSH plugin limitations
- Only works in the DSH Web interface (not in terminal or other clients)
- Panel polls the snapshot endpoint without authentication, recommended for local/internal network only
- Each root session retains at most 200 entries, older completed entries are evicted
- Requires DSH version 0.1.x
dsh-subagent-monitor DSH plugin: from the repository README
Quoted from the Mombrane/dsh-subagent-monitor README, the upstream source of the dsh-subagent-monitor DSH plugin. Copyright remains with the original authors.
DeepSeek Harness (DSH) Web 扩展插件 · 子代理实时运行监视面板 <br/> <a href="https://github.com/Mombrane/dsh-subagent-monitor/blob/master/LICENSE"><img alt="license" src="https://img.shields.io/badge/license-MIT-green"></a> <img alt="platform" src="https://img.shields.io/badge/platform-Web-8b5cf6"> <img alt="dsh" src="https://img.shields.io/badge/DSH-0.1.x-2563eb"> </p> **中文** | [English](README.en.md) --- ## ✨ 是什么 在 DSH Web 界面侧栏底部加一个「子代理」入口，并在屏幕**右上角**常驻一块卡片式面板，实时展示当前会话派生的每一个子代理的运行状态。 ``` ┌─ 运行中的子代理 ──────────── [收起 ▴] [✕] ┐ │ ┌─────────────────────────────────────┐ │ │ │ 🔵 统计 ui 目录 TS 文件数 [打开对话] │ │ │ │ one-shot · 1a2b3c4d 运行中 · 00:42 │ │ │ └─────────────────────────────────────┘ │ │ ┌─────────────────────────────────────┐ │ │ │ 🟢 演示子代理：统计文件类型 [打开对话] │ │ │ │ spawn · 2b3c4d5e 完成 · 03:12 │ │ │ └─────────────────────────────────────┘ │ │ 运行 1 · 完成 1 · 异常 0 [清空已完成] │ └─────────────────────────────────────────┘ ```  ## 🎯 特性 | 特性 | 说明 | | --- | --- | | 🟢 实时状态 | 运行中（🔵 蓝色呼吸 + 秒表）、完成、失败、已打断、令牌上限、已拒绝 | | 🃏 卡片化列表 | 每个子代理一张圆角卡片；「打开对话」在右侧，状态与耗时在第二行 | | 🌲 树形缩进 | 孙代子代理卡片向右缩进 | | 🔙 一键返回 | 进入子代理会话后，面板出现「← 主会话」按钮 | | 🔄 刷新
Read the full READMERepository license: MIT
dsh-subagent-monitor DSH plugin questions
Will the panel disappear after refreshing the page?
No, the panel is a persistent component that automatically restores after page refresh or service restart. It uses a combination of persistent state and polling to resume its display.
What is the difference between 'Completed' and 'Ended' status?
The green 'Completed' status means the panel observed the sub-agent successfully finish in real time. The white 'Ended' status indicates a historical record from before a service restart, where the final outcome (success or failure) is unknown.
How many sub-agents can the panel display?
Each root session can retain up to 200 entries. When the limit is exceeded, the oldest ended entries are evicted to make room for new ones.
Is the panel secure?
The panel polls the /api/subagent-monitor/snapshot route, which is designed for loopback address without authentication. It is recommended for local or internal network use only, not for public exposure.
How do I install this plugin?
You can install it via npm: run 'dsh plugin --profile <your-profile> add @leetoners/dsh-ui-subagent-monitor'. Alternatively, use GitHub direct install: 'dsh plugin --profile <your-profile> add github:Mombrane/dsh-subagent-monitor'. After installation, restart 'dsh web' to activate the panel.