herdr：在一个終端里管理多個 AI 編程 Agent

Mon, 06 Jul 2026 07:34:53 +0800

herdr 是一個面向 AI 编程 Agent 的終端 multiplexer。你可以把它理解成“為 Agent 重新設計的 tmux”：每個 Agent 都執行在真实終端裡，herdr 负责把它们放进 workspace、tab 和 pane，并在侧边栏顯示每個 Agent 目前是 blocked、working、done 還是 idle。

如果你现在同時用 Claude Code、Codex、OpenCode、Devin、Cursor Agent 或其他 CLI Agent，很容易遇到一個問題：每個工具都能跑，但多开以後没人帮你管理状态。哪個在等你输入，哪個還在跑，哪個已经完成，哪個終端断开後還能不能回来，都要靠自己记。herdr 解决的就是這個“多 Agent 終端调度”問題。

herdr 是什么

官方一句话描述是：agent multiplexer that lives in your terminal。

它不是 Electron GUI，也不是把終端重新画进一個應用窗口。herdr 是一個本機 Rust 二进制程序，執行在你已有的終端裡。每個 Agent 都拿到自己的真实終端，所以全屏 TUI、交互式 prompt、鼠标、Unicode 和複杂输出更容易正常工作。

它的幾個关键词是：

single Rust binary；
real terminal per agent；
workspace、tab、pane；
agent state detection；
detach / reattach；
SSH remote；
local socket API；
no account、no telemetry。

從倉庫資料看，專案主语言是 Rust，預設分支是 master，官网是 herdr.dev，最新 release 為 v0.7.1。

它解决什么問題

传统 tmux 很强，但它不知道 pane 裡跑的是不是 AI Agent，也不知道這個 Agent 是否在等待使用者确認。GUI Agent 管理器能顯示状态，但通常是独立應用、平台限制更多，且不一定保留原生終端体验。

herdr 的定位刚好在中间：

像 tmux 一样，session 可以保持，断开後可以回来；
像 GUI 管理器一样，可以看到 Agent 状态；
仍然住在終端裡，可以通過 SSH 在服务器上跑；
不强制你换掉 Claude Code、Codex 或其他 Agent；
還提供 socket API，讓 Agent 反過来控制 herdr。

這對多 Agent 工作流很关键。比如你可以讓 Codex 查一個 bug，讓 Claude Code 改一個模块，讓 OpenCode 跑另一個分支，然後在同一個 herdr 侧边栏裡看谁卡住、谁结束、谁還在工作。

主要功能

每個 Agent 一個真实終端

herdr 不模拟終端，而是给每個 Agent 一個真实 pane。全屏 TUI、交互式输入、多行 paste、颜色和宽字符顯示這类细节，理论上比“GUI 裡嵌一個終端视图”更稳。

Agent 状态一眼看清

侧边栏會把 Agent 汇总成幾個状态：

blocked；
working；
done；
idle。

官方 README 说检测預設通過 process-name matching 加 terminal-output heuristics 完成，不需要每個 Agent 都写 hook。部分官方 integration 可以提供更原生的 session restore 和 semantic state。

workspace、tab、pane

你可以按倉庫、專案或任務拆 workspace，再用 tab 和 pane 放不同 Agent。herdr 支持鼠标点击、拖拽和切分 pane，也支持键盘快捷键。

detach 後任務继續跑

herdr 有背景 server。你 detach 之後，pane 和 Agent 继續存在；重新執行 herdr 就能 reattach。它也適合放到服务器上，通過 SSH 回来继續看任務。

remote 模式

普通 ssh + tmux 在某些现代終端能力上會吃亏，比如图片 paste 或更複杂的終端能力传递。herdr 提供 --remote，讓本機終端作為远端 herdr server 的 client。

示例：

1
2

herdr --remote workbox
herdr --remote ssh://you@yourserver:2222

如果你经常在遠端開發机上跑 Agent，這是 herdr 很实用的一块。

Socket API 和可脚本化

herdr 提供 local Unix socket API。Agent 可以通過它创建 workspace、切分 pane、启动 helper、读取输出、订阅状态变化，而不是一直轮询屏幕。

官方還提供可複用 skill：

`1`	`npx skills add ogulcancelik/herdr --skill herdr -g`

這意味着 herdr 不只是“人用的 multiplexer”，也可以成為 Agent 工作流的一部分。

安裝方法

官方推荐安裝脚本：

`1`	`curl -fsSL https://herdr.dev/install.sh \| sh`

Windows preview beta：

`1`	`powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 \| iex"`

也可以用這些方式：

1
2
3

brew install herdr
mise use -g herdr
nix run github:ogulcancelik/herdr

或者直接從 GitHub releases 下载 Linux/macOS 稳定二进制。根据 v0.7.1 release，官方提供了這些资产：

herdr-linux-aarch64；
herdr-linux-x86_64；
herdr-macos-aarch64；
herdr-macos-x86_64。

如果是通過安裝脚本安裝，可以用：

`1`	`herdr update`

Homebrew、mise、Nix 安裝的版本则用對应包管理器更新。

快速上手

启动 herdr：

herdr

它會启动或连接背景 server，并打开一個 workspace。之後你可以在 pane 裡启动 Agent，例如：

1
2
3

codex
claude
opencode

herdr 預設使用 ctrl+b 作為 prefix。也就是先按 ctrl+b，松开，再按动作键。

常用快捷键：

操作	快捷键
新建 workspace	`ctrl+b` 然後 `shift+n`
垂直或水平切分 pane	`ctrl+b` 然後 `v` 或 `minus`
新建 tab	`ctrl+b` 然後 `c`
切换 workspace	`ctrl+b` 然後 `w`
detach	`ctrl+b` 然後 `q`
查看所有快捷键	`ctrl+b` 然後 `?`

detach 之後 Agent 仍會继續執行。重新执行：

herdr

就可以回到原来的 session。

支持哪些 Agent

README 裡列出的支持范围很广，包括：

pi；
Claude Code；
Codex；
Droid；
Amp；
OpenCode；
Grok CLI；
Hermes Agent；
Kilo Code CLI；
Devin CLI；
Cursor Agent；
Antigravity CLI；
Kimi Code CLI；
GitHub Copilot CLI；
Qoder CLI；
Kiro CLI。

另外，Gemini CLI 和 Cline 被标注為 detected but not fully tested。

這不代表其他 Agent 不能跑。只要它是終端程序，herdr 仍然可以把它作為普通 pane 管理；只是没有专门状态识别或原生 session integration 時，blocked / working / done 的准确度可能會下降。

官方 integration 可以這样安裝：

`1`	`herdr integration install <agent>`

README 提到可用 integration 包括 pi、omp、claude、codex、copilot、devin、droid、kimi、opencode、kilo、hermes、qodercli 和 cursor。

和 tmux、GUI 管理器怎么选

如果你只是長期在服务器上跑 shell，tmux 仍然非常稳。它成熟、轻、生态足够多。

如果你只用一個 Agent，也不需要状态总览，herdr 的价值不一定明显。

herdr 更適合這些情况：

一次开多個 Agent；
想知道谁在等输入、谁已经完成；
希望 detach 後任務继續跑；
要通過 SSH 從另一台机器或手机回来查看；
不想用 GUI wrapper；
想讓 Agent 通過 socket API 编排終端环境。

GUI Agent 管理器適合偏桌面化、偏产品化的工作流。herdr 则更像给終端党和遠端開發环境准备的工具。

從原始碼建置

開發建置命令很直接：

git clone https://github.com/ogulcancelik/herdr
cd herdr
cargo build --release
./target/release/herdr

测试和檢查：

1
2

just test
just check

專案是 Rust 為主，也包含网站和文档相关程式碼。普通使用者不一定需要原始碼建置，直接用安裝脚本或 release binary 會更省事。

v0.7.1 有哪些值得注意的更新

最新 release v0.7.1 發布于 2026-06-24。更新比较多，挑幾個和日常使用相关的点：

增加 [update].version_check 和 [update].manifest_check，可以分别关闭背景版本檢查和远端 Agent detection manifest 檢查；
增加 HERDR_AGENT=<agent>，用于 Linux 上被 wrapper、VM、Bubblewrap 或 fence 隐藏時提示真实 Agent；
增加 ui.pane_borders 和 ui.pane_gaps，可設定 pane 分隔線和间距；
Agents panel 移除 workspace/all filter，預設顯示所有 Agent；
使用者 keybinding 覆盖預設绑定時，不再讓两個动作挂在同一個键上；
修複 Windows Terminal 多行 paste、ConPTY、CJK 分支名截断、遠端握手延迟等問題。

這些更新说明 herdr 還在快速迭代，尤其 Windows 和多 Agent lifecycle 相关的边角正在补齐。

授權要注意

herdr 是双授權：

開源：GNU Affero General Public License v3.0 or later，也就是 AGPL-3.0-or-later；
商业：不能满足 AGPL 要求的组织，可以联系作者获取商业授權。

如果只是個人使用或内部试用，通常不用想太多。但如果公司要把 herdr 集成进自己的产品、服务或托管平台，AGPL 就需要認真看，尤其是網路服务和修改分發相关义务。

使用建議

我會把 herdr 放在“多 Agent 并行工作台”這個位置，而不是把它当普通終端美化工具。

比较自然的使用方式是：

一個 repo 开一個 workspace；
不同任務开不同 pane；
每個 pane 裡跑一個 Agent；
用 sidebar 看状态；
長任務用 detach/reattach 保持；
遠端開發机用 herdr --remote；
等工作流稳定後，再安裝官方 integration 或尝试 socket API。

如果你已经在 tmux 裡多开 Codex、Claude Code、OpenCode，herdr 的吸引力會很直接：它保留了終端裡的自由度，又补上了 Agent 状态這一层。等于少了一点“我刚才那個 Agent 跑到哪裡了”的認知负担，這在一天开十幾個任務的時候很实在。

Herdr on KnightLi的博客