Overview
OpenRig is a sophisticated multi-agent harness designed to unify and manage AI coding assistants like Claude Code and Codex as a cohesive, persistent team. It transforms scattered terminal sessions into an organized, collaborative system, allowing you to define complex agent topologies in YAML and orchestrate them with a single command.
Key Features
- Unified Agent Management: Run Claude Code and Codex together seamlessly within a single, managed system.
- Declarative Rig Definition: Define your agent team's structure, roles, and communication pathways using YAML (RigSpec).
- One-Command Orchestration: Boot entire agent rigs, including tmux sessions, harnesses, and readiness checks, with
rig up. - Persistent Workspaces: Maintain continuity and context for your agent teams, even across reboots, with snapshot and restore capabilities.
- Interactive TUI: Visualize your agent team's topology in graph and table views, inspect individual seats, and monitor system health.
- Flexible Communication: Facilitate communication between agents and with users via
rig send,rig broadcast, and chatrooms. - Agent-Adopted Runtimes: Discover and integrate existing Claude Code and Codex sessions into your managed rigs.
- Service-Backed Rigs: Package and manage actual software, like HashiCorp Vault, alongside your AI agents.
Typical Use Cases
- Automated Development Workflows: Define specialized roles for agents (e.g., owner, checker, reviewer) to implement and verify code changes within your repository.
- Complex Project Squads: Deploy multi-agent teams for comprehensive product development, including orchestration, implementation, QA, design, and independent review.
- Research and Exploration: Utilize flexible configurations for exploratory research tasks, enabling agents to collaborate on information gathering and analysis.
- Secure Operations: Manage sensitive tools and services, such as HashiCorp Vault, through dedicated specialist agents.
- Streamlined Onboarding: Leverage starter rigs like
first-projectandconveyorfor guided first-use paths and quick setup of basic development teams.
