Claude와 Codex를 함께 관리하는 멀티에이전트 시스템 OpenRig

핵심 요약

• OpenRig는 YAML로 정의된 에이전트 팀 토폴로지를 `rig up` 하나의 명령으로 부팅하는 오픈소스 다중에이전트 하네스로, Claude Code와 Codex를 동일 시스템으로 통합 관리한다.
• tmux 세션을 기반으로 로컬 데몬·CLI·터미널 UI·MCP 서버로 구성되며, 에이전트들이 각자 터미널 세션에서 독립 실행되면서도 팀 협조를 중앙에서 조율한다.
• RigSpec 정의로 pods·edges·지속성 정책을 선언하고, Seat(역할 기반 주소)와 Pod(공유 지침과 컨텍스트)를 통해 에이전트 간 안정적 관계를 유지한다.
• `rig discover`와 `rig adopt`로 기존 tmux 세션을 자동 감지·관리 대상으로 전환하고, `rig down --snapshot`과 `rig up `으로 토폴로지 상태를 저장·복구할 수 있다.
• `rig send`·`rig broadcast`·`rig chatroom`으로 에이전트 간 통신하고, `rig grow`·`rig shrink` 등으로 실시간 토폴로지 변경이 가능하다.
• Node.js 20/22/24와 tmux 필수, 선택적으로 herdr·cmux(에이전트 터미널 통합 표시)와 Docker(서비스 기반 리그용) 요구한다.
• TUI의 토폴로지 탐색기·테이블·그래프 뷰로 리그·팀원 상태를 실시간 확인하고, MCP 도구(rig_up·rig_ps·rig_send 등)로 에이전트가 자신의 토폴로지를 직접 관리할 수 있다.
• `rig setup`은 tmux·cmux·Claude Code·Codex 초기화, `rig setup --full`은 jq·gh 등 확장 준비를 자동화하며, `rig doctor`로 설정 후 시스템 상태를 진단한다.
• setup 과정에서 ~/.claude.json·~/.codex/config.toml에 워크스페이스 신뢰 설정·후크 구성을 기록하고, ~/ .openrig/에 데몬 상태·데이터베이스·플러그인 자원을 저장한다.
• 실행 중인 에이전트 세션이 Claude 문맥 수집기와 provider 사용량 통계를 daemon에 보고하며, OPENRIG_YOLO(기본값 off)로 권한 모드를 명시적으로 활성화한다.
• first-project(2석 입문)·product-team(6석 대규모 팀)·conveyor(4석 handoff 흐름)·adversarial-review·research-team·secrets-manager(Vault 자동화) 등 사전구성 리그 템플릿을 제공한다.
• 0.5.9 이후 버전에서 context 라이브러리 구조 변경 시 openrig-upgrade 스킬의 에이전트 기반 마이그레이션으로 레거시 호환을 유지하며, 모든 phase는 JSON 출력으로 자동화 워크플로우를 지원한다.