Herdr 是 Rust 写的 AI 代理终端多路复用器，10MB 单二进制支持 Claude Code / Codex / Copilot CLI 等 15+ 编码代理同窗运行。侧栏实时显示 blocked/working/done 状态，AGPL-3 协议免费可商用另购。
🎤 引言
2026 年 AI 编码代理的「多工具困局」：
- 主力 Claude Code 跑在大重构任务里——30 分钟起步
- 隔壁 terminal 跑 Codex 写单测
- 第三个 pane 里 Aider 改一行 bug
- 第四个 tmux session 是 Copilot CLI 在做 code review
问题来了：四个 agent 同时跑，你根本不知道哪个卡了、哪个跑完了、哪个在等你点确认。tmux ls 只能看窗口数，看不出 agent 状态。等你反应过来时，Claude Code 已经在 terminal 里干等 20 分钟，白白烧 token。
GitHub 20.8k Stars 的 ogulcancelik/herdr 是这个困局的标准答案——Rust 写的 AI 代理终端多路复用器，单 10MB 二进制，把 Claude Code / Codex / Copilot CLI 等 15+ 代理塞进同一个窗口，侧栏实时显示「blocked / working / done / idle」状态。
发布才 4 个月（2026-03-27 首发），就已经斩获 20.8k Stars / 1.4k Forks，还登上了 Hacker News 首页。AI 编码时代 tmux 的「继承者」，不是没道理。
⭐ 核心功能
1. Agent State Awareness（一等公民）
Herdr 与传统 tmux 的核心差异：把 agent 状态当一等公民。
侧栏持续监听每个 pane 里跑的 agent 进程，识别「idle（空闲）/ working（工作中）/ blocked（等待输入）/ done（完成）」状态，并显示一个状态徽章：
- 绿色徽章 + 圆点 → agent 在等你输入 prompt
- 橙色徽章 + 动画 → agent 正在跑
- 红色徽章 → agent 卡住了 / 报错
- 灰色徽章 → agent 已完成
实测场景：开了 4 个 pane 分别跑 Claude / Codex / Aider / Copilot，从屏幕上一眼扫过去就能看出哪个 agent 在等你——这在 tmux 里要逐个 Ctrl+B + w 切换才能确认。
2. 15+ AI Agent 内置适配
Herdr 团队主动给主流 AI 编码工具写了「native integration」，列表里至少覆盖：
- Claude Code（Anthropic 官方）
- Codex / Codex CLI（OpenAI 官方）
- GitHub Copilot CLI
- Cursor Agent
- Aider
- Cline
- Continue
- OpenCode
- Windsurf
- Cody
- 等等…
未列入官方列表的工具也能跑（Herdr 本质就是终端多路复用器），只是没有自动状态徽章——会按普通 PTY pane 处理。
3. 完整继承 tmux 哲学
Herdr 不是 tmux 替代品，是「AI 时代的 tmux 继承者」：
- Ctrl+B 前缀：跟 tmux 完全一致，老用户零学习成本
- Workspace / Tab / Pane 三层结构：跟 tmux 一样的层级模型
- Session 持久化：
herdr启动后台服务，关掉终端重连，agent 任务继续跑 - detach / attach：SSH 断开再连回来，状态完整保留
Vim 用户和 tmux 老兵迁移过来完全无缝。
4. Socket API：Agent 间互相调度
Herdr 提供 Unix Domain Socket API，让 agent 之间能互相调度：
# 让 Claude Code 调度一个 Codex pane 来跑单元测试
herdr spawn codex --task "运行 pytest 并修复失败的测试"
# 让 Codex 调度一个 Claude Code pane 来 code review
herdr spawn claude --task "review 这次 PR 的改动"这是「agent swarm / agent orchestration」的雏形——agent 不再是孤立的工具，而是能互相协作的「同事」。
官方还配套了 herdr integration install 命令，给 Claude Code / Codex / Copilot 自动注入「能调度 Herdr」的 Skill：
herdr integration install claude
herdr integration install codex
herdr integration install copilot装完后 Claude Code 就会「意识到 Herdr 存在」，遇到适合并行处理的任务主动 spawn 新 pane。
5. 零依赖单二进制
整套 Herdr 只是一个 10MB 的 Rust 静态二进制：
- 无 Electron、无 PyInstaller、无 Node.js 运行时
curl -fsSL https://herdr.dev/install | sh一行安装- 启动 < 50ms，比 tmux 还快
- 跨平台：Linux / macOS / Windows 全支持
Homebrew / x eget / cargo install 多渠道分发，迁移成本几乎为零。
📥 安装与使用
环境要求
- Linux / macOS / Windows
- 已安装至少一个 AI 编码 CLI（Claude Code / Codex / Aider / Copilot CLI 等）
- 无需 Python / Node.js / 任何运行时
一键安装
# 官方安装脚本
curl -fsSL https://herdr.dev/install | sh
# 或 Homebrew
brew install herdr
# 或 Cargo
cargo install herdr启动
herdr首次启动会创建后台服务进程，并打开一个工作区窗口。
跑第一个 Agent
在 Herdr 工作区里：
# 创建新 pane 并跑 Claude Code
claude code ./project-a
# 新 pane 跑 Codex
codex ./project-b
# 切到 Aider 改一个 bug
aider --file bug.py侧栏自动显示每个 pane 的 agent 状态徽章。
多 Agent 编排（高级）
# 给 Claude Code 安装 Herdr Skill
herdr integration install claude
# 让 Claude Code 在对话中说"帮我跑下测试"
# Claude Code 自动 spawn 一个 Codex pane 跑 pytest官方文档：https://herdr.dev
项目仓库：GitHub - ogulcancelik/herdr
🎯 适用场景
- 多 AI 编码工具重度用户：同时用 Claude Code + Codex + Aider，Herdr 让 terminal 不再爆炸。
- AI Agent 编排探索者：想尝试 Claude ↔ Codex 自动 plan-review 循环，Herdr Socket API 是当下最轻的实现路径。
- tmux 老兵 + AI Agent 新人：已经熟练 tmux，再多一个 AI 时代的视角，迁移成本几乎为零。
- 远程服务器 AI 编码：在云端跑 Claude Code 改远程仓库，Herdr session 持久化让你 SSH 断开再连不丢任务。
- DevOps / SRE：想用 AI agent 自动化运维任务（写脚本 / debug 服务），Herdr 提供 agent 可见性。
不太适合：只用一个 AI 编码工具的轻度用户（直接用工具自带 terminal 就好，没必要套一层）；不用 AI 编码工具的纯传统开发者（直接用 tmux / Zellij / byobu 即可）；企业生产环境对 AGPL 敏感的法务团队（AGPL 协议要求分发衍生作品时公开源码，商用需购买商业 license）。
🔍 对比 / 替代方案
| 工具 | 语言 | Agent 状态感知 | 持久化 | Socket API | 学习曲线 | 协议 |
|---|---|---|---|---|---|---|
| Herdr | Rust | ✅ 内置 | ✅ | ✅ | ⭐⭐（tmux 用户零成本） | AGPL-3 / 商业 |
| tmux | C | ❌ 通用 PTY | ✅ | ⚠️ 第三方扩展 | ⭐⭐ | ISC |
| Zellij | Rust | ❌ 通用 PTY | ✅ | ⚠️ 插件机制 | ⭐⭐⭐ | MIT |
| byobu | Shell | ❌ | ✅ | ❌ | ⭐ | GPL |
| Warp | Rust | ⚠️ 半（无 agent 语义） | ⚠️ | ❌ | ⭐ | 商业 |
| devops-agent-tools | Python | ⚠️ 半 | ⚠️ | ✅ | ⭐⭐⭐ | MIT |
Herdr 的甜蜜点非常清晰：Agent 状态感知 + tmux 哲学 + Socket API + 零依赖单二进制。tmux / Zellij 是通用终端多路复用器，对 agent 状态一无所知；Warp 是 GUI 优先的现代 terminal，但缺乏 agent 编排；专门的 AI agent 编排工具（LangGraph / CrewAI）太重，不适合 terminal 场景。
横向对比 tmux：Herdr 完全兼容 tmux 快捷键（Ctrl+B 前缀），老用户零迁移成本；如果你本来就是 tmux 重度用户，Herdr 是「不改习惯就解锁 agent 能力」的最佳路径。
诚实缺点：项目年轻（2026-03 发布，4 个月），GitHub 117 open issues 反映还在快速迭代；AGPL-3 协议对想要闭源商业化的团队不友好（必须购买商业 license）；Rust 单二进制虽然快，但 UI 灵活度不及 Tauri / Electron 方案。
⚠️ 注意事项
- AGPL-3 协议需注意：Herdr 默认 AGPL-3，分发衍生作品或 SaaS 服务需公开源码。商业闭源集成务必联系 [email protected] 购买商业 license。
- macOS 用户首次运行需授权：Rust 静态二进制没签名，macOS Gatekeeper 会弹警告，去「系统设置 → 隐私与安全性」点「仍要打开」即可。
- Agent 安装路径：Herdr 依赖 Claude Code / Codex 等已安装并能直接在 shell 调起。确保
which claude、which codex在 PATH 里能找到。 - 状态徽章延迟：默认每 500ms 轮询一次 agent 进程输出识别状态，强信号提示（done / blocked）几乎实时，弱信号（working 的精确边界）有 1-2 秒延迟。
- Socket API 安全：默认监听
~/.herdr/herdr.sock，只接受本机访问。如果开远程访问务必配防火墙 / Tailscale。 - Windows 兼容性：WSL2 下工作最好，原生 Windows terminal 可能遇到 ANSI 转义码渲染问题，临时方案是装 Windows Terminal Preview。
- Session 文件位置：
~/.herdr/存放所有 session 状态、socket 文件、log，备份或迁移实例时整个目录打包即可。 - 多 Server 模式：Herdr 支持同时跑多个后台 server（开发 / 生产环境隔离），但需要手动指定端口和 socket 名，避免冲突。
✅ 总结
Herdr 是 2026 年 AI 编码时代最值得装的 terminal 工具。4 个月 20.8k Stars 的爆发力证明一件事：当 AI agent 成为主流开发工具，传统 tmux 已经不够用了。Herdr 把「agent 状态可见性」作为一等公民，配合 Socket API 实现了 agent 互相调度的雏形，是当下最贴近「AI 开发团队即 terminal」愿景的开源项目。
推荐指数 ⭐⭐⭐⭐⭐（5/5）：Agent 状态感知 + tmux 哲学继承 + Socket API 编排 + 10MB 单二进制 + Rust 极致性能，五件套组合在「AI agent terminal」赛道几乎没有对手。
适合：多 AI 编码工具重度用户、Agent 编排探索者、tmux 老兵、远程服务器 AI 编码、DevOps / SRE 自动化。
不太适合：单一 AI 工具轻度用户、纯传统开发者、对 AGPL 敏感的企业法务。
如果你已经在 terminal 里跑 Claude Code + Codex + Aider，别再开 4 个 SSH 窗口——一行 curl -fsSL https://herdr.dev/install | sh 装上 Herdr，让所有 AI 编码代理在同一个窗口里协同工作。侧栏的状态徽章会让你第一次有「agent 团队」的真实感觉。
官方文档：https://herdr.dev
GitHub：https://github.com/ogulcancelik/herdr