openrig

环境要求

• Node.js 22 或 24（Apple silicon 的 Mac 请用 Node.js 22）
• tmux，需在 macOS 或 Linux 上运行
• 已有一个可用账号：Claude Code、Codex，或两者都有
• 按需安装所选 provider 的 CLI（claude 或 codex）

安装与启动步骤

1. 1安装 CLI

   全局安装 @openrig/cli；用 Bun 可换成 bun add -g @openrig/cli，但 OpenRig 仍跑在 Node.js 上。

   npm install -g @openrig/cli

   复制

2. 2预览机器准备

   --dry-run 只预览 setup 会做的改动；正式执行前请阅读“OpenRig 会改动什么”并备份相关文件。

   rig setup --dry-run

   复制

3. 3检查环境与登录

   确认 tmux 可用，并只检查你所选的那个 CLI 及其登录状态，不要登录用不到的 provider。

   tmux -V
   claude --version
   claude auth status
   codex --version
   codex login status

   复制

4. 4进入仓库选团队

   进入你的代码仓库，三选一：first-project、first-project-claude 或 first-project-mixed。

   cd /path/to/your/repository
   starter=first-project

   复制

5. 5预览并规划启动

   先看选中的运行时、模型与命令，确认账号支持该模型，再生成启动计划。

   rig specs preview "$starter" --kind rig
   rig up "$starter" --cwd . --plan

   复制

6. 6启动 rig

   按计划真正拉起编队；启动会写入 provider hooks 与工作区信任设置，请先确认可接受。

   rig up "$starter" --cwd .

   复制

7. 7打开共享面板

   打开共享仪表盘查看各智能体；Ctrl-b 再按 d 可脱离而不停止仪表盘。

   rig tui --shared

   复制

8. 8检查就绪并派任务

   先确认项目座位就绪并处理认证/信任提示，再给 owner 一个有界任务；发消息本身不创建队列项。

   rig ps --nodes --rig "$starter"
   rig send "dev-owner@$starter" 'Implement <one useful change>. Track the task in the queue and return its ID. Keep it local, verify the behavior, ask dev-check in this rig to check the exact candidate, and record the result and how I can try it.'
   rig queue list --destination "dev-owner@$starter" --limit 1000

   复制

关键配置

如何确认成功

执行 rig ps --nodes --rig "$starter" 看到节点就绪且无待处理的认证、信任或权限提示；也可用 rig doctor 检查系统健康。

常见问题

注意事项

• 启动 rig 会写入 provider hooks 和工作区信任设置，运行前请阅读“OpenRig 会改动什么”并备份相关文件。
• 首次启动时智能体会询问是否允许无重复授权运行 OpenRig 命令，回答 No 或不回答则设置保持不变。
• 已启动的会话可能需要重启才能加载新写入的运行时配置。