OpenRig：把一堆终端会话变成一支持久化 Agent 团队

📺 出处：本文属「GitHub 一周热点」专栏第 135 期，出处 UP 主：IT咖啡馆（BV1EVJY6GEA6）。

专栏索引页：GitHub 一周热点 · 逐期盘点

① 一句话是什么

OpenRig 是一个本地控制平面：用 YAML 定义一支 Agent 团队（rig），一条命令把 Claude Code、Codex、Pi 这些不同的 harness 收编成同一个系统里管起来。它的原话很有画面感——「A harness wraps a model. A rig wraps your harnesses.」（harness 包模型，rig 包 harness。）

② 为什么火

• 星标数：截至 2026-10-20 实查 GitHub API，mvschwarz/openrig 为 7,965 星。
• 定位稀缺：市面上同类项目多在「单个 Agent 跑任务」，OpenRig 解决的是多 Agent 长期协作的编排与持久化——上下文与工作地址固定，不随终端会话消失。
• 多 harness 混编：Claude Code 和 Codex 可以待在同一个 rig 里被当一套系统管，这是它跟大多数方案的差别。
• npm 包 @openrig/cli 已在公共 registry 上分发，Apache 2.0 协议。

③ 视频里怎么讲的（第 135 期）

第 135 期把它列为「多个 Agent 组织工具」。视频点出的是从「一堆终端」到「一支团队」的转变：过去你开五六个终端窗口手工派活，现在由一个控制平面统一管理席位、状态与唤醒。原视频：https://www.bilibili.com/video/BV1EVJY6GEA6

④ 实测：跑通

安装

# 需要 Node 22 或 24
node --version

# npm 全局安装
npm install -g @openrig/cli

也可以让它把 skill 装进你的编码 Agent：

# Claude Code
npx skills add https://github.com/mvschwarz/openrig/tree/v0.6.12/skills/rigs --skill rigs --agent claude-code

# Codex
npx skills add https://github.com/mvschwarz/openrig/tree/v0.6.12/skills/rigs --skill rigs --agent codex

启动与查看

# 拉起守护进程
rig daemon start

# 查看所有 rig 与席位状态
rig ps

# 查看某个 rig 的席位
rig ps --nodes --rig <name>

# 全量信息
rig ps --full

本站实测结果

$ npm install -g @openrig/cli
added 115 packages in 4s

$ rig --version
0.6.13 (9eeb2e42)

$ rig daemon start
Daemon started on port 7433 (pid 27070)

$ rig ps
1 rig · 2 seats · 0 need attention
RIG                     NODES  RUNNING  ACTIVE  WORK  ATTN  STATUS    LIFECYCLE  UPTIME     SNAPSHOT
kernel                  2      1        1       0     0     partial   deg        5s         —

实测结论：跑通。 npm 安装 4 秒完成，版本号正常，守护进程在 7433 端口拉起，rig ps 输出了真实的席位表（1 rig / 2 seats / 0 need attention），并附带了 rig、节点、运行态、注意力、状态、生命周期、运行时长、快照等列。

踩坑实录

1. rig ps 在守护进程没起时报错是正常的：直接跑会得到 Error: Daemon not running.——这不是 bug，是它在提醒你先启动。命令本身已把下一步提示写清楚了。
2. rig up 不是启动守护的用法：rig up 需要一个 source 参数（是给已有 rig 用的），启动守护要用 rig daemon start。
3. 端口 7433 是默认监听口：多实例并行时注意端口占用。
4. 命令面很宽：rig --help 里能看到 start / status / snapshot / restore / export / import / bootstrap / requirements / discover / gateway / parked / tui / ui 等一长串子命令，建议先看 rig --help 再上手。

⑤ 适合谁 / 不适合谁

适合：同时用好几个编码 Agent、觉得终端窗口太多管不过来的开发者；想把 Claude Code 与 Codex 混编在同一套编排里的团队；愿意花半小时把 YAML 团队规格写清楚的重度用户。

不适合：只跑单个 Agent 干一件小事的人（杀鸡用牛刀）；不希望本机常驻一个守护进程的人；需要 Windows 原生支持的人（OpenRig 大量依赖 tmux 与 POSIX 习惯，macOS/Linux 最顺）。

⑥ 项目地址 + 原视频链接

• 项目地址：https://github.com/mvschwarz/openrig
• npm 包：https://www.npmjs.com/package/@openrig/cli
• 官方文档站：https://openrig.dev/
• 原视频（第 135 期）：https://www.bilibili.com/video/BV1EVJY6GEA6

本篇为第 135 期专栏的实操实测篇。专栏索引：GitHub 一周热点 · 逐个实测