herdr 是什么:让多个编程 Agent 在后台常驻的终端层

同时开三四个编程 Agent,最费神的是来回切终端:哪个还在跑,哪个停在权限确认框等你点,哪个早就做完了。合上笔记本或者 SSH 断线,跑了一半的会话也跟着没了。herdr 是一个用 Rust 写的终端工作区管理器,专门管这件事:Agent 跑在它托管的终端里,客户端关了也不停,侧边栏标出每个 Agent 是工作中、卡住还是空闲。这篇按官方 README 和文档,讲它解决什么、怎么装、怎么让 Agent 之间互相调度,以及几处要留神的地方。
它是什么
herdr 把终端分成工作区、标签页、窗格三层。工作区对应一个项目,标签页是一种布局,窗格就是一个真实终端。它不包装也不替换你的 Agent,只托管 Agent 所在的终端,所以原来怎么敲 claude、codex,进了 herdr 还是怎么敲。
| 仓库 | github.com/herdrdev/herdr |
|---|---|
| 维护者 | herdrdev 组织,主要提交者 ogulcancelik |
| 许可证 | Apache-2.0 |
| 热度 | GitHub 51,284 星、4,146 fork(GitHub API,2026-11-16 北京时间) |
| 语言 / 平台 | Rust 单一二进制,无 Electron;支持 macOS、Linux、Windows |
| 最新正式版 | v0.9.5(2026-10-15 00:07 北京时间) |
解决什么问题
多 Agent 并行时常见的三个麻烦,和 herdr 的对应做法:
| 麻烦 | herdr 的做法 |
|---|---|
| 关掉终端或 SSH 断线,会话没了 | 后台服务器持有所有窗格,ctrl+b q 断开,再敲 herdr 接回来 |
| 不知道哪个 Agent 在等你 | 按 Agent 画在屏幕上的内容判断状态,汇总到标签页和工作区,后台 Agent 做完或需要输入时弹通知 |
| 本机和远程机器分开管 | 保存 SSH 机器后,本地和远程的 Agent 出现在同一个列表里,各自独立重连 |
状态分五种:blocked(需要输入、批准或决定)、working(正在跑)、done(做完了你还没看)、idle(做完且看过)、unknown(判断不了)。
怎么用
1. 安装并启动。官方给了脚本、Homebrew、mise 三种装法:
curl -fsSL https://herdr.dev/install.sh | sh
# 或
brew install herdr
cd ~/code/my-project
herdr
第一次启动会自动建一个工作区。在窗格里照常启动 Agent,herdr 会自己识别:
claude
# 或 codex、pi、opencode 等
2. 常用按键。前缀键默认 ctrl+b,和 tmux 一样,鼠标点击、拖拽分屏也都能用:
| 操作 | 按键 |
|---|---|
| 向右 / 向下分屏 | prefix+v / prefix+minus |
| 新标签页 | prefix+c |
| 工作区导航 | prefix+w |
| 断开客户端 | prefix+q |
| 查看全部按键 | prefix+? |
要真正结束会话、停掉所有窗格,用 herdr server stop。
3. 装集成,服务器重启后能接上原会话。不装集成也能看到状态;装了以后 herdr 知道每个 Agent 用的是哪个会话,服务器重启时能恢复同一段对话:
herdr integration install claude
herdr integration install codex
herdr integration status
4. 让 Agent 调度 Agent。herdr 带一个 Skill,装上后,跑在 herdr 窗格里的 Agent 可以用 CLI 控制会话:
npx skills add herdrdev/herdr --skill herdr -g
Skill 里给的典型流程是:在旁边开一个不抢焦点的窗格,启动一个 Codex 当审查员,让它看当前 diff,等它回复:
herdr pane split --current --direction right --cwd "$PWD" --no-focus
herdr agent start reviewer --kind codex --pane <返回的窗格 ID>
herdr agent prompt reviewer "Review the current diff and report only actionable findings." --wait --timeout 120000
herdr agent read reviewer --source recent-unwrapped --lines 120
Skill 开头有一条硬规则:环境变量 HERDR_ENV=1 不存在时,Agent 必须停下并说明自己不在 herdr 窗格里,防止外部的 Agent 去控制不属于它的会话。
5. 接远程机器。先确认 ssh workbox 能登录,然后:
herdr machine add workbox
herdr machine status
交互式添加时,远端没装 herdr 会先问你再安装。每台机器有自己的 herdr 服务器和进程,一台断线不影响其他机器。
herdr 只托管终端,Claude Code、Codex 各自的配置和用法都不用改。
装之前看这几条
- 服务器重启不等于进程还在。断开再连接,进程一直活着;服务器或机器重启后,herdr 只恢复工作区、标签页、窗格布局和目录,跑着的服务、测试都没了,Agent 对话要靠装了集成的原生恢复才能接上。
- idle 不代表可以替它点「同意」。文档明说,blocked 判定很严格,新版 Agent 换了提示界面时可能先显示成 idle;自动化脚本如果信了错误的 idle 往里打字,可能正好敲进一个审批框。Antigravity 和 Grok 回到输入框就算 idle,即便后台还有子 Agent 在跑。
- 沙箱包装会挡住识别。用沙箱命令包着 Agent 启动时,herdr 看不到真实进程,要给包装命令加
HERDR_AGENT=claude这类提示;在虚拟机或容器里面设置则无效。 - Skill 只在点名时用。Skill 描述写明只在用户明确提到 herdr 时启用,不会因为任务适合并行就自动接管。
- 版本还在 0.x。文档也在频繁更新,命令以
herdr --help和随二进制附带的herdr --skill为准。
适合谁
适合同时跑多个编程 Agent、经常在远程开发机上干活、或者想让一个 Agent 去调度另一个 Agent 做审查的人。只开一个 Agent、习惯用 IDE 内置聊天面板的,用不太上。已经用熟 tmux 的人可以对比一下:herdr 多出来的是 Agent 状态识别、通知和给 Agent 用的 CLI。手机远程连 Agent 的另一种做法见站内 T3 Code 远程访问教程;多个 Agent 共用一个仓库时,记得配合 git worktree 隔开工作目录。
最后
如果你每天要在三个以上的 Agent 终端之间来回切,先装上 herdr,在一个项目里跑两个 Agent,试一次 ctrl+b q 断开再接回来,看侧边栏的状态准不准。