# OpenRig — Claude Code and Codex agents run as one team from YAML

> A control plane that turns a pile of coding-agent terminals into a named, persistent team.

- Org: OpenRig
- Date: 2026-09-27
- Category: tool, repo
- Source: https://github.com/mvschwarz/openrig
- Canonical page: https://ai-tldr.dev/releases/mvschwarz-openrig/

## In short

OpenRig is an open-source harness that runs Claude Code and Codex sessions as one team: a YAML file defines the seats, rig up starts them in tmux, and agents message each other. It gained 781 GitHub stars in a day.

## What it is

OpenRig coordinates several AI coding agents, currently Claude Code, Codex, plain terminal nodes and a Pi adapter, as one system. A YAML RigSpec describes the team as pods of seats with edges between them, and starter rigs such as first-project, product-team, adversarial-review and research-team come included. Version 0.5.17, released on 27 September, lets you install it with Bun as well as npm.

## How it works

The rig up command boots each seat in its own tmux session, writes its startup files and waits for readiness checks. A Hono HTTP daemon with SQLite keeps the state, and a CLI, a TUI with a topology graph, and an MCP server sit on top. Agents talk through rig send, rig broadcast and rig chatroom, and rig grow and rig shrink change the team while it runs; snapshots save and restore a whole topology.

## Why it matters

Running Claude Code and Codex side by side usually means juggling terminals by hand. OpenRig makes the team setup a file you can version and share, and it can adopt sessions you already started in tmux. It runs on macOS and Linux with Node.js 20, 22 or 24; it also edits Claude Code and Codex trust settings, which the README lists up front.

## Who it's for

developers running several coding agents at once

## Try it

npm install -g @openrig/cli && rig setup --dry-run

## Links

- [Repository](https://github.com/mvschwarz/openrig)
- [v0.5.17 Release](https://github.com/mvschwarz/openrig/releases/tag/v0.5.17)
- [All Releases](https://github.com/mvschwarz/openrig/releases)
