Herdr
给编码 Agent 用的常驻运行时:每个 Agent 独占终端面板,关掉客户端或断 SSH 后继续跑,回来原样接上;单二进制 Rust 实现,另有插件与 socket API 供 Agent 互相调度。
Herdr 快速入门:让一堆编码 Agent 各有自己的终端,并且不会因为你关窗口而死
这是什么?适合谁?
Herdr 官方的一句话是「the runtime your coding agents live on」——给编码 Agent 用的运行时(官网、README)。它不是又一个新的编码 Agent,而是给 Claude Code、Codex、Cursor、OpenCode 这些已有 Agent 提供「常驻终端 + 多机 + 状态可见」的外壳。
官方列出的能力面(依据 README):
- 断开不停工:关掉客户端或 SSH 掉线后,终端继续在后台服务器里跑;服务器或机器重启后会恢复保存的布局,并可以续接受支持的 Agent 会话——但 README 明确写了「原先进程不会存活」。
- 多台机器一个窗口:本地工作与会话保存在 SSH 机器上的工作并排管理,Agent 列表合并显示,各自独立重连。
- 不用猜哪个卡住了:每个面板标成 working / blocked / idle,Agent 停下来等你回答时它会明说。
- Agent 原生:Agent 通过 CLI 与 socket API 反过来驱动 Herdr——自己开面板、互相发提示、等到另一个 Agent 真的卡住再继续。
- 不改造你已有的 Agent:它不包装、不替换 Claude Code / Codex / Cursor / OpenCode / Grok 等,只接管它们的终端。
- 键鼠双通道:tmux 风格的前缀键 + 鼠标点击、拖拽、分屏。
- 插件:扩展面板与工作流,配官方市场。
- 单个 Rust 二进制,没有 Electron,跑在你本来就在用的终端里。
适合谁:同时开两三个编码 Agent、并且经常在「等它跑」和「切换项目」之间来回的人;需要在多台机器(本机 + 远端开发机)之间轮流接续同一批 Agent 的人;想让 Agent 之间互相调度(一个实现、一个复核)的团队。
不适合谁:只用一个 Agent、很少中断的单任务场景(直接用 Agent 自带的终端就够);完全不想碰终端的用户;把「进程杀不死的持久任务」当需求的场景——README 说得很清楚,机器重启后进程本身不会存活,能恢复的是布局与会话状态。
核验日期:2026-10-29。功能与命令依据官方 README、官网与文档站快速入门页,本文未在本站环境安装运行。
准备工作
- 一个终端环境(macOS / Linux / Windows 都有官方安装方式)。
- 已经在用的编码 Agent(Claude Code、Codex、Cursor、OpenCode、Grok 等),Herdr 负责给它们终端,不负责给它们账号。
- 项目目录:Herdr 在你启动它的目录里工作,官方建议每个活跃项目一个 workspace,这样侧边栏里的 Agent 状态才读得懂。
- 远端机器(可选):已配置好 SSH 的机器,可以保存进 Herdr 统一管理。
- 预算:软件 Apache-2.0 免费;费用来自你用的 Agent 与模型(各家订阅/API 另计)。
安装与启用
macOS / Linux
curl -fsSL https://herdr.dev/install.sh | sh
也可以走包管理器:brew install herdr(Homebrew)或 mise use -g herdr;不想执行远程脚本的可以直接下发行包。
Windows
powershell -ExecutionPolicy Bypass -c "irm https://herdr.dev/install.ps1 | iex"
官方另有「受终端防护策略限制的 Windows」专门文档(windows-beta),企业环境先看那一页再装。
启动
cd /path/to/project
herdr
Herdr 会启动或接上你的默认后台会话——官方文档强调「你不需要自己管 socket」。ctrl+b q 脱离,重新执行 herdr 接回。
装好后的第一次自检:开一个面板跑 echo ok、再 ctrl+b q 脱离、herdr 接回,确认输出还在。这一步过了,说明后台服务器与会话恢复链路是通的。
首个任务:把两个 Agent 分别放进独立面板,跑同一个仓库的两件事
- 在项目目录执行
herdr启动。 - 新建一个 workspace(会话里没有 workspace 时它会自动建一个),给它起个能看懂的名字,比如
api-refactor。 - 拆两个面板:一个跑 Claude Code 做实现,一个跑 Codex 做复核。
- 给两个 Agent 的指令都写清「只改哪些文件 + 怎么验收」:
任务:把 src/api/client.ts 的超时逻辑抽成可配置项。
边界:只改 src/api/client.ts 与 src/config.ts;
验收:npm test -- client 通过,且 git diff --stat 只显示这两个文件。
完成后把 diff 摘要和测试输出贴出来,不要只说「已完成」。
- 让复核面板的 Agent 去读实现面板的产出并给出结论。
成功判据:
- 侧边栏能同时看到两个 Agent 的状态(working / blocked / idle),哪个在等你一目了然;
ctrl+b q脱离再herdr接回,两个面板的输出都还在;- 两个 Agent 的改动没有互相踩到对方声明的范围之外。
初级用法
- 一个项目一个 workspace:官方快速入门直接建议这么做。多个项目混在一个 workspace 里,Agent 状态的语义会立刻糊掉。
- 用鼠标也完全够用:点击聚焦面板/标签/workspace,拖动分隔线改大小,右键出上下文菜单(含分屏、新建标签),拖选即复制——官方文档明确说不需要 Ctrl+C。
- 前缀键习惯可迁移:tmux 用户的前缀键肌肉记忆基本能沿用,键盘操作与鼠标操作是并列的一等公民,不必二选一。
- Ctrl+点击开链接:在面板里按住 Ctrl 点 http(s) 链接会用运行客户端的机器上的默认浏览器打开(受
ui.mouse_capture配置影响,官方文档给了两种模式的差异)。
高级玩法
1. 让 Agent 自己开面板、互相调度
Herdr 提供 CLI 与 socket API,Agent 可以自己 spawn 面板、给别的 Agent 发提示、并且等到另一个 Agent 真的处于 blocked 状态再继续。这比「让模型自己决定下一步」可靠得多:判据是进程状态,不是模型的自我陈述。想给自己的 Agent 加支持,官方有 add-herdr-support 与 agent-skill 两页。
2. 本机 + 远端统一管理
把常用开发机存进 Herdr 后,本地项目与远端项目的 Agent 出现在同一个列表里,各自独立重连。对「笔记本上写、开发机上跑」的团队,这一步省掉的是反复 ssh + tmux attach 的心智负担。
3. 用插件把重复的编排固化
官方有插件市场(官网计数显示 1,789 个社区插件,采集日期 2026-10-29,属官方自述数字)。实践建议:先把一个编排流程手动跑顺,再把稳定部分写成插件;把没跑通的流程封装成插件,只是把 bug 变成资产。
4. 用 blocked 状态做「人工闸门」
把「需要人决策」的步骤显式停住(Agent 停下来等输入),Herdr 会把这个面板标成 blocked。于是你可以放心去开会:回来只看哪些面板是 blocked 的,而不是逐个翻日志。
五个小技巧
- 一开始就按项目分 workspace,别等面板堆到十几个再整理。
ctrl+b q脱离是安全的,但别把它当「进程永不死」:机器重启后恢复的是布局与会话状态,原进程不会存活。- Agent 的指令里写「验收方式」,比写「步骤」更能防它乱改——Herdr 只接管终端,管不了 Agent 的判断。
- 多个 Agent 同时改一个仓库时,给每个 Agent 划定互不重叠的文件范围,冲突成本远高于并行收益。
- 远端机器上的 Herdr 与本地 Herdr 是两套后台服务,排查「接不上」时先确认连的是哪一台。
常见踩坑
以下为基于官方 README、官网与文档站快速入门页整理的排障思路,不是本站亲历记录。
坑 1:以为重启后 Agent 还在原来那一步继续跑
症状:机器重启后布局回来了,但 Agent 的会话像是重新开始。原因:README 明确写「原先进程不会存活」,能恢复的是保存的布局与受支持会话的续接。解决:把恢复当成「断点续跑」而非「无缝继续」,关键步骤仍要落盘(commit、日志、任务清单)。
坑 2:所有项目挤在一个 workspace
症状:侧边栏一片混乱,看不出哪个 Agent 在等我。原因:workspace 是项目级容器,混用会让状态语义失效。解决:按项目拆 workspace,名字用项目名而不是「workspace1」。
坑 3:Windows 上装不上或被终端策略拦下
症状:安装脚本执行被拦。原因:受终端防护策略限制的 Windows 需要走专门路径。解决:按官方 Windows 支持文档 操作;仍不通就下发行包手动安装。
坑 4:Ctrl+点击打不开链接
症状:面板里的链接点了没反应。原因:链接打开方式受 ui.mouse_capture 影响——true(默认)时由 Herdr 处理 Ctrl+点击,false 时交给外层终端;Windows Terminal 还可能自己抢先识别 URL。解决:按文档在两种模式里选一种,并在 Windows Terminal 里考虑关掉 experimental.detectURLs。
坑 5:把 Herdr 当成「Agent 的人事管理」
症状:以为装上它,多个 Agent 就会自动分工不打架。原因:Herdr 提供的是终端、状态与调度原语,分工与验收标准仍要你写。解决:编排规则(谁负责什么、怎么交接、如何验收)必须在指令或插件里显式定义。
坑 6:远端连不上就反复重装
症状:SSH 机器上的项目连不上,重装本机无解。原因:本机与远端各有一个 Herdr 后台服务,问题多半在 SSH 通道或对端服务。解决:先在远端本机 herdr 跑通,再回到多机管理页排查连接配置。
常见问题 FAQ
Q1:它和 tmux / zellij 有什么不同?
A:tmux 是通用终端复用器,你自己负责在里面跑什么、怎么跟踪状态;Herdr 把「编码 Agent」当成一等对象——面板有 working/blocked/idle 状态、有 Agent 列表、有给 Agent 用的 socket API,插件生态也围绕 Agent 工作流。要通用复用选 tmux,要「管一堆 Agent」选 Herdr。
Q2:它会不会替换掉我的 Claude Code / Codex?
A:不会。README 明说它不包装、不替换,只接管这些 Agent 的终端。你的订阅、模型、命令都不变,变的是「终端归谁管」。
Q3:关掉笔记本合盖之后任务还在跑吗?
A:客户端断开不会停止工作,任务在后台服务器里继续;但机器休眠、进程被杀、磁盘写满仍会中断。它不是云端托管作业。
Q4:要花钱吗?
A:Herdr 本身 Apache-2.0 开源免费;花钱的是你跑在上面的 Agent 与模型。官网另有企业/合作联系方式,本文不推测商业条款。
Q5:支持哪些 Agent?
A:README 列举 Claude Code、Codex、Cursor、OpenCode、Grok 等,并说明「runs what you already run」;官网计数页显示可探测 22 种 Agent CLI(官方自述,采集日期 2026-10-29)。你自己的 Agent 想被支持,可以按官方文档加适配。
Q6:和 boring-computers 这类「多 Agent 工作台」是什么关系?
A:boring-computers 更偏「把整台机器当 Agent 工作区」,Herdr 更聚焦「终端与面板这一层」——它甚至可以被别的编排层调用。两者可以叠用,也可以只选一个;本站另有 boring-computers 条目可对照。
成本、权限与安全边界
许可:Apache-2.0(LICENSE)。软件免费,费用来自你运行的 Agent 与模型。
权限面:Herdr 的后台服务器持有你的终端会话——这意味着能连上这个后台的人,就等于拿到你终端里所有 Agent 的操作权。远端与多机场景尤其要注意:SSH 凭据、Herdr socket 的访问控制、以及共享机器上的其他用户,都要当成真实风险处理。
数据面:Herdr 自己是终端与调度层,不代你调用模型;但面板里的 Agent 会把内容送进各自的模型服务,数据边界仍由那些 Agent 决定。
进程面:README 说得很直白——断开客户端不停工,但机器重启后原进程不存活。不要把「长期无人值守的关键任务」唯一寄托在面板里。
进阶学习建议
- 概念线:读官方 Concepts 与 Session state,把 workspace / pane / session / 后台服务器的关系搞清楚,这是后面所有配置的地基。
- 自动化线:读 Socket API 与 CLI reference,做一个「Agent A 等 Agent B 进入 blocked 再继续」的最小脚本——这是它相对普通终端复用器最有价值的能力。
- 多机线:按 Connecting machines 把一台远端开发机接进来,实测一次断线重连。
- 插件线:从 Plugins 与市场挑一个现成插件改,比从零写更快看清扩展点。
免责声明
本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。 文中安装命令、示例任务与配置项均为文档说明,未在本站环境执行;不同终端、平台与 Agent 组合下的实际表现需要自行验证。
参考链接
📊 评分与标签
核验口径:已按现行口径通过,待按新证据契约复核
评分说明
总分 8.2/10 · P_优选
核验日期:2026-10-29。评价对象是 herdrdev 维护的开源编码 Agent 运行时(单个 Rust 二进制,含后台会话服务、CLI 与 socket API),评价依据是官方仓库 README、官网、官方文档站(最新文档版本 0.9.5)与 GitHub 公开仓库状态。 评分依据可追溯至公开来源,每项分数都有明确理由与数据支撑;这是文档与公开数据层面的编辑判断,不是性能基准,也不是我们在多机生产环境里做过的实测。
🤖 Agent 能力:1.6/2.0
它自己不是编码 Agent,能力体现在「给 Agent 提供的运行时原语」上:README 列出的核心是断开不停工(后台服务器保留终端)、面板状态机(working / blocked / idle)、Agent 通过 CLI 与 socket API 反向驱动 Herdr(自己开面板、互相发提示、等另一个 Agent 真的进入 blocked 再继续)、多机统一列表与独立重连。 扣分在两处:其一,README 明确「服务或机器重启后原进程不会存活」,能恢复的是布局与受支持会话,所以它给不了「进程级持久」;其二,能力上限取决于被托管的 Agent,Herdr 本身不提供任务规划或质量门禁。
- 竞品对比 1:Claude Code(本站 9.2)是 Agent 本体,能自己读写代码、跑命令、做多步任务;Herdr 不与之竞争,它管理 Claude Code 的终端。
- 竞品对比 2:OpenCode(本站 9.4)同样是编码 Agent 本体;把多个这样的 Agent 放进 Herdr 的价值在编排与状态可见,而不是替它们写代码。
🖐️ 易用性:1.4/1.5
上手路径非常短:curl -fsSL https://herdr.dev/install.sh | sh,或 brew install herdr / mise use -g herdr,Windows 有对应 PowerShell 脚本与专门的受策略限制环境文档;启动就是在项目目录执行 herdr,ctrl+b q 脱离、再执行 herdr 接回。官方还强调「你不需要自己管 socket」,并把鼠标操作做成一等公民(点击、拖拽分屏、右键菜单、拖选即复制)。
扣分只在一点:概念仍是终端的(workspace / tab / pane / session / 后台服务器),从没用过 tmux 一类工具的人需要先读一次 Concepts 才能把状态语义和侧边栏对上。
- 竞品对比 1:tmux 需要自己写配置、自己记住窗口编号与键位,还要另外解决「哪个 pane 卡住了」;Herdr 默认就带面板状态与鼠标操作。
- 竞品对比 2:boring-computers(本站 8.5)思路上更「整机当 Agent 工作区」,配置面更重;Herdr 的定位是终端这一层,装完即用。
🔌 生态集成:1.6/2.0
集成面在两条线上做得实:一是「接你已有的 Agent」——README 明确列举 Claude Code、Codex、Cursor、OpenCode、Grok 等,并声明不包装不替换、只接管终端,还提供 add-herdr-support 给自研 Agent 加适配;二是「给 Agent 用的接口」——CLI 与 Socket API 让 Agent 能互相调度,加上插件市场(官网计数 1,789 个社区插件,采集日期 2026-10-29,属官方自述)。 扣分在生态仍是早期的垂直生态:插件与适配都围绕它自己,跨工具的深度集成(比如把它嵌进 CI、或与 IDE 双向联动)文档里没有成熟路径。
- 竞品对比 1:Claude Code 背后是 Anthropic 的工具生态与 IDE 集成面,广度更大;Herdr 的集成价值在「横向管多个 Agent」而不是纵向打通一条产品线。
- 竞品对比 2:Zoetrope(本站 8.1)把 Agent 会话可视化成流程图,属于「观察层」;Herdr 属于「承载层」,两者可以叠加,但不能互相替代。
👥 社区支持:1.4/1.5
GitHub API 在核验日返回 46,335 stars、3,712 forks、386 个未关闭 issue,仓库创建于 2026-03-27,最近推送 2026-10-28T19:45:39Z,Apache-2.0,主语言 Rust。七个月从零到四万六千星、并且每天仍有推送,说明增长与维护强度都在高位;官方有 Discord、X 账号与完整文档站(含多语言与版本化文档)。
扣分在时间:项目太新,第三方教程、踩坑合集与中文社区沉淀都还薄,冷门问题更多要靠官方文档与 Discord。
- 竞品对比 1:Claude Code 有厂商官方支持与海量第三方教程,遇到问题几乎一定搜得到答案。
- 竞品对比 2:tmux 有十几年的问答沉淀,但没有「Agent 语义」这层;Herdr 用文档质量补历史短板,目前还补不平。
💡 创新程度:1.2/1.5
把「终端复用」和「Agent 状态机」合成一个产品是它最实质的创新:面板不只是终端,而是带 working / blocked / idle 状态的 Agent 槽位;再叠上「Agent 能用 socket API 反过来调度别的 Agent,并且等到对方真的 blocked 才继续」——判据是进程状态而不是模型自述,这一点比多数「多 Agent 框架」的做法更硬。 扣分在底层技术并不新:终端复用、后台会话、SSH 复用都是成熟技术,创新点在产品组合与状态语义。
- 竞品对比 1:tmux 与 zellij 是通用复用器,没有 Agent 状态与 Agent 间调度原语。
- 竞品对比 2:boring-computers 同样在「Agent 工作环境」上创新,但方向是整机/容器化的隔离环境;Herdr 的方向是终端与面板层的编排,两者创新点不重叠。
🔒 稳定性:1.0/1.5
有利面:单个 Rust 二进制、无 Electron,依赖面小;有版本化发行(文档站当前最新 0.9.5)与 Homebrew/发行包多渠道;后台服务器模型让它对「客户端断线」天然免疫。 扣分在三处:其一,项目只有七个月,0.9.x 仍是快速演进期,配置项与 CLI 面还可能变;其二,386 个未关闭 issue 说明问题量仍在上升期;其三,README 写明机器重启后原进程不存活,长跑任务的稳定性仍需你自己在外部兜底。
- 竞品对比 1:tmux 经过十几年的生产检验,行为稳定可预期;Herdr 的能力更强,但成熟度不在同一档。
- 竞品对比 2:Codex CLI(本站 9.2)由厂商维护并有明确发布节奏;Herdr 的稳定性更多取决于社区与作者个人节奏。
可观测社区指标
采集日期:2026-10-29。GitHub API 返回 46,335 stars、3,712 forks、386 个未关闭 issue,pushed_at 为 2026-10-28T19:45:39Z,仓库创建于 2026-03-27,主语言 Rust,Apache-2.0,未归档。
官网同页展示的 1,644,092 次安装、1,789 个社区插件、可探测 22 种 Agent CLI 均为官方自述数字(同页星标计数 44,627,与 API 读数不同步,以 API 为准)。
这些指标只代表公开仓库与官网展示,不等于活跃用户、企业采用或任务成功率。
标签说明
- 开源免费:代码以 Apache-2.0 发布;费用来自你运行的 Agent 与模型。
- 编码Agent:官方定位是「编码 Agent 的运行时」,README 列举 Claude Code、Codex、Cursor、OpenCode、Grok 等被托管的编码 Agent。
- 终端复用:核心形态是终端复用器的 Agent 化版本——workspace / tab / pane、前缀键、鼠标操作与后台会话(官方 Concepts 与键盘文档)。
- 多机协作:README 的「several machines, one window」与 Connecting machines 说明本地与远端 SSH 机器可在同一窗口管理。
局限与声明
未安装 Herdr,未执行安装脚本,未在 macOS / Linux / Windows 上验证,也未实测多机重连与会话恢复。 README 与文档中的能力(断线继续、布局恢复、socket API 调度、插件体系)均为官方说明,本站未独立复现。 官网的安装量、插件数、可探测 Agent 数与星标计数为官方自述,本文只作转述,不作为第三方核实结论。 本文基于官方文档和公开资料整理,AI辅助生成,MagicNetWorld 尚未完成独立实测。
来源核实
- 仓库 README:确认定位、能力清单、安装方式、启动与脱离方式、许可与开发说明。
- 官网:确认首页文案、安装命令、安装量/插件数/可探测 Agent 数等官方自述数字。
- 快速入门(官方文档):确认 workspace 概念、鼠标操作、脱离与接回流程。
- Socket API 与 add-herdr-support:确认 Agent 侧接口与适配入口。
- Apache-2.0 许可:确认开源许可。
- GitHub API:stars / forks / 创建时间 / 最近推送 / 未关闭 issue 数 / 主语言。
- Claude Code、OpenCode、boring-computers:仅作同类产品路线与站内评分对照。
同分类推荐
编码Agent 分类下的其他 Agent