OpenRig, Claude Code와 Codex 위한 오픈소스 멀티 에이전트 오케스트레이터 공개

개요 및 핵심 개념

OpenRig는 Claude Code와 Codex 같은 AI 코딩 에이전트를 팀으로 관리하는 오픈소스 멀티 에이전트 오케스트레이터다. 하네스가 모델을 감싸듯, 리그는 하네스를 감싼다는 원칙으로 동작한다. 사용자는 YAML 사양(RigSpec)으로 에이전트 팀을 정의하고 단일 명령어로 실행하여 터미널 세션을 지속적이고 조직화된 단위로 변환한다. Lead agent가 팀 전체의 결과와 의사결정을 조율한다.

아키텍처 및 설치

시스템은 tmux 기반의 로컬 데몬, CLI, 터미널 UI(TUI), MCP 서버로 구성된다. Node.js 22 또는 24가 필요하며(v0.6.0부터 SQLite 바인딩 요구사항으로 Node 20 미지원), tmux가 필수다. macOS 또는 Linux에서 실행되며 네이티브 Windows는 지원되지 않는다. 설치는 npm install -g @openrig/cli 또는 bun add -g @openrig/cli로 수행한다.

주요 구성 요소:

• CLI: 팀 실행, 상태 확인, 메시지 전송 명령 제공
• TUI: 리그, 포드, 시트를 테이블 또는 그래프 뷰로 보여주는 토폴로지 탐색기
• MCP 서버: 에이전트가 자체 토폴로지를 관리할 수 있는 도구(rig_up, rig_send 등) 제공
• 런타임: RPC 러너를 통한 Claude Code, Codex, Pi/Oh My Pi용 네이티브 어댑터

워크플로우 및 기능

OpenRig는 코딩 에이전트가 형성하는 시스템(세션 관계, 재부팅 복구, 터미널 정리)을 관리한다. 에이전트의 내부 로직은 관리하지 않으며 상호작용만 오케스트레이션한다.

• 정의: YAML로 포드, 엣지, 연속성 정책 정의
• 실행 및 확인: rig up으로 tmux 세션과 하네스 실행, TUI에서 토폴로지와 상태 표시
• 통신: rig send, rig broadcast, rig chatroom으로 에이전트 간 통신
• 스냅샷 및 복원: rig down --snapshot으로 전체 상태 캡처, rig up <name>으로 복원
• 에이전트 관리 소프트웨어: 전문 에이전트가 운영할 HashiCorp Vault 인스턴스 같은 실제 소프트웨어 패키징 및 관리 가능(Docker 필요)

보안 및 권한

세분화된 권한 제어 기능을 제공한다. 설정 시 에이전트가 rig 명령을 반복 승인 없이 실행하도록 허용할 수 있다. 시스템은 신뢰 설정, 실행 가능한 훅, 프로바이더 통합을 위해 로컬 파일을 수정한다. Claude Code의 경우 ~/.claude.json과 워크스페이스 설정을 관리하고, Codex의 경우 ~/.codex/config.toml을 구성하며 신뢰 해시를 사전 작성한다. 활동 릴레이는 이벤트 메타데이터를 데몬으로 전송하지만 프롬프트 텍스트와 도구 인자는 제외하여 프라이버시를 보호한다.

커뮤니티 및 상태

프로젝트는 GitHub(mvschwarz/openrig)에서 호스팅되며 5.2k 스타와 387 포크를 기록했다. Apache 2.0 라이선스를 적용한다. 저자는 이를 "AI 문명 실험"의 일부로 설명하며, 멀티 에이전트 워크플로우를 시연하기 위해 product-team과 conveyor 같은 스타터 리그를 제공한다.