OpenRig
把 Claude Code 与 Codex 组成持久化的智能体团队:用 YAML 定义拓扑,一条命令启动,统一管理与恢复。
- Star 数
- ★ 4.9k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 79/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 个人开发者在自己的仓库里启动 owner/checker 两人组(first-project 系列),让 Claude 负责人协调 Codex 审查者完成一次经过审查的代码变更
- 不适合
- Windows 原生用户或需要 WSL2 保障的团队
- 只想单独使用一个编码智能体、不需要多智能体协作的开发者
- 不愿在本地写入 provider 信任设置与 hooks 的环境
- 源码审查
- 79/100 · 表现良好
这个 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/运行时适配器。
- 个人开发者在自己的仓库里启动 owner/checker 两人组(first-project 系列),让 Claude 负责人协调 Codex 审查者完成一次经过审查的代码变更
- 维护多个 AI 终端会话、苦于重启后无法恢复的工程师,用 rig down --snapshot 和 rig up <name> 保存并按名还原整个团队状态
- 想要跨厂商混编的团队,让 Claude Code 智能体和 Codex 智能体在同一 rig 中以共享上下文与队列协作
- 已有散落的 tmux 里 Claude/Codex 会话的用户,用 rig discover + rig adopt 把它们收编进托管拓扑
- 需要更大产品小队的团队,用 product-team 启动两个编排者、实现、QA、设计与两个独立审查者
- 安全运维场景,用 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/repositorystarter=first-project # 或 first-project-claude / first-project-mixed
rig specs preview "$starter" --kind rig
rig up "$starter" --cwd . --planrig 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?
查看各维度的扣分理由
README 详细披露了写入内容、YOLO 默认关闭、权限模式需用户明确选择;扣分点:守护进程默认启用 Codex hooks、启动时预写信任哈希、自动写入不以逐项预览为准,且文档自认“非完整保存/回滚保证”。数据流披露极为详尽(活动负载排除提示文本),数据流透明满分;敏感数据处理中等(transcript 路径等元数据仍写入状态);依赖安全仅凭 better-sqlite3 提及,范围内无审计/锁定证据,给 1。
测试显示诚实且结构化的错误消息(conflict/not-found/failed launch 均以非零退出并带可操作文案),自洽性有 docs-guard、mirror-skills --check 等机制支撑;扣分点:依赖可用性依赖外部 CLI(claude/codex)与 tmux,且明确“部分平台未测试”,只能给 2。
环境适配证据充分:Node 22/24、tmux、macOS/Linux、Apple silicon 限制、Windows/WSL2 未测试均明示,环境适配满分;能力边界同样有明确“不支持/未测试”陈述;扣分点:受众与场景描述偏作者个人实验叙事('AI civilization experiments'),触发精度(何时该用哪个 starter/权限模式)靠文档推理而非机制约束。
信息架构、安装说明非常完整(含升级、Node 20 迁移、0.5.9 布局边界);已知限制披露充分;Apache-2.0 LICENSE 全文与版权声明齐全,license 满分;扣分点:命名稳定性有历史别名(legacy YOLO 路径、rig policy 别名),版本变更日志仅以链接引用而非文件本体呈现,维护责任是单人维护者、响应时限为承诺而非机制。
输出可用性证据好:-- 选项、错误消息、TUI/表格视图均有测试覆盖;扣分点:边际价值与成本收益为推断——该工具为整个多智能体编排层,安装面大(守护进程、hooks、tmux、可选 herdr/cmux),这些收益主张在静态审查中无法验证,保守给 2。
事实与推断分离良好:文档明确区分“已实现行为”与“未测试/不支持”,测试引用具体验收 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;在生产环境采用前应有隔离测试。