什么是 Herdr

Herdr 是一个运行在终端里的 AI 编码 agent 多路复用器（agent multiplexer）。官方用一句话概括它的定位：Herdr 之于编码 agent，就像 [[tmux]] 之于终端。它运行在你的 agent 运行的地方——本地机器、服务器，或任何可以 ssh 进去的环境，让你在一个终端里同时观察和操作多个正在工作的 agent。

随着 [[Claude Code]]、[[Codex]]、[[OpenCode]] 这类终端原生的编码 agent 流行起来，开发者常常会同时跑好几个 agent 处理不同的任务或仓库。问题随之而来：哪个 agent 在干活，哪个卡住了在等你确认，哪个已经做完了？Herdr 解决的就是这个“一群 agent 的可见性与编排”问题，把整个“herd”（畜群，这里指你养的一群 agent）收拢进一个终端。

Herdr 使用 [[Rust]] 编写，是开源项目，在 GitHub 上托管于 ogulcancelik/herdr。它强调 mouse-first（鼠标优先）和 agent-aware（感知 agent 状态），并且不依赖 Electron，是真正的终端原生工具。

核心功能

Herdr 的核心价值在于把多个 agent 的状态可视化并集中控制。

• 状态一览：在侧边栏中以 working（工作中）、blocked（被阻塞，等待确认）、done（已完成）、idle（空闲）等状态实时显示每个 agent 的进展，一眼就能看出谁需要你介入。
• 点击即达：可以直接点击任意 pane、agent 或 workspace 跳转过去，处理被阻塞的 agent，再切回其他任务。
• 会话持久化：类似 tmux，detach（断开）后再 reattach（重连），pane 与 agent 都不会死掉。官方的卖点是“合上笔记本，什么都不会消失”。
• 远程与 SSH：可以在远程服务器上运行 Herdr，通过 SSH bridge 连接，本地终端就能管理跑在服务器上的一群 agent。
• 原生 agent 恢复：支持 restart restore、pane history replay 以及 live handoff（在替换 server 进程时，pane 的 PTY 仍然存活，长任务继续响应）。
• 通知机制：agent 状态翻转（比如从 working 变为 blocked）时可以触发通知，提醒你去处理。

核心概念

Herdr 用一套层级化的概念来组织工作空间：

• Session：顶层命名空间，整个会话环境。
• Workspace：项目级别的工作区，侧边栏会把该项目下所有 agent 的状态汇总（roll up）显示。
• Tab：workspace 内的标签页，例如 agents、logs、server 等。
• Pane：最小的终端单元，每个 pane 承载一个 PTY，可以是一个 agent，也可以是普通的 shell 命令（如 bun run dev、tail -f、python3 -m http.server）。

这套模型对用过 tmux 或 [[Zellij]] 的人来说很熟悉，但 Herdr 在其上叠加了对 agent 状态的语义理解。

安装与使用

Herdr 在 Linux 和 macOS 上提供稳定版，Windows 目前是 preview beta（仅供预览）。

脚本安装（Linux/macOS）：

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

此外还支持 Homebrew 与 [[Nix]] flake 安装。Windows 预览版通过 PowerShell：

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

默认键位前缀沿用 tmux 的习惯 ctrl+b，例如 prefix+v / prefix+c 用于切分 pane，prefix+q 等。对完全没接触过多路复用器的用户，Herdr 主打鼠标优先：可以点击 pane、拖拽边框、通过右键菜单切分和切换，不需要先背快捷键。

配置文件位于 ~/.config/herdr/config.toml，可以自定义键位、主题、侧边栏行为、通知与滚动缓冲等。

键盘快捷键

Herdr 有三种输入模式，快捷键的含义取决于当前所在模式：

• Terminal mode：按键直接发送到当前聚焦的 Pane（默认模式）
• Prefix mode：按下 ctrl+b 后触发，执行单次 Herdr 命令
• Navigate mode：持久化导航界面，用于在 Pane 间移动

默认前缀键为 ctrl+b，可在 ~/.config/herdr/config.toml 中自定义。

Pane 管理

Tab 管理

Workspace 与会话

无前缀直接绑定

不需要按前缀键，直接触发：

复制模式（Copy Mode）

进入复制模式（prefix+[）后的操作：

其他

与 Agent 的集成

Herdr 一个有意思的设计是它本身对 agent 友好。它附带一个 skill 文件 SKILL.md，安装时会写入 agent 的指令目录（例如 [[Claude Code]] 的 ~/.claude/skills/herdr/SKILL.md，Codex 的 ~/.codex/AGENTS.md），这样 agent 在 pane 内部就能原生地理解并执行 Herdr 命令。

官方甚至建议让 agent 自己来完成 onboarding，把下面这段提示丢给正在运行的 agent 即可：

Help me understand and set up Herdr. Read https://herdr.dev/agent-guide.md first, then walk me through it step by step.

Herdr 还提供 CLI 与本地 socket API，允许脚本、工具和 agent 通过编程方式控制 Herdr，实现自动化编排。

插件与生态

Herdr 支持本地可执行的工作流插件（plugin），通过 manifest 定义 action 和 event hook 来扩展功能。社区可以通过 GitHub 分享插件并打 tag，待官方 marketplace 上线后被收录。主题方面内置了对 catppuccin、tokyo night 等流行配色的支持。

对比分析

Herdr 官方提供了与同类工具的对比，核心差异在于“终端原生”与“感知 agent 状态”两点：

• 对比 [[tmux]] / [[Zellij]]：传统多路复用器只管理终端 PTY 与会话持久化，并不理解里面跑的是什么 agent，也不会汇总 working / blocked / done 状态。Herdr 在持久化之外叠加了 agent 语义。
• 对比 [[cmux]]、[[Solo]]、[[Conductor]]、[[Emdash]] 等 agent 编排工具：这些工具不少是 GUI 或 Dashboard 形态，或基于 worktree 调度。Herdr 的差异是完全活在终端里，支持远程 SSH，且以 blocked 状态的可见性为核心。
• 对比 [[Warp]]：Warp 是 UX 打磨精良的现代终端，但它是面向人的终端体验；Herdr 专注于多 agent 的并行可见与编排。

简单说，如果你需要的是“在终端里同时盯住一群编码 agent，谁卡住了立刻去救”，Herdr 的定位最贴合；如果只是单纯需要终端分屏与会话保持，tmux/Zellij 已经够用。