OpenRig

把 Claude Code 与 Codex 组成持久化的智能体团队:用 YAML 定义拓扑,一条命令启动,统一管理与恢复。

Star 数
★ 4.9k
最近更新
今天
License
Apache-2.0
主语言
TypeScript

30 秒速览

运行形态
命令行工具MCP 服务器自托管服务
可在哪里用
通用 · 跨平台Codex · Claude Code
费用
软件免费,模型调用费用自付
上手难度
中 · 需要几步配置
开始前需要
Node.js 22 或 24tmuxClaude Code 和/或 Codex CLInpm 或 BunDocker(可选,用于服务型 rig)herdr 或 cmux(可选终端工作区)Shell / 命令行网络访问本地文件系统MCP Server
典型场景
个人开发者在自己的仓库里启动 owner/checker 两人组(first-project 系列),让 Claude 负责人协调 Codex 审查者完成一次经过审查的代码变更
不适合
  • Windows 原生用户或需要 WSL2 保障的团队
  • 只想单独使用一个编码智能体、不需要多智能体协作的开发者
  • 不愿在本地写入 provider 信任设置与 hooks 的环境

这个 Agent 能做什么,适合哪些场景?

OpenRig 是一个开源的多智能体编排系统,它不封装单个模型,而是管理编码智能体组成的团队。它在本地以守护进程 + CLI + 终端 UI + MCP 服务器的形式运行,底层依赖 tmux 和 SQLite。你用 YAML(RigSpec)声明 pods、成员、边和延续策略,然后用 `rig up` 一条命令启动整个拓扑,所有智能体都在可附加的 tmux 会话里。它原生支持 Claude Code 与 Codex 混编同一团队,也通过 RPC runner 支持 Pi 和 Oh My Pi。项目提供多个入门 rig(first-project、conveyor、product-team 等)以及一个由专业智能体托管 HashiCorp Vault 的 agent-managed software 示例。需要 Node.js 22 或 24、tmux,目前仅支持 macOS 与 Linux。

OpenRig 读取你编写的 YAML RigSpec(含 pods、成员、edges、延续策略和文化文件),通过 rig up 启动 tmux 会话、向各 seat 注入身份与守护进程连接环境、写入启动文件并执行就绪检查。运行时它提供:rig send/rig broadcast/rig chatroom 跨智能体通信;rig ps、rig tui 查看拓扑表、图与 seat 细节;rig discover 指纹识别已有 Claude Code/Codex tmux 会话并用 rig adopt 收编;rig down --snapshot 快照拓扑、rig up <name> 按名恢复;rig grow/rig shrink/rig launch/rig remove 动态调整拓扑;rig queue list 查看任务队列;rig seat set-typing-guard 保护手动输入的 seat;rig slack manifest 生成 Slack 应用清单;权限治理用 rig policy permissions 与 rig seat set-permissions。MCP 工具(rig_up、rig_ps、rig_send 等)让智能体自行管理拓扑。架构为 Hono HTTP 守护进程 + 领域服务 + SQLite/tmux/运行时适配器。

  1. 个人开发者在自己的仓库里启动 owner/checker 两人组(first-project 系列),让 Claude 负责人协调 Codex 审查者完成一次经过审查的代码变更
  2. 维护多个 AI 终端会话、苦于重启后无法恢复的工程师,用 rig down --snapshot 和 rig up <name> 保存并按名还原整个团队状态
  3. 想要跨厂商混编的团队,让 Claude Code 智能体和 Codex 智能体在同一 rig 中以共享上下文与队列协作
  4. 已有散落的 tmux 里 Claude/Codex 会话的用户,用 rig discover + rig adopt 把它们收编进托管拓扑
  5. 需要更大产品小队的团队,用 product-team 启动两个编排者、实现、QA、设计与两个独立审查者
  6. 安全运维场景,用 secrets-manager rig 让专门的 vault-specialist 智能体通过 rig send --verify 检查托管 Vault 的健康状态

如何安装或部署这个 Agent?

前提:Node.js 22 或 24(Apple Silicon Mac 用 22)、tmux、macOS 或 Linux;已有 Claude Code 或 Codex 的可用账号。安装 CLI 并预览设置:

bash

npm install -g @openrig/cli
rig setup --dry-run

也可用 Bun 安装:

bash

bun add -g @openrig/cli

安装前应阅读 README 中“OpenRig 会改动你机器上的什么”一节并备份相关文件:setup 会写入 tmux 配置,守护进程启动会在 ~/.openrig 写入实例状态、在 ~/.claude/skills 与 ~/.agents/skills 播种 openrig-skills 技能,并在 Claude/Codex 的配置文件中写入信任与 hooks 设置。

如何使用这个 Agent?

进入你的仓库,选择一个 starter(first-project、first-project-claude 或 first-project-mixed),预览、规划并启动:

bash

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

检查 seat 就绪并给负责人分配一个有边界的任务:

bash

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

在共享 TUI 中按 Ctrl-b 再按 d 可脱离而不停止仪表板;rig tui --shared 可随时返回。用 rig specs ls 浏览全部 starter 拓扑库。

这个 Agent 有哪些优点和局限?

优点
  • 跨厂商团队:Claude Code 与 Codex 可在同一 rig 中协作,混编 starter(first-project-mixed)开箱即用
  • 持久化与可恢复:快照/按名恢复(rig down --snapshot、rig up <name>)、seat 身份稳定,会话占用者可更换而上下文保留
  • 声明式拓扑与渐进演进:YAML RigSpec 定义 pods/edges/延续策略,可用 rig grow/shrink/launch/remove 在运行中调整
  • 自管能力:MCP 工具让智能体自行启动拓扑、发消息、管理队列;typing-guard 保护人工输入的 seat
  • 完整运维面:TUI 拓扑图/表、rig doctor 健康诊断、RigBundle 带 SHA-256 的可移植拓扑包
局限
  • 平台受限:不支持原生 Windows,WSL2 未测试;仅 macOS 与 Linux
  • 会改动本机 provider 配置:写入 ~/.codex/config.toml、.claude/settings.local.、信任记录与 hooks,无完整保留/回滚保证,需自行备份
  • 需要 Node.js 22/24 和 tmux,Node 20 已被拒装;Apple Silicon 上有已知的 Node 版本兼容限制
  • 升级有迁移风险:0.5.9 布局边界需运行 openrig-upgrade 技能的多阶段 Agent-Operated Migration 脚本
  • 依赖已付费的 Claude/Codex 账号,模型用量费用另计;React Web UI 处于维护模式

这个 Agent 与同类方案有什么区别?

README 将其与 Claude Managed Agents 对比:OpenRig 开源且自托管,可在同一团队中混合 Claude Code 与 Codex,运行在你自己的基础设施上,模型用量费用仍由所选 provider 收取;项目在 openrig.dev/compare/claude-managed-agents 提供完整对比。

与相关度最高的同类 agent 并排比较关键指标。

Agent 源码审查 形态 / 费用 Star 最近更新 主语言 完整支持的平台
OpenRig 当前 79 · 表现良好 命令行工具免费 + 模型费 ★ 4.9k 今天 TypeScript Codex · Claude Code
NTM(Named Tmux Manager) 73 · 存在缺口 命令行工具免费 + 模型费 ★ 452 2 天前 Go Codex · Claude Code
Agent Manager 64 · 存在缺口 命令行工具免费 ★ 561 今天 Go Codex · Claude Code
AgentBridge 61 · 存在缺口 命令行工具免费 + 模型费 ★ 370 22 天前 TypeScript Codex · Claude Code

FollowAgents 如何评估这个 Agent?

FollowAgents 源码审查 · FARS-2.1
表现良好
79/ 100 五分制 4.0 / 5
信任安全 21/29
可靠稳定 12/14
适用触发 15/18
规范维护 15/18
有效结果 10/13
证据核验 6/8
查看各维度的扣分理由
信任安全21 / 29 · 3.6/5

README 详细披露了写入内容、YOLO 默认关闭、权限模式需用户明确选择;扣分点:守护进程默认启用 Codex hooks、启动时预写信任哈希、自动写入不以逐项预览为准,且文档自认“非完整保存/回滚保证”。数据流披露极为详尽(活动负载排除提示文本),数据流透明满分;敏感数据处理中等(transcript 路径等元数据仍写入状态);依赖安全仅凭 better-sqlite3 提及,范围内无审计/锁定证据,给 1。

可靠稳定12 / 14 · 4.3/5

测试显示诚实且结构化的错误消息(conflict/not-found/failed launch 均以非零退出并带可操作文案),自洽性有 docs-guard、mirror-skills --check 等机制支撑;扣分点:依赖可用性依赖外部 CLI(claude/codex)与 tmux,且明确“部分平台未测试”,只能给 2。

适用触发15 / 18 · 4.2/5

环境适配证据充分:Node 22/24、tmux、macOS/Linux、Apple silicon 限制、Windows/WSL2 未测试均明示,环境适配满分;能力边界同样有明确“不支持/未测试”陈述;扣分点:受众与场景描述偏作者个人实验叙事('AI civilization experiments'),触发精度(何时该用哪个 starter/权限模式)靠文档推理而非机制约束。

规范维护15 / 18 · 4.2/5

信息架构、安装说明非常完整(含升级、Node 20 迁移、0.5.9 布局边界);已知限制披露充分;Apache-2.0 LICENSE 全文与版权声明齐全,license 满分;扣分点:命名稳定性有历史别名(legacy YOLO 路径、rig policy 别名),版本变更日志仅以链接引用而非文件本体呈现,维护责任是单人维护者、响应时限为承诺而非机制。

有效结果10 / 13 · 3.8/5

输出可用性证据好:-- 选项、错误消息、TUI/表格视图均有测试覆盖;扣分点:边际价值与成本收益为推断——该工具为整个多智能体编排层,安装面大(守护进程、hooks、tmux、可选 herdr/cmux),这些收益主张在静态审查中无法验证,保守给 2。

证据核验6 / 8 · 3.8/5

事实与推断分离良好:文档明确区分“已实现行为”与“未测试/不支持”,测试引用具体验收 ID(OPR.0.3.3.13.2);扣分点:主张可追溯性受限于范围内未含守护进程核心源码,多数安全主张(如“不发送提示文本”)只能以文档自述核对;跨源印证仅限于 README 与 SECURITY.md/CI 的部分一致性,无法外部核实。

风险与缓解建议
  • 安装即写全局配置:rig setup 与守护进程启动会修改 ~/.claude、~/.codex、~/.tmux.conf 等文件,且自动写入无逐项预览;首次使用前务必备份相关文件。
  • 默认启用 Codex hooks 并预写信任哈希、工作区预信任;这些是默认行为而非逐次询问,最小权限要求高的环境应先 --dry-run 审查。
  • 共享 Claude 设置将 permissions.defaultMode 设为 acceptEdits,并启用 Exa/Context7 等外部 MCP 服务,注意外部数据流。
  • 范围内无依赖审计证据;better-sqlite3 等依赖安全状况未在源文件中展示,使用前自行审计。
  • Windows 不支持、WSL2 未测试;Apple silicon 需 Node 22;在生产环境采用前应有隔离测试。
证据充分度:低 评估于 2026年10月4日 审查版本 dce8c90f4176
查看完整评分方法 →

常见问题

它需要付费订阅吗?
OpenRig 本身开源免费(Apache-2.0),但它运行的是你已有的 Claude Code 或 Codex 账号,不需要第二份订阅;所选 provider 的模型用量费用照常产生。
它会在我的机器上改哪些东西?
setup 会写 ~/.tmux.conf;守护进程启动在 ~/.openrig 写实例状态和 SQLite 数据库,并向 ~/.claude/skills、~/.agents/skills 播种技能;启动 rig 时写入 Claude 的信任与 settings.local.、Codex 的 config.toml 信任记录和 hooks。README 建议首次使用前备份相关文件。
YOLO 模式默认开启吗?
不是。YOLO 默认关闭;只有显式选择 full-bypass 策略才会使用 Claude 的 --dangerously-skip-permissions 或 Codex 的 -s danger-full-access -a never。默认 Claude 使用 acceptEdits,Codex 使用 workspace-write 沙箱。
出问题时怎么诊断?
用 rig doctor 检查系统健康;智能体可运行 rig context get help(同一文本在 openrig.dev/help/agents),GitHub 有 Discussions Q&A 与 issue 渠道,目标是约一天内响应。
从旧版本升级要注意什么?
升级到 0.6.0 必须先切换到 Node.js 22 或 24 再重装 CLI;跨 0.5.9 布局边界需运行 openrig-upgrade 技能的分阶段迁移脚本(含验证与回滚),且 rig down 不是升级步骤,升级期间应保留活动 seat。
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关 Agents