Herdr：一个终端统治所有AI代理

Herdr 是一个终端内运行的多路复用器，让用户在一个终端中管理、监控和持久化运行多个AI编码代理，支持远程SSH连接和手机访问。

核心问题：AI代理管理的碎片化

随着AI编码助手（如Claude Code、OpenCode、Codex等）的普及，开发者面临一个新问题：

• 桌面应用型代理管理器（如Claude桌面应用）只能运行在本地机器上，无法远程访问
• 传统终端多路复用器（如tmux、Zellij）虽然支持持久化会话和SSH，但完全不懂“代理”是什么——它们只管理终端窗口，无法感知代理的状态（阻塞中、工作中、已完成）
• 工作流编排工具（如worktree orchestrators）虽然能编排任务，但通常需要复杂的配置和独立控制面板

Herdr 的定位是填补这个空白：一个运行在终端内的、代理感知的多路复用器。

核心特性

1. 真正的终端体验，而非应用

Herdr 不是一个Electron应用，没有GUI界面，没有账号系统，没有遥测。它只是一个二进制文件，运行在真正的终端中。你可以：

• 在任何有终端的机器上运行（Linux/macOS稳定版，Windows预览版）
• 通过SSH连接远程服务器
• 在手机SSH客户端中使用（响应式设计，窄屏自动切换为触控友好的选择菜单）

安装方式极其简单：

bash
curl -fsSL https://herdr.dev/install.sh | sh

Windows用户（预览版）：

powershell
irm https://herdr.dev/install.ps1 | iex

此外还支持Homebrew和Nix flake安装。

2. 代理状态可视化

Herdr 的侧边栏会实时显示所有代理的状态，一目了然：

• working（工作中）—— 绿色圆点，代理正在执行任务
• blocked（阻塞中）—— 红色圆点，代理遇到问题等待解决
• done（已完成）—— 灰色圆点，任务完成
• idle（空闲中）—— 空心圆点，代理待命

每个代理运行在独立的真实PTY（伪终端）中，由服务器保持存活——即使你合上笔记本，代理仍在远程服务器上继续工作。

3. 持久化会话与远程附着

Herdr 提供了三种远程使用模式：

模式一：通过SSH运行（类似tmux）
bash
ssh you@server
herdr

在远程服务器上运行Herdr，会话在断开SSH后持续存在，可以从手机SSH客户端重新附着。

模式二：原生远程附着（thin client）
bash
herdr --remote workbox

本地安装客户端，自动在远程主机上安装Herdr，桥接本地剪贴板（包括图片粘贴），保持本地快捷键绑定。

模式三：手机SSH访问
响应式设计，窄屏自动切换为触控优化的切换菜单，保持终端视图的真实性。

4. 代理控制面（API）

Herdr 不仅是一个多路复用器，它还提供了一个CLI和JSON API，让代理本身可以编排Herdr。这意味着：

• 代理可以创建新的面板、切换工作区
• 代理可以查询其他代理的状态
• 代理可以互相协调工作

技术细节：从源码看实现

通过Herdr的入口文件 src/main.rs 可以了解其架构：

1. 参数解析 —— session::configure_from_args 处理会话配置，以及SSH桥接的远程参数
2. 子命令分发 —— server、client、update 三个子命令各司其职，执行完毕后提前返回
3. 会话模式 —— auto_detect_launch() 自动连接运行中的服务器，或生成一个新的服务器进程

状态更新优化

Herdr 的侧边栏在代理状态快速切换时会出现闪烁问题。开发者的调试过程展示了其技术深度：

"侧边栏在每个PTY数据块到达时都会重新计算汇总，所以当代理在短时间内连续切换两次状态时，圆点会在同一帧内重绘两次。"

解决方案：

• src/app/state.rs —— 缓冲每个tick内的状态事件
• src/ui/sidebar.rs —— 每帧只重绘一次汇总

实时会话示例

一个典型的Herdr会话看起来像：

~/Projects/herdr · master ❯ the sidebar flickers when an agent flips state fast
● Found it. The rollup recomputes on every PTY chunk, so a double state flip repaints the dot mid-frame.
● Plan:
· src/app/state.rs — buffer state events per tick
· src/ui/sidebar.rs — repaint rollups once per frame
❯ go, and add a regression test
⠋ Working… ( 13m 36s · esc to interrupt)

可以看到，开发者直接在Herdr终端中与Claude Code代理交互，代理发现bug、制定修复计划、执行修复，整个过程都在一个终端内完成。

另一个例子是数据库迁移：

~/Projects/llm-proxy · master ❯ prep the request-log migration and run it
● Wrote migrations/0007_request_log.sql — request_log table, retention index on created_at, daily rollup view.
● Local checks pass: sqlx prepare is clean, backfill dry-run touches 41,209 rows. Ready to apply.

代理编写SQL迁移文件，本地检查通过，然后询问开发者是否执行。

与传统方案对比

能力	tmux / Zellij	代理桌面应用	工作流编排工具	Herdr
运行在终端内	✓	—	—	✓
持久化PTY会话	✓	有限	内嵌	✓
远程SSH附着	✓	有限	远程项目	✓
语义化代理状态	—	部分	工作区状态	✓
直接代理附着	—	—	—	✓
代理可编排	脚本化	部分	工作流所有	✓

实际应用场景

• 多代理并行开发：同时运行Claude Code、OpenCode、Codex等多个代理，各自处理不同任务，在Herdr中统一监控
• 远程开发：在云服务器或Mac Mini上运行代理，从任何地方附着，甚至手机
• CI/CD集成：代理可以运行测试、监控日志，Herdr保持会话持续
• 团队协作："one terminal for the whole herd"，整个团队可以在同一个会话中查看代理状态

社区反响

Herdr 在Hacker News上获得192分和95条评论，热度不俗。多个技术YouTuber制作了独立评测：

• Jilles（6分37秒）：最快的实用入门——安装、工作区、代理状态、持久化、代理技能工作流
• DevOps Toolbox（16分40秒）："这个tmux重写实际上很聪明"——深入实操，鼠标优先的面板、远程使用、代理支持和CLI
• Better Stack（7分10秒）："这是终极代理多路复用器吗？"——清晰的tmux对比，代理感知、远程附着、为何Herdr留在终端内

适用人群

Herdr 被来自以下公司的工程师使用（个人使用，非公司背书）：JetBrains、Docker、Vercel、Kimi、Sentry、Google、NVIDIA、AWS、ByteDance、Tencent、Alibaba、Salesforce、IBM、Atlassian、Whop、Automattic 等。

总结

Herdr 不是又一个终端模拟器（它依赖你已有的终端，如Ghostty、Kitty、iTerm、Alacritty），也不是一个网页仪表盘（没有Web视图、没有账号、没有托管控制平面）。它是tmux的进化版——保留了终端内运行和持久化会话的核心优势，增加了代理感知、状态可视化和可编程API。

对于同时使用多个AI编码代理的开发者来说，Herdr提供了一个统一、高效、可远程访问的管理界面，让"一个终端统治所有代理"成为现实。

---

原文链接：https://herdr.dev/