TL;DR

OpenRig 是一个本地多 Agent 编排框架，通过 YAML 声明式定义将 Claude Code 和 Codex CLI 整合为统一的“团队”系统。它解决了多终端会话管理混乱的问题，提供持久化状态、拓扑可视化和 Agent 间通信机制。

它解决什么问题

随着 Claude Code、Codex CLI 等本地 AI 编程工具普及，开发者常面临“终端 sprawl”（会话碎片化）困境：多个 Agent 独立运行，上下文隔离，缺乏协调机制。OpenRig 的出现旨在将这些孤立工具转化为可管理的“团队”，通过统一的状态管理和通信总线，实现多 Agent 协作、任务分发和结果审查。

核心做法

架构上采用 Daemon + CLI + TUI (Terminal UI) + MCP Server 模式，底层依赖 tmux 管理终端会话。 - RigSpec: YAML 定义拓扑结构，包含 Pods（组）、Seats（角色/会话）和 Edges（通信路径）。 - Seat 管理: 每个 Agent 实例化为一个 Seat，拥有稳定身份（如 dev-owner@project），支持快照/恢复和动态扩缩容。 - 通信机制: 通过 rig send、rig broadcast 实现 Agent 间消息传递，底层利用 tmux pane/session 隔离与共享目录。 - 状态持久化: SQLite 存储实例状态、上下文使用数据和拓扑信息，支持 rig down --snapshot 保存完整环境。

作者

Owner mvschwarz (Twitter: @_feralmachine)，个人开发者。README 未提及所属公司或团队背景，项目由个人维护，但拥有独立的官网、文档站和 YouTube 频道，显示出较高的专业度和持续投入意愿。

社区反应

Stars: ~1,043 | Forks: 106 | Open Issues: 51 作为 TypeScript 项目，在 AI Agent 工具链中属于中等热度。Issues 数量较多（51个），结合其“本地基础设施”属性，可能包含大量环境配置、tmux 兼容性和权限设置问题。npm weekly downloads 显示有一定活跃度，但尚未进入主流大规模生产环境。

怎么上手

  1. 依赖: Node.js (20/22/24), tmux, 已认证的 Claude Code 和 Codex CLI。
  2. 安装: npm install -g @openrig/cli
  3. 初始化: bash rig setup --dry-run # 预览变更，包括 tmux.conf、Claude/Codex trust settings rig setup # 应用配置
  4. 启动示例: bash rig up first-project --cwd . rig tui --shared # 打开拓扑视图
  5. 交互: rig send dev-owner@first-project 'Implement X...'

争议与局限

  • 侵入性强: rig setup 和运行时直接修改 ~/.tmux.conf, ~/.claude.json, Codex config.toml 等文件，写入 trust hooks 和权限设置。用户需备份配置，存在潜在冲突风险。
  • 本地依赖重: 强绑定 tmux，不支持纯 GUI 或远程无终端环境。herdr/cmux 为可选增强。
  • 权限模型: 默认非 YOLO，但需显式配置 acceptEdits 等权限。Agent Managed Software（如 Vault）需要 Docker。
  • 推断: 目前仅支持 Claude Code 和 Codex CLI，未提及对其他 LLM Agent（如 Cursor, Windsurf）的原生支持。

相关项目

  • CrewAI — Python 生态的多 Agent 框架，侧重任务编排逻辑而非本地终端会话管理。
  • AutoGen — Microsoft 开源的多 Agent 对话框架，支持自定义 Agent 类型和群聊模式。
  • LangGraph — LangChain 出品的状态机式 Agent 编排库，适合复杂工作流而非本地终端集成。
  • Aider — 专注于单 Agent 代码编辑的 CLI 工具，无多 Agent 协作能力。
  • Claude Code — Anthropic 官方 CLI，OpenRig 的核心组件之一，但本身不具备多 Agent 编排功能。