OpenRig
把 Claude Code 与 Codex 组成持久化的智能体团队:用 YAML 定义拓扑,一条命令启动,统一管理与恢复。
- Star 数
- ★ 8.9k
- 最近更新
- 今天
- License
- Apache-2.0
- 主语言
- TypeScript
- FA 评分
- 79/100 · 表现良好
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台Codex · Claude Code
- 费用
- 软件免费,模型调用费用自付
- 上手难度
- 中 · 需要几步配置
- 开始前需要
- 典型场景
- 个人开发者在自己的仓库里启动 owner/checker 两人组(first-project 系列),让 Claude 负责人协调 Codex 审查者完成一次经过审查的代码变更
- 不适合
- Windows 原生用户或需要 WSL2 保障的团队
- 只想单独使用一个编码智能体、不需要多智能体协作的开发者
- 不愿在本地写入 provider 信任设置与 hooks 的环境
- 官网
- openrig.dev ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-21最新版本 v0.7.20(2026-11-20)近 7 天每天 +9.6 ★
- 源码审查
- 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 的健康状态
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
npm install -g @openrig/clibun add -g @openrig/cli
- 配置文件
~/.openrig~/.claude/skills~/.agents/skills- 运行环境
- Node.js 22
- 安装说明涉及
- macOS · Linux
如何安装或部署这个 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.json、信任记录与 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 · 表现良好 | 命令行工具免费 + 模型费 | ★ 8.9k | 今天 | TypeScript | Codex · Claude Code |
| NTM(Named Tmux Manager) | 61 · 存在缺口 | 命令行工具免费 + 模型费 | ★ 465 | 今天 | Go | Codex · Claude Code |
| Agent Manager | 75 · 表现良好 | 命令行工具免费 | ★ 701 | 今天 | Go | Codex · Claude Code |
| Kangentic | 65 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 150 | 今天 | TypeScript | Codex · Claude Code |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
README 与 getting-started 明确列出安装、启动和团队启动会写入的配置、信任记录、钩子和项目指导文件,并说明活动钩子不含提示文本或工具参数,且区分 Claude 收集的上下文元数据;这支持数据流透明度和基本敏感数据边界。SKILL 要求改机和启动前告知并取得同意,已有同一启动的同意可复用。扣分原因:kernel 默认权限很宽,且 workshop 可广泛访问;依赖安全没有提供足以评估依赖审计或缓解措施的材料;文档明确不保证备份或回滚。发布者身份未核验,因此只按仓库中的作者与贡献渠道说明有限认可来源。
README、快速入门和设置参考对先决条件、启动就绪状态、部分启动、权限提示、超时检查和恢复命令给出具体说明,失败指引较充分。扣分原因:这些材料中有已发布版本、当前源码和不同路径的说明,且若干文档承认地图可能过时或能力尚未实现;依赖(Node、tmux、Claude Code/Codex)有明确要求,但可用性仍取决于本机安装、登录和权限。
文档覆盖首次安装、单一或多个 provider、不同团队规模、已安装升级、WSL2 和无图形 SSH 等情形,并区分 kernel、团队与集成作者的能力和责任,也清楚标注草案和未支持接口。扣分原因:rigs 技能触发范围较宽,提及 OpenRig 或 rig 命令即可能触发;环境支持主要集中于 macOS/Linux 与 WSL2,且 Node 版本存在具体限制。
README 提供清晰入口,参考文档、技能和命令示例相互指引;安装、FAQ/Q&A、限制、许可证及版本发布信息均有覆盖。开发技能标明地图可能过时且以代码为准;集成作者合同也区分已实现、草案和不支持事项。扣分原因:命名和兼容性随 harness、provider、seat 等概念而复杂;版本信息出现在多个位置,样本不足以证明单一一致的更新责任机制。维护说明列有贡献渠道和响应目标,但发布者身份未核验,也没有证据显示实际履行情况。
产品把多 harness agent 组织为持久团队,提供角色、共享上下文、任务队列、operator 和 TUI;示例能导向可执行的安装、启动、派工和恢复步骤,协调层相对单独终端会带来明确增益。扣分原因:安装和运行涉及全局 CLI、守护进程、tmux、provider 配置及多处文件写入,带来显著设置与维护成本;成本收益取决于是否确实需要持久、多 agent 协作。
多份用户文档对机器变更、数据流和权限的具体说法相互呼应;集成合同用版本和状态表标明实现边界,开发技能要求地图注明核对提交。文档通常区分已知事实、用户报告、草案和推断。扣分原因:这是有限文件样本,不能确认所有实现或文档彼此一致,也没有本次执行或独立验证证据,因此置信度为低。
- kernel 默认权限显著宽于普通团队;安装或启动前应阅读实际写入位置及所选团队权限,并确认授权范围。
- 文档不保证保留或回滚配置文件;开始前备份相关 tmux、provider 和项目配置。
- 活动钩子、Claude 上下文收集及所选 MCP 服务各有数据流;按需检查本地状态目录和外部服务配置。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v0.7.20 OpenRig 0.7.20
发布说明摘录
OpenRig 0.7.20 tells a person's own agent the consent rules first and where a handed-over task's result is, holds automatic delivery while a seat's tmux server is gone, and, when a parked row's wake is refused at a Claude seat's usage limit, retries it at the stated reset. It also lets a workflow instance stay on one pod, adds an opt-in Claude status-line throttle, and fixes a run of smaller CLI, TUI, scope and workflow problems. Before you upgrade …在 GitHub 查看 ↗ -
v0.7.19 OpenRig 0.7.19
发布说明摘录
OpenRig 0.7.19 improves how a team brings permission prompts to a person, reports interrupted recovery, and starts again after a failed launch. It also adds optional Claude hook delivery, per-seat Linux memory limits, and a versioned interface for apps answering human questions. Before you upgrade Run the upgrade in the environment that owns your daemon, keeping the same OPENRIG_HOME (legacy RIGGED_HOME) if you set it. Stop the daemon, back up its database, install the patch, then restart it. Your agents keep running; do not use rig down for this upgrade. …在 GitHub 查看 ↗ -
v0.7.18 OpenRig 0.7.18
发布说明摘录
[0.7.18] OpenRig 0.7.18 can send a team's seat prompts to the conversation you handed the work over from, restore says more truthfully what it left running, and three settings can be chosen per seat: native input, Claude's auto mode and, on Linux, a task limit. Many fixes come from people using OpenRig. Before you upgrade - **Stop the daemon, back up the database, install 0.7.18, then start the daemon.** Your agents keep running through a daemon restart; don't use rig down, which ends them. Each step runs only if the one before it …在 GitHub 查看 ↗
常见问题
它需要付费订阅吗?
它会在我的机器上改哪些东西?
YOLO 模式默认开启吗?
出问题时怎么诊断?
从旧版本升级要注意什么?
OpenRig 官网是什么?
OpenRig 开源吗?
OpenRig 安全吗?
OpenRig 还在维护吗?
OpenRig 是谁开发的?
谢谢反馈,我们会据此改进页面。