我把多个 AI 编码 agent 收进了 Herdr + Pi
摘要:我把日常用的多个 AI 编码 agent 收进 Herdr 的工作区,再用 Pi 处理编码任务、查看模型和用量。工具本身免费开源,模型/API 调用是否收费取决于接入的服务商。这篇记录我的工作区布局、Pi 配置和 Windows 下的实测经验,也聊聊多个 agent 并行时怎样分工,才不至于互相添乱。
上个月,我把几个 IDE 窗口关了。
现在我主要在一个终端工作区里切项目:Herdr 管工作区和终端会话,Pi 是我常用的编码 agent,底部状态栏则显示当前模型、token 和费用。多个任务同时跑的时候,我不用挨个点开窗口找谁在工作。
这套组合不是什么人人都该照搬的标准答案。它适合经常并行使用命令行 agent、愿意花点时间配置终端的人。下面把我现在的用法摊开讲。
先分清这几样工具各自做什么
| 工具 | 在这套工作流里负责什么 |
|---|---|
| Herdr | 管理工作区、tab 和 pane,并提供 agent 状态视图 |
herdr-core(hc) |
在后台维护终端进程,提供启动、查看、连接和 agent 协作能力 |
| Pi | 在终端里和模型协作、读取项目文件、执行编码任务 |
pi-powerline-footer |
Pi 的扩展状态栏,可按配置显示模型、上下文、token、费用和缓存数据 |
软件本身免费开源,不等于模型调用免费。接入 API 或订阅服务后,费用仍按服务商的规则计算。状态栏展示的是 Pi 和扩展能读取到的用量信息;具体账单以服务商后台为准。

Herdr server 维护终端进程;TUI 将终端组织为 workspace、tab 和 pane。Pi 作为 agent 运行在真实 pane 中,调用外部模型服务商;footer 扩展显示在 Pi 自身的状态栏。
我的 Herdr 布局:一个 tab 放一个项目
我通常把一个项目放在一个 tab 里,每个 tab 先开一个主 pane。需要同时跑测试、review 或另一个 agent 时,再按任务拆 pane。项目多的时候我会开四到六个 tab;这只是我的习惯,不是数量建议,屏幕大小和任务复杂度都会影响布局。
| Tab | 我会放什么 |
|---|---|
| 项目 A | Pi 和当前主力工程 |
| 项目 B | Claude Code 或另一个 CLI agent |
| 知识库 | Pi 和笔记仓库 |
| 小工具 | 临时脚本、测试或短任务 |
这里的层级要分清:workspace 用来收纳一组工作,tab 可以对应项目或任务,pane 是 tab 里的终端区域。实际怎么分,按你自己的项目切换频率来定。
Herdr 默认键位里,Ctrl+B 是前缀键:先按下再松开,然后按后续动作键。Ctrl+B 后按 h/j/k/l 切 pane;按 n/p 切 tab;按 1–9 可以跳到对应 tab。键位可以配置,建议在 Herdr 里按 Ctrl+B 再按 ? 查看当前生效的绑定。
我会尽量给主 pane 留足宽度。agent 输出常有长路径、命令和报错,分成太多窄列后反而不好读。需要并排看结果时再开 pane,用完就收回去。

我的 Herdr 工作区实测:不同项目放在不同 tab,任务需要并行时再拆 pane。
任务离开窗口后还会继续吗
Herdr 的终端会话由后台 core 维护。关闭 Herdr 窗口或外层终端 viewer 后,正在运行的进程通常仍留在 core 里,可以重新连接查看。但这不代表任何情况下都不会停:关闭 pane 或 tab 会结束对应终端;机器关机、进程被杀也会影响任务。远程机器上的任务要继续跑,还需要远端机器和 core 保持运行。
Herdr 和 tmux 都能保活终端会话。区别在于,Herdr 还把 workspace、agent 状态和子 agent 协作流程放进一个工作区。agent 状态不是凭屏幕内容猜的,具体显示效果取决于 agent 或集成能否上报状态。
如果要让 agent 派 helper 做 review,可以通过 hc 启动另一个 agent,再发送任务、等待并读取结果。例如,可以这样启动一个审查 agent:
hc run --bg --name review codex "review my diff"
hc wait review
hc read review --lines 100
这种方式能否把结果自动送回主控 Pi,取决于所用客户端、集成和启动方式;裸命令启动时,通常还要由主控等待并读取结果。
更有意思的用法:把 Herdr 当作 agent 看板
我看社区讨论时,发现值得借鉴的不是“多开几个 tab”,而是把任务调度、实际执行和过程观察分开。
一种常见搭法是:Pi 作为主控 agent,负责拆任务、分派和汇总;Herdr 负责把每个 子 agent 放进独立 pane,让人能看到它们在做什么、随时接管。Reddit 上有用户把 Pi、Herdr 和 Gondolin 组合起来,也有人用一个 Pi 会话启动多个 Herdr 终端,让不同会话并行处理任务。另一个多 agent 工作流项目则把 规划 agent、实现 agent、审查 agent 分开运行,并用 Git worktree 隔离每个任务的文件改动。Pi + Herdr + Gondolin 的用户实践;Herdr Workflow 项目
对我来说,这套组合更像一个可观察的执行台:
- 主控 Pi:读需求、拆成边界清楚的小任务、决定哪些任务可以并行。
- 子 agent:各自在独立 pane 里完成实现、测试或 review。
- Herdr:集中看 子 agent 状态;需要时点进 pane 接管、补充要求或停止任务。
- Git worktree:当多个 子 agent 可能同时改代码时,把它们的文件改动隔开,减少互相覆盖。
Herdr 官方把 Pi 列为支持的 agent,并提供对应集成。状态显示和会话恢复仍要看集成是否安装、版本是否匹配;没有被识别的 agent 也能在 pane 里运行,只是侧栏里未必有完整状态。Herdr agents 文档
一个更稳的任务拆法
拿“给现有项目加一个导出功能”举例,我不会同时让三个 agent 改同一组文件。我会按这个顺序来:
- 主控 Pi 先读项目结构,写出修改范围、验收条件和不能动的接口。
- 一个 子 agent 实现功能;另一个 子 agent 只读代码,列出测试方案或风险点。
- 实现完成后,子 agent 在自己的 worktree 里跑测试并汇报改了哪些文件、测试结果和未解决问题。
- 主控 Pi 检查 diff,决定是否合并;需要时再开 review agent 检查最终改动。
- 最后由人运行关键测试、看 diff,再决定提交。
多开 agent 本身不等于效率更高。多个 子 agent 如果共用一个工作目录,可能同时改同一文件,或者基于旧状态继续做事。没有 worktree 时,我会把任务拆成不会碰同一批文件的部分;拿不准时,就先让额外的 agent 做只读调查或 review。
哪些任务值得并行
我现在会先看任务之间有没有依赖,再决定要不要开 子 agent:
| 任务情况 | 怎么安排 | 例子 |
|---|---|---|
| 可以独立验收,改动范围不同 | 可以并行,各自用独立 worktree | 一个 agent 写导出功能,另一个补不相关模块的测试 |
| 需要先确定接口或方案 | 先让一个 agent 规划,确认后再实现 | 新增 API 前先定请求/响应结构 |
| 两个任务会改同一文件或共享状态 | 顺序执行,或先拆清边界 | 同时改路由配置和同一份组件文件 |
| 任务很小,启动和复核成本更高 | 直接交给当前 Pi | 改一个文案、修一个明显的小 bug |
| 需要第二双眼睛,不需要写文件 | 开只读调查或 review | 查边界条件、读 diff、整理测试清单 |

一个 Pi 主控在 Herdr pane 中分派任务;实现 agent 与只读审查 agent 各自在独立 pane 运行。Herdr 负责呈现终端与状态,worktree 可选地隔离并行写入任务,最后由人检查 diff 并决定是否整合。
给 子 agent 的任务说明,我会尽量写成一张小工作单:目标、允许修改的范围、不能做的事、验收命令、汇报格式。例如:
目标:给导出功能补单元测试
允许修改:tests/export/**
不要修改:src/export/** 和公共接口
验收:运行 npm test -- export
完成后汇报:改动文件、测试命令和结果、还没覆盖的情况
这样主控不需要猜 子 agent 做到哪一步,也更容易判断结果能不能合并。测试不要只写“通过了”,最好把命令和输出摘要一起带回来。
用 worktree 前先检查什么
Herdr 的 pane 让任务容易观察,worktree 让代码改动彼此隔开,两者解决的问题不同。采用 worktree 的 Pi 扩展会为任务创建独立分支和目录;一些扩展要求源仓库没有已暂存、未暂存或未跟踪文件,基础版本从当前已提交的 HEAD 创建,未提交内容不会自动带过去。分支名要保证唯一,合并仍由主控或开发者审阅后决定。Pi herdr-agents 扩展说明
开始前我会先做这几步:
- 查看主仓库的
git status,确认手头未提交的工作会不会被排除在新 worktree 外。 - 给每个并行任务分配唯一分支名,并确认它们确实能独立完成。
- 子 agent 完成后检查分支、变更文件、diff、测试结果和是否有冲突。
- 由主控逐个整合;没看过 diff 前不自动合并,也不急着清理 worktree。
有些扩展会自动清理干净的 worktree,但遇到有改动或状态不明时会保留,等人检查。这是好事:清理不应该把尚未取回的结果一并删掉。
Herdr 负责可见性,不等于安全沙箱
还有一个容易混淆的点:把 agent 放进独立 pane 或 workspace,只是把终端和任务分开,不自动限制 agent 能读写哪些文件、能不能访问网络或凭证。权限边界仍由 agent 自身的审批/沙箱配置、操作系统权限和你使用的隔离工具决定。
社区里有人把 Gondolin 与 Pi、Herdr 一起使用,原因之一就是希望把 agent 限制在隔离环境中,减少它接触主机文件和凭证的机会。这是额外的沙箱组合,不是 Herdr 默认功能;容器或虚拟环境也要检查挂载目录、网络和密钥传递方式。Pi + Herdr + Gondolin 的讨论
社区项目也在补 Herdr 与 Pi 之间的控制能力:例如 Pi 扩展可以从当前 Pi 会话启动 sibling pane、等待 agent 生命周期状态,再读回 transcript。所以,除了手动切 pane,也可以用扩展把启动、等待和读取串起来。不过这属于扩展额外提供的能力,安装前要确认仓库、权限和版本要求;Herdr + Pi 默认并不包含这些功能。Herdr Control Pi 扩展
这套工作流能解决什么
它解决的主要是并行任务更容易看见和接管。多个 agent 的 pane、状态和输出集中在同一个工作区;终端窗口关掉后,后台会话通常还在;脚本或扩展也能把启动、等待、读取串起来。
它不会自动保证任务正确,也不会因为开了更多 agent 就线性提速。拆分任务、共享文件、模型成本、上下文重复和最后的合并审查,仍然需要人把关。并行数越多,启动和协调成本也越高。对我来说,通常先让一个主控处理任务;只有工作能清楚切成互不冲突的部分时,才加 子 agent。
Pi:模型、输入和用量放在手边
Pi 的常用按键可以直接在 /hotkeys 页面查看。我在当前环境里常用这些:
| 快捷键 | 用途 |
|---|---|
Ctrl+J |
在输入框里换行;Pi 也支持 Shift+Enter,实际是否顺手取决于终端环境 |
Ctrl+L |
打开模型选择器 |
Ctrl+Z |
Windows 下撤销输入框最近一次编辑 |
Ctrl+X |
按当前界面状态复制选择内容或上一条助手回复 |
Alt+V |
在我当前环境里粘贴剪贴板图片;具体行为以 /hotkeys 为准 |

这是 Pi 的原始英文快捷键帮助页。图中 Navigation 是导航,Editing 是编辑,Other 是其他操作,Extensions 是扩展快捷键;表格列 Key / Action 分别表示按键和作用。不同终端、系统和扩展可能改变实际绑定,使用前以本机 /hotkeys 页面为准。
我安装了 pi-powerline-footer 扩展,让底部状态栏显示当前目录、模型和用量。缓存区可以显示缓存 token;缓存命中率等字段则取决于扩展版本和配置。截图里能看见模型、token、费用和缓存数据,但不要把它当成供应商最终账单。

状态栏字段来自我的本机配置;费用读数用于观察会话消耗,实际结算以模型服务商账单为准。
Pi 会把会话保存在本地。需要找回之前的对话时,可以用 /resume 选择会话。正式使用前,最好检查一下项目目录和 agent 配置是否可信,因为 Pi 可能会读取项目里的指令文件和扩展配置。
Windows 下我遇到的几个小问题
换行键不顺手。 Pi 支持 Shift+Enter 和 Ctrl+J 插入新行。我的终端组合里 Ctrl+J 更可靠;换了终端或版本,先用 /hotkeys 看当前按键再决定。
状态栏数字很多。 模型名、上下文、token、费用和缓存信息挤在一行,刚开始不一定知道每项代表什么。可以先保留模型、费用和上下文,熟悉后再开启其他字段。扩展配置会影响显示内容。
skills 会增加上下文。 是否加载、何时加载以及占用多少上下文,要看 agent 和配置方式。我会用 Pi 的检查命令看当前会话装载了什么;如果要写具体数字,最好同时给出检查截图和统计口径。没有这些证据时,不把某次扫描结果泛化成所有人的情况。
这套工作流适合谁
如果你常常同时跑多个 CLI agent,任务会持续一段时间,还希望从一个界面切项目、看状态,Herdr + Pi 值得试试。如果你主要用图形化 IDE、只开一个 agent,或者不想配置终端,维持现有习惯也完全可以。
我这次迁移后,最直接的变化是少在窗口之间找任务。至于整体效率有没有提升,还得看任务怎么拆、模型跑得怎么样,以及最后花多少时间检查和合并。你会把 Pi 当主控来派任务,还是让每个 agent 独立工作?如果已经用 Herdr,最常开的几个 pane 分别负责什么?
如果你觉得这篇内容有价值,欢迎点个赞、点个在看,也欢迎转发给更多朋友。
我是 AI杨侦探,持续记录 AI、技术、产品和产业变化里那些真正值得看、值得想的事。
谢谢你读到这里,我们下次见。