开源项目 pi-cowboy 为 pi 提供多 agent 编排功能：将大任务拆成子任务，交给后台 agent 并行处理，再汇总结果。据项目 README，它支持在同一会话中混用 Pi、Claude Code、OpenCode 和 Codex，并为每个 agent 配备独立终端面板与隔离的 Git 工作树，将跨框架调度、实时查看和分支审查纳入同一工作流程。
每个 agent 都在 Herdr 的独立终端面板中运行，使用自己的写时复制（copy-on-write）Git 工作树。用户可以实时查看进展，也可以切入面板直接引导任务。README 称，这种隔离允许多个 agent 同时编辑、构建和运行测试，互不干扰。
各 agent 将改动提交到自己的分支，用户可逐项审查和合并。agent 完成一轮工作后，报告会送回父会话；父会话可以要求继续修改，也可以合并分支。项目还支持自定义 agent 模板和编排器模板，分别配置专业角色和跨 agent 的工作规则。
据 README，全局并发上限默认为 4，超出的 agent 会排队。用户还可按执行框架、服务提供方和模型设置上限；新任务只有在所有适用层级都有空位时才会启动。已结束一轮工作的 agent 若收到继续执行的指令，会立即恢复运行，可能暂时超出上限。
README 给出了一组发布方自测数据：测试仓库共有 153,607 个文件，已跟踪文件为 479 MiB，计入未跟踪文件后共 27 GiB。
在这一案例中，pi-cowboy 的写时复制工作树包含未跟踪文件，磁盘占用为 75 MiB；普通 git worktree add 不包含未跟踪文件，占用 479 MiB；普通工作树再复制未跟踪文件，则占用 27 GiB。三组数字对应的文件覆盖范围不同。
据 README，项目支持 Linux 和 macOS，需要 herdr 0.8 或以上版本，并启用其 pi 集成；macOS 还需安装 python3。写时复制要求文件系统支持该能力，例如 macOS 的 APFS、Linux 的 BTRFS 或 ZFS。ext4 不支持写时复制，会回退为 checkout。
任务合并后，cleanup_cowboy_agent 可关闭 Herdr 面板和标签页、移除工作树，并删除已合并的分支。该工具拒绝清理仍在运行的 agent，也会保留存在未提交改动的工作树。
项目采用 MIT 许可，安装命令为 pi install npm:pi-cowboy。
