OpenRig
一个 harness 包裹一个模型。一个 rig 包裹你的多个 harness。用 YAML 定义你的 agent 团队，一条命令即可启动。Claude Code 和 Codex 在同一个 rig 中，作为一个系统统一管理。
OpenRig 是一款开源软件，用于构建和运行你自己的 agent 网络。它将 AI 编程 agent 从一堆终端会话转变为一个持久、有组织的团队。与 lead agent 沟通你想要的结果；它可以协调跨团队的专家，并将需要你关注的结果和决策带给你。从一个代码仓库和一个有用的改动开始，然后让团队的工作和上下文保持在相同的地址上。它是我 AI 文明实验背后的开源系统。
指南：入门 · 遇到困难？帮助 · 问题：问答 · 更新和演示：X 上的 @_feralmachine
观看运行效果
从这里开始：引导式首次使用路径：安装、在你的代码仓库中启动一个双 agent 团队，并获得一个经过审查的改动。
今天不打算搭建？获取下一次演练和偶尔的 OpenRig 更新 → https://openrig.dev/follow
安装与首次运行
需要 Node.js 22 或 24 以及 tmux，运行在 macOS 或 Linux 上。在 Apple 芯片的 Mac 上，使用 Node.js 22（兼容性历史）。原生 Windows 尚不支持，WSL2 尚未测试。
启动一个 rig 会写入 provider hooks 和工作区信任设置。在运行以下命令之前，请阅读 OpenRig 在你的机器上所做的更改并备份相关文件。
npm install -g @openrig/cli
rig setup --dry-run如果要用 Bun 安装，请运行 bun add -g @openrig/cli。OpenRig 仍然运行在 Node.js 上，因此也要安装 Node.js 22。Bun 可能会阻止此包的 postinstall 脚本，在这种情况下，“OpenRig 在你的机器上所做的更改”中描述的 Node.js 和 SQLite 检查不会在安装时运行。
选择你已有的工作账户：Claude Code、Codex，或两者兼有。复用已有的明确选择；无需第二个订阅。
rig setup --dry-run 预览更广泛的设置，但应用 rig setup 会同时检查两个 harness 和 cmux。对于选定 provider 的路径来说，这是可选的。
启动之前，你的 agent 会询问一次：“允许你的 agent 运行 OpenRig 命令而无需重复的权限提示？”是——推荐 / 否——保留提示。这涵盖所有 rig 命令，包括启动/停止 agent 和配置，范围是个人项目级别，除非你明确选择用户级会话。这不是全局 YOLO 或凭空创造工作的许可。选择“是”时，agent 会添加并验证原生规则；选择“否”或不回答则保持设置不变。已有的明确选择会被复用。说“撤销此设置添加的 OpenRig 命令许可”即可仅移除其添加的内容。
检查 tmux -V 以及仅你选择的 CLI/登录：claude --version 加 claude auth status，或 codex --version 加 codex login status。如有需要，用 claude auth login 或 codex login 登录一次；不要安装或登录未使用的 provider。
团队
| 入门模板 | 模型 | |---|---| | Two Codex agents first-project | 均为 gpt-6-astra（未更改） | | Two Claude agents first-project-claude | 配置的原生 Claude 默认值 | | Claude owner + Codex checker first-project-mixed | Claude 默认值 + gpt-6-astra |
三者都使用相同的 owner/checker 角色和任务。在启动前显示选定的运行时、配置的模型和命令；确认账户支持该模型，而不是静默回退。内核自动启动，并从可用的已认证 provider 中独立于这两个项目 agent 进行选择。缺少未使用的 provider 不是设置要求。
cd /path/to/your/repository
starter=first-project # 或 first-project-claude 或 first-project-mixed
rig specs preview "$starter" --kind rig
rig up "$starter" --cwd . --plan
rig up "$starter" --cwd .
rig tui --shared内核提供独立的运维支持和共享仪表盘。要在不停止仪表盘的情况下分离，按 Ctrl-b 然后按 d；rig tui --shared 可返回该视图。直接运行 rig tui 会打开一个独立视图。关闭查看终端并不意味着你应该重新启动团队。
用 rig ps --nodes --rig "$starter" 检查项目席位就绪状态，并在分配工作之前解决任何认证、信任或权限提示。然后从你的代码仓库给 owner 一个有界的结果：
rig send "dev-owner@$starter" 'Implement . 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 发送消息本身不会创建队列项；owner 会记录该任务。阅读最终产物及其确切候选版本的审查，然后回到同一个 owner 进行下一个改动。引导式首次使用路径涵盖就绪状态、一个有用的任务、经过审查的结果、Herdr/cmux 终端和恢复。
今天不打算搭建？获取下一次演练和偶尔的 OpenRig 更新 → https://openrig.dev/follow
社区
- 问题：Discussions › 问答
- Bug 和功能请求：提交 issue
- 贡献：CONTRIBUTING.md · 行为准则 · 安全政策 · 获取帮助
- 视频：youtube.com/@openrig
- 发布：GitHub Releases 和 npm @openrig/cli
我们力求在一天内确认 issue 和 pull request；审查目标见 CONTRIBUTING.md。
OpenRig 在你的机器上所做的更改
OpenRig 在设置和运行过程中写入实例状态、provider 集成和工作区文件。这些包括信任设置和可执行 hooks。以下摘要遵循此源码修订版；使用已发布的包时请检查 rig --version，因为仓库指南可能领先于 npm。
| 时机 | 更改内容及原因 | |---|---| | npm 安装 | 在你的 npm prefix 下安装 CLI、捆绑组件和依赖（使用 Bun 时，在 Bun 的全局目录下）。OpenRig 的 postinstall 检查 Node.js 版本以及 SQLite 模块是否加载；Bun 可能会阻止此脚本。它不会运行守护进程或 provider 设置。 | | rig setup | 尝试缺失的工具和 wr |