dsh-tui-herdr

dsh-TUI 插件：把 dsh-TUI 的生命周期状态实时上报给 Herdr 多路复用器——在 herdr 侧边栏直接看到 dsh-TUI 是 working / blocked / done，和 Claude Code、Kimi 等官方支持的 agent 同等待遇。

原理

Herdr 对新 agent 的原生检测需要二进制更新，但官方提供了自定义上报 API（herdr pane report-agent），并为每个 pane 注入 HERDR_PANE_ID。本插件在 dsh-TUI 运行于 herdr pane 内时自动激活，通过会话事件上报：

dsh 事件	herdr 状态
turn/start	working
approval/asked	blocked（等待人工审批）
approval/resolved	working
turn/end	done

不在 herdr 内运行（HERDR_PANE_ID 未设置）时插件自动休眠，零开销。上报全部 fire-and-forget，herdr 不可用不会拖垮宿主。

安装

dsh plugin --profile dsh-tui add dsh-tui-herdr

需要 herdr CLI 在 PATH 中。

使用

装好即用。在 herdr pane 里启动 dsh-tui，侧边栏即出现 dsh-tui 的状态行。

• /herdr — 查看 pane id、上报来源与状态映射
• /herdr ping — 发送一条测试上报（state=idle）

只上报顶层会话事件；子代理（subagent）会话不产生上报，与官方 web 端行为一致。

相关

• dsh-TUI · Herdr（自定义上报文档）
• 同系列插件：dsh-tui-webhook（长任务完成推送到飞书/钉钉/企业微信）