$ cat ~/map/pi-tmux-orchestrator.md

pi-tmux-orchestrator

Pi 扩展 + 无依赖的 Python CLI，把实现者、评审员与可选探针 agent 编排进可监控的 tmux 网格，并提供单次运行的 Unix 域套接字 broker。

tools✓ 10月16日

事实速查

仓库: github.com/revazi/pi-tmux-orchestrator ↗
GitHub Stars: ★ 2
Forks: 0
许可证: MIT
npm / 月: —
最后推送: 2026年10月12日

安装

pi install npm:pi-tmux-orchestrator

## 速览

Pi 扩展 + 技能 + 无依赖 Python CLI，把多个编码 agent 编排进可监控的 tmux 网格——一名实现者加一名独立评审员、可选专家角色，外加每次运行专属的 Unix 套接字 broker 和实时状态仪表盘。

## 要点

$网格角色：一名拥有常规 Pi 编码工具的实现者、一名只读/验证工具的独立评审员、可选的技术探针、Playwright 测试员与 Django 专家——外加每次运行一个事件驱动、仅限属主的 Unix 套接字 broker 与自适应状态仪表盘。
$精简的 Pi 命令面：/or-dashboard、/or-models、/or-start、/or-send、/or-stop。/or-dashboard 覆盖层（Ctrl+Shift+G）列出各次运行的工作流状态、轮次、provider 调用、token、成本与上下文压力；j/k 导航、Enter 附着、x 停止、d 运行 doctor。
$worker 模型策略按角色配置在 ~/.pi/agent/tmux-orchestrator.json——内置 thinking 档位 economy/balanced/thorough、自定义 profile 与按项目映射；Pi 自身的 provider 认证与 models.json 始终是权威，编排器从不读取凭据。
$事件驱动协作：没有 Markdown 交接、就绪标记、信箱载荷文件、轮询、生命周期 sleep 或 tmux 按键注入；持久状态只有元数据级 SQLite 加完整 Pi 会话，存于 ~/.pi/agent/orchestrations/<session>/<run/>。
$还提供版本化 JSON CLI（pi-tmux-agents）与不依赖 tmux 的 Supervisor API v2、可选的持久化项目中立 controller 会话，以及 tmux-orchestrator-budgets.json 里的严格用户级预算阈值。
$环境要求：pi 命令可用、Python 3.11+、tmux 3.2+（推荐 3.5+）、Node 22.19+（仅包校验需要）。

## 常见问题

Q 可以先试用而不安装吗？

可以——pi -e npm:pi-tmux-orchestrator 无需安装即可运行一次。要按审阅过的提交安装，用 pi install git:github.com/revazi/pi-tmux-orchestrator@<reviewed-full-commit>，或让 pi install 指向本地检出目录。

Q 怎么查看运行中的编排？

打开 /or-dashboard 后按 Enter 即可附着——发起的 Pi 必须已在 tmux 内。tmux 前缀键后按 L 可脱离网格回到同一个 Pi，运行继续不中断。终端里用 pi-tmux-agents list/status/watch/attach 也能完成同样操作。

Q 父 Pi 扮演什么角色？

执行 /or-start 的那个 Pi 会话即父监督者：持有经认证的只读 broker 观察者，接收结构化的完成与告警报告并决定下一步。子 Pi 会话绝不继承父级的项目信任。

pi-tmux-orchestrator

## 速览

## 要点

## 常见问题

## 参考链接

## 相关条目

## 教程