Herdr侧边栏状态聚合一眼看出哪个项目在等你决策——新手完整指南【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdrHerdr 是一款专为编码 Agent 打造的终端运行时the runtime your coding agents live on。它作为后台常驻服务运行把 Claude Code、Codex、Cursor、Grok 等 AI 编程助手的终端都收在自己里面。最实用的一点是Herdr 侧边栏会实时聚合每个工作区和 Agent 的运行状态working / blocked / done让你不用逐个窗口翻看就能一眼看出哪个项目在等你决策。如上图所示左侧侧边栏分为上下两个区域上半部分Spaces按工作区聚合显示项目名 Git 分支如herdr / master并带有整体状态点下半部分Agents逐个列出正在运行的 Agent如pi idle、claude working。为什么你需要状态聚合同时跑多个编码 Agent 时最常见的痛苦是不知道谁卡住了。Agent 需要你做选择题、审批命令、或者回答澄清问题时它会安静地停在终端里等你——如果你不切过去看它就一直干等。人肉巡检意味着你要在每个终端窗口之间来回切换既打断思考也浪费时间。Herdr 的解法是把所有窗口的状态投影到侧边栏Agent 一阻塞对应条目立刻变红你甚至不需要看终端内容。四种状态与颜色Blocked、Working、Done、IdleHerdr 通过读取终端缓冲区底部的实时文本、匹配各 Agent 的输出特征来判定状态核心定义在 src/detect/mod.rs状态含义颜色默认圆点样式符号样式blockedAgent 被卡住在等你输入红●×workingAgent 正在干活黄●◐doneAgent 刚完成你还没看过青●✓idle已完成且已看过安静待机绿○○⚪idle普通 Shell 或未识别程序灰··注意done与idle的微妙区别Agent 跑完任务后会标记为done未读你切过去看过一眼之后才变回idle已读。这套逻辑和消息通知的未读小红点完全一致——侧边栏本质上是一个未读中心。状态标签与配色定义在 src/ui/status.rs状态图标支持dots●/○/·和symbols×/◐/✓/○两种风格可在配置中切换。侧边栏不只显示状态还能自定义侧边栏每一行由令牌token拼装而成你可以自由决定每行展示什么。Agent 面板支持的令牌见 src/config/sidebar.rsworkspace/tab/pane定位是哪个工作区、标签页、窗格agentAgent 名称claude、codex、kimi……terminal_titleAgent 自己设置的终端标题branch/git_status工作区面板可显示 Git 分支名和 ahead/behind 计数custom插件可以注入自定义令牌每侧边栏最多 16 行、每行最多 16 个令牌足够覆盖绝大多数布局需求。官方对侧边栏概念的讲解可以看 concepts.mdx。优先级排序谁最急谁在上Agent 面板有两种排序方式src/ui/sidebar.rsgrouped按工作区分组适合想按项目看进度的时候priority按优先级排序blocked的 Agent 自动排到最前面。当你挂着 5 个 Agent 时切到 priority 模式红色阻塞项永远置顶——哪个项目在等你这个问题侧边栏已经替你回答了。此外当有 Agent 转入 blocked 或完成任务时Herdr 会在界面角落弹出 Toast 提醒红色需要关注 / 蓝色已完成配合 assets/sounds/request.mp3 和 assets/sounds/done.mp3 提示音做到视觉 听觉双重触达。状态检测覆盖主流编码 Agent检测规则以清单manifest文件组织每个 Agent 一个文件存放在 src/detect/manifests/ 目录例如claude.toml识别 Claude Code 的提示符与等待输入界面codex.toml识别 Codex 的运行/阻塞特征cursor.toml、opencode.toml、kimi.toml 等目前已支持 Claude、Codex、Cursor、Gemini、Devin、Grok、Kimi、OpenCode、GitHub Copilot、Qwen 等 20 多种 Agent完整名单见 src/detect/mod.rs。合上电脑盖状态照常聚合侧边栏状态聚合的前提是 Agent 始终在运行。Herdr 是后台服务器终端生活在它体内ctrlb q断开detach客户端后Agent 继续工作网络断了、合上笔记本都不影响随时herdr重新接入侧边栏会立刻呈现最新的聚合状态。这正是live updates without killing your terminal processes的设计理念进程不死状态不断聚合视图永远真实。小结侧边栏就是多 Agent 作战的仪表盘场景侧边栏行为Agent 卡在等待输入条目变红blockedpriority 模式置顶 提醒Agent 正在写代码黄色workingAgent 跑完等你验收青色done未读标记验收完毕变为绿色idle已读一句话总结Herdr 侧边栏把谁在工作、谁卡住、谁完成压缩成了一列彩色状态点让你在多项目、多 Agent 并行时用一次扫视完成决策分发。想要深入了解状态模型与会话持久化可继续阅读 session-state.mdx 与 configuration.mdx。【免费下载链接】herdrthe runtime your coding agents live on项目地址: https://gitcode.com/GitHub_Trending/her/herdr创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考