openrig is a self-hosted application that organizes AI coding agents into a persistent team coordinated by a lead agent, with team topologies defined in YAML and started with one command. It supports running Claude Code and Codex agents in the same rig and provides a terminal UI for viewing the running topology.
Project overview
It addresses a concrete workflow gap: AI coding agents scattered across terminal sessions lack shared structure and coordinated context, and openrig manages Claude Code and Codex harnesses together as one system with YAML-defined pods, edges and continuity policies.
Project type
AI Agent · AI Coding
Use cases
Coding & Development · Automation
Deployment
Refer to project documentation
License
Apache-2.0
Best for
Developers who already use Claude Code or Codex and want multiple coding agents organized into a persistent, YAML-defined team coordinated by a lead agent.
Key capabilities
Define agent team topologies in YAML (RigSpec) with pods, edges and continuity policies, and boot tmux sessions, harnesses and startup files with 'rig up'.
View rigs, pods and seats in a TUI topology table and graph, and inspect projects, specs, feeds and instance health.
Limitations and risks
Native Windows is not supported; WSL2 is the Windows route.
A signed-in Claude Code or Codex account is required as the agent harness provider; openrig orchestrates these harnesses rather than replacing them.
Coding ability is required, and the tool is driven through the CLI with YAML-defined specs, so it presumes developer-level setup and operation.
Getting started
Setup difficulty is documented as medium and requires coding ability; users write YAML RigSpec files and use the CLI to boot and inspect rigs.
Evidence and sources
README: It turns AI coding agents from a pile of terminal sessions into a persistent, organized team.
README: - **Define** topologies in YAML (RigSpec) with pods, edges, and continuity policies - **Boot** everything with `rig up` — tmux sessions, harnesses, startup files, readiness checks
README: First check that `node --version` shows 22 or 24: the command below needs Node.js and the `npx` that comes with it.
README: rig send dev-build@starter 'Implement <one useful change>. Track the task in the queue and return its ID.
README: You need Node.js 22 or 24 (22 on Apple silicon), tmux, macOS or Linux (WSL2 on Windows), and Claude Code or Codex signed in.