Mombrane/dsh-subagent-monitor

Live subagent run monitor for the Web UI: a sidebar footer trigger plus a fixed top-right card panel showing each subagent of the current session in real time (running/elapsed, terminal outcomes, tree indent), with one-click jump into the child conversation and a return button, refresh-surviving and mobile-hidden by default.

dsh-subagent-monitor adds a Subagents entry to the DSH Web sidebar and a movable, resizable card panel pinned to the top-right showing the live run status of subagents spawned directly by the current session. An overall dashboard carries three donut charts (the main session's current context-window occupancy plus cache-hit rates for the main session and the aggregated subagents) and a running/done/failed status bar chart scaled to the largest count; each card shows status, elapsed time and an input/output/cache/context usage line. The panel collapses in two independent directions: a two-stage vertical collapse, and a horizontal fold into a 120px strip that keeps the context and main-session rings at full size restacked vertically with the right edge anchored. Position and size are both remembered.

UI Enhancements ★ 22 updated 2026-08-24
View on GitHub ↗

Install

dsh plugin --profile web add @leetoners/dsh-ui-subagent-monitor

npm package @leetoners/dsh-ui-subagent-monitor 0.5.0 (registry re-verified 2026-09-30; repository field points back at github.com/Mombrane/dsh-subagent-monitor, MIT). The README also documents the git form dsh plugin --profile <your-profile> add github:Mombrane/dsh-subagent-monitor; restart dsh web afterwards. The package is both a DSH client plugin (dsh.client) and a composition bundle (dsh.bundle + cordis.patch.yml), shipped prebuilt in lib/.

Compatibility

DSH Web profile (README badge: DSH 0.1.x). The README states compatibility was measured, not inferred: on disposable profiles on 2026-09-14, one per release, by adding the bundle, booting dsh web, confirming the panel renders and GET /api/subagent-monitor/snapshot returns 200, then confirming remove drops the route back to 404. Releases not listed are marked unknown.

Details

Recent updates

The README publishes a measured compatibility matrix (disposable profiles, 2026-09-14, snapshot-endpoint 200 check per release), documents the two independent collapse axes with the anchored-strip behaviour, and states the package ships prebuilt rather than building on install.

FAQ

How do I install dsh-subagent-monitor?
Run dsh plugin --profile web add @leetoners/dsh-ui-subagent-monitor, or the git form dsh plugin --profile <your-profile> add github:Mombrane/dsh-subagent-monitor, then restart dsh web.
Which subagents does it show?
Per the README it shows only subagents spawned directly by the current session; opening a subagent session moves the panel down to that session's direct children, with a one-click back button to the parent.
How is compatibility determined?
The README says marks are measured, not inferred: each listed release was added on a disposable profile on 2026-09-14, booted, and confirmed to render the panel with GET /api/subagent-monitor/snapshot returning 200; unlisted releases are unknown.

Alternatives

aaravarr/dsh-subagent-max · zhangzujian/dsh-adaptive-subagent-report · AbnerAI/dsh-monitor

More plugins in UI Enhancements

Browse more in UI Enhancements

Guides for UI Enhancements plugins