项目2026-11-16 · 智涌AI

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

herdr 项目头图:左侧大字「herdr Agent 终端层」与钩子「多个编程 Agent 常驻后台,谁卡住了一眼看到」,三张数据卡为 51,284 GitHub 星、最新正式版 v0.9.5、Apache-2.0 开源许可;右侧终端显示安装启动 herdr,claude 工作中、codex 卡住等待批准、pi 已完成,以及 agent wait、agent read 命令和 ctrl+b q 断开后 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 各自的配置和用法都不用改。

装之前看这几条

适合谁

适合同时跑多个编程 Agent、经常在远程开发机上干活、或者想让一个 Agent 去调度另一个 Agent 做审查的人。只开一个 Agent、习惯用 IDE 内置聊天面板的,用不太上。已经用熟 tmux 的人可以对比一下:herdr 多出来的是 Agent 状态识别、通知和给 Agent 用的 CLI。手机远程连 Agent 的另一种做法见站内 T3 Code 远程访问教程;多个 Agent 共用一个仓库时,记得配合 git worktree 隔开工作目录。

最后

如果你每天要在三个以上的 Agent 终端之间来回切,先装上 herdr,在一个项目里跑两个 Agent,试一次 ctrl+b q 断开再接回来,看侧边栏的状态准不准。

关注公众号「智涌AI速递」

每天的 AI 快讯、实用教程和 AI项目实测,也会同步发到微信公众号。在微信里搜索「智涌AI速递」就能关注;不用微信的话,可以用 RSS 订阅本站。