OpenRig rig terminal open实战：一个命令打开starter全部终端-开发者社区

OpenRig rig terminal open实战：一个命令打开starter全部终端

【免费下载链接】openrigMulti-agent harness that runs Claude Code and Codex together as one system项目地址: https://gitcode.com/GitHub_Trending/op/openrig

OpenRig 是一个多智能体协作框架（multi-agent harness），可以把 Claude Code 和 Codex 装进同一个 rig（团队）里统一管理。启动团队后最头疼的往往是：每个 agent 各占一个 tmux 会话，终端散落一地。而rig terminal open就是解决这个问题的命令——一个命令，把 starter 团队的全部 agent 终端打开成一块可视的"终端墙"，由 herdr 或 cmux 作为底层终端 provider 渲染。本文带你从零跑通这条实战路径。

为什么需要 rig terminal open

没有 OpenRig 时，你可能要手动 attach 每个 tmux 会话才能看到各个 agent 的进度；有了rig terminal open：

一个视图打开全部终端：按 rig 名、mission:<id>、slice:<id>或保存的视图 ID 打开，每个运行中的 seat 都会变成一块可交互的终端瓦片
诚实的结果披露：返回opened / absent / degraded三段式结果，谁打开了、谁缺席、谁被跳过，全部点名
双 provider 支持：默认 herdr（每个 tab 最多 16 个 seat），也可用--provider cmux

第一步：启动一个 starter 团队

终端墙的前提是团队已在运行。OpenRig 内置了多个 starter rig，先看看再启动：

npm install -g @openrig/cli rig setup --dry-run # 先预览安装计划 rig specs ls # 浏览内置 rig 库 rig up first-project # 最小两座位 starter（一个 owner + 一个 checker）

如果想要更大的阵容，product-team（双编排 + 实现 + QA + 设计 + 两名独立评审）或四座位的conveyor（Claude Code 与 Codex 混合，展示 intake → planning → build → review 的交接路径）都是好选择。

用rig tui --shared可以随时回到共享仪表盘查看团队状态（Ctrl-b 再按 d 分离，不退出团队）。

实战：一条命令打开 starter 全部终端

确认 herdr 已安装并连接后，执行核心命令：

rig terminal open first-project --provider herdr

如果装了 cmux，把参数换成--provider cmux即可，同一视图在两个 provider 里都能打开。

输出长这样——每一行都是一个 seat 的实时状态：

Opened 2 tile(s) in herdr. ● dev-owner@first-project ● dev-check@first-project

在 herdr 里，这些瓦片会组成一个以 rig 命名的 workspace，每个瓦片就是一个可交互的 agent 终端。注意：重复执行 open 可能会创建新的 provider workspace，想保留原有视图就回到已打开的那个。

读懂 opened / absent / degraded

这是rig terminal open最有价值的部分。命令的退出码遵循"诚实原则"：只要至少打开了一块瓦片，即使部分 seat 缺席，也按成功处理（exit 0）并点名披露；一块都没打开（未知视图、provider 宕机、seat 全部缺席）才返回非零。三段结果的读法：

标记	含义	该怎么做
`● seat`	已成功打开	直接操作
`○ seat — absent: ...`	该 seat 不存在或会话不在	检查`rig ps`，必要时恢复
`▲ seat — skipped (...): ...`	降级跳过（如远端 host 问题）	排查对应 host 的连接

一个提醒（官方文档原话）：部分终端视图不等于团队健康，看到缺席项要去追原因，而不是默认没事。这段"人类可读披露"的实现见 packages/cli/src/commands/terminal.ts。

配套命令：views 与 status

rig terminal是一个命令族，另外两个子命令帮你排查问题：

rig terminal views # 列出保存的视图 + 可派生的 rig 视图 rig terminal status --provider herdr # 终端 provider 可用性与存活状态（doctor 式检查）

两个命令都支持--json输出，方便被 agent 或脚本消费。herdr 的完整使用模式（含"同一尺寸才能复制 pane"等限制）写在内置技能文档 skills/_canonical/core/openrig-herdr/SKILL.md 里，终端 provider 的语义由 OpenRig 掌控，herdr 只负责渲染像素。

常见问题速查

提示 provider 不可用？先跑rig terminal status确认 herdr/cmux 安装与 socket 状态，rig setup会一并检查 cmux。
打开的是哪个视图？传入 rig 名即按 rig 派生视图，也可用rig terminal views里的保存视图 ID。
只想看共享仪表盘？rig terminal open kernel --provider herdr会打开 kernel（含 operator-human 终端）的视图。
终端关了要不要重启团队？不需要。底层会话仍在 tmux 里，seat 地址和持久队列不会因为你关掉了查看终端而丢失。