Repolode
Submit
mvschwarz

mvschwarz/openrig

A TypeScript CLI and terminal UI for defining, launching and running persistent teams of Claude Code and Codex agents in tmux.

View on GitHubWebsite
Stars
7,843
Forks
624
Open issues
167
Last commit
56 minutes ago

What is it?

OpenRig is an open-source harness for coordinating multiple AI coding agents. You describe a team of roles and pods in a YAML RigSpec, then boot it with a single command. Each agent runs in its own tmux session, and the team can mix Claude Code and Codex in the same rig. The project provides a local daemon, a CLI, a terminal UI and an MCP server so agents and people can inspect state, send messages and track owned work.

The main problem it addresses is terminal sprawl: many independent agent sessions with no shared structure. OpenRig keeps stable seat addresses such as dev-build@starter, so a role persists even when the conversation in it changes. It can snapshot a topology on shutdown and restore it by name, discover and adopt existing tmux sessions, and route messages between seats with rig send and rig broadcast.

OpenRig requires Node.js 22 or 24 and tmux, and runs on macOS or Linux (Windows through WSL2). Launching a rig writes provider hook and workspace trust configuration, so the documentation's setup and permission notes should be read before first use.

Key features

  • 01Defines multi-agent teams declaratively in YAML with pods, edges and continuity policies.
  • 02Runs Claude Code and Codex agents side by side, each in its own tmux session.
  • 03Snapshots a topology on shutdown and restores it by name.
  • 04Discovers existing tmux agent sessions and adopts them into a managed rig.
  • 05Provides rig send and broadcast messaging between seats, plus a terminal dashboard and an MCP server.

Use cases

  • Coordinating a builder and a reviewer agent working on one repository.
  • Keeping a long-running set of coding agents organized and recoverable after a reboot.
  • Standing up a reusable team template that can be shared as a bundle.

Topics

#multi-agent#ai-coding#claude-code#codex#tmux#cli#agent-orchestration#agent-harness#agent-skills#codex-cli

FAQ

What is openrig?
A TypeScript CLI and terminal UI for defining, launching and running persistent teams of Claude Code and Codex agents in tmux. OpenRig is an open-source harness for coordinating multiple AI coding agents. You describe a team of roles and pods in a YAML RigSpec, then boot it with a single command. Each agent runs in its own tmux session, and the team can mix Claude Code and Codex in the same rig. The project provides a local daemon, a CLI, a terminal UI and an MCP server so agents and people can inspect state, send messages and track owned work.
Is openrig free to use? What license does it have?
openrig is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
Is openrig still maintained?
Actively maintained. The last commit to openrig was on Oct 19, 2026.
What can I use openrig for?
Coordinating a builder and a reviewer agent working on one repository. Keeping a long-running set of coding agents organized and recoverable after a reboot. Standing up a reusable team template that can be shared as a bundle.
Where can I get openrig?
The source code and installation instructions are on GitHub: https://github.com/mvschwarz/openrig

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects