OpenRig: Running Claude Code and Codex as One Agent Team
By Matt Cullerton, founder of Mavric and Apso
OpenRig is an open-source command-line tool that defines a team of coding agents in YAML and launches them in your repository with one command, with Claude Code and Codex seats running side by side under tmux. A TikTok from @reporadarai says it "launches a two-agent team in your repository to drive one reviewed change," and that claim matches the project's docs. The video's star and download numbers went stale within days, and it scrolls past the section that matters most: the trust settings and hooks the install writes to your machine.
What is OpenRig?
The project is github.com/mvschwarz/openrig, a TypeScript project under the Apache-2.0 license by Mike Schwarz, created on 2026-04-01. Its README tagline: "A harness wraps a model. A rig wraps your harnesses. Define your agent team in YAML, boot it with one command. Claude Code and Codex in the same rig, managed as one system."
The YAML format is called RigSpec. It declares pods, members, edges and continuity policies. A separate AgentSpec holds reusable agent blueprints, and a CULTURE.md file sets coordination norms. Seats work as addresses: dev-owner@first-project stays the same while the conversation in it changes.
How do you install OpenRig?
The README gives:
npm install -g @openrig/cli
rig setup --dry-run
You need Node.js 22 or 24, tmux, and macOS or Linux. Native Windows is not supported and WSL2 is untested. Since version 0.6.0 the install check refuses Node 20. The npm package @openrig/cli was first published on 2026-04-06 and has 54 versions.
To preview and start a starter team, the README runs rig specs preview, rig up "$starter" --cwd . --plan and rig tui --shared.
What does the two-agent starter do?
The getting-started guide says the two seats are an outcome owner and an independent checker. There are three starter rigs:
- first-project runs both seats on Codex, pinned to
gpt-6-astra. - first-project-claude runs both seats on Claude Code at its default model.
- first-project-mixed pairs a Claude owner with a Codex checker.
The models in the README's demo recording are real. fable-5-1 is Anthropic's Claude Fable 5.1, announced on 2026-09-01. gpt-6-astra is an OpenAI model listed on OpenRouter.
The README also has an Agent-Managed Software section about packaging software beside the agents that run it. Its example, secrets-manager, is a HashiCorp Vault instance run by a specialist agent, and it requires Docker. I did not install or run OpenRig, so I cannot say how well the starter performs on a real repository.
Can OpenRig recover agents after a reboot?
Yes. rig down --snapshot saves the topology, and rig up <name> restores from the latest snapshot. Restore reports each seat as resumed, fresh or failed. After a reboot, the guide says to open rig, start the daemon if needed, and select the existing rig. Resume is the default.
Two caveats apply. The README's own demo, playing under the video's "organized and recoverable" caption, shows one seat failed, four in an unknown state, and a health line reading "canonical health records could not be read." The README also says sessions you adopt while they are already running may need a restart to pick up new runtime config.
What does OpenRig change on your machine?
The README has a table titled "What OpenRig changes on your machine," and the video scrolls past it without comment. The changes include:
- An OpenRig block written into
~/.tmux.conf. - On macOS, an optional cmux install that switches
automation.socketControlModefromcmuxOnlytoautomation. - A skill seeded into
~/.claude/skillsand~/.agents/skills, plus Codex hook configuration and trust records, all written when the daemon starts. - Managed launches that pre-trust the workspace, run Claude with
--permission-mode acceptEdits, and run Codex with-s workspace-write.
The README says these include "trust settings and executable hooks" and tells you to back up the affected files first. Full-bypass modes are off by default. Activity relays send event type, seat identity, timestamps and session identity to the local daemon, and exclude prompt text and tool arguments.
How popular is OpenRig?
The video shows 2,437 stars, 2.5k weekly downloads and version 0.6.1. On 2026-10-03 the repo had 4,645 stars and 321 forks, weekly downloads read 4.6k, and v0.6.4 had shipped on 2026-10-02. npm dates v0.6.1 to 2026-09-29, so the screen capture came from the last days of September.
OpenRig vs claude-squad
Running several terminal coding agents under tmux is not new. claude-squad, which manages Claude Code, Codex, OpenCode and Amp sessions, was created on 2025-03-09 and has 8,565 stars. OpenRig adds a declarative YAML topology, stable seat addresses, snapshot and restore, rig discover and rig adopt for bringing existing tmux sessions under management, and Claude Code and Codex seats working as peers in one rig.
Bottom line
OpenRig does what the video says: it starts an owner agent and a checker agent in your repo from a YAML definition, with Claude Code, Codex or both. Read the "What OpenRig changes on your machine" table and back up your tmux, Claude and Codex config before installing.
Sources
- mvschwarz/openrig on GitHub - repo, license and star count.
- OpenRig README - RigSpec, snapshots and the machine changes table.
- OpenRig getting-started guide - owner and checker seats and starter rigs.
- @openrig/cli on npm - versions and Node requirement.
- OpenRig vs Claude managed agents - the local daemon, SQLite and tmux architecture.
- Claude Fable 5.1 - the model in the demo.
- GPT-6 Astra on OpenRouter - the OpenAI model slug.
- smtg-ai/claude-squad - earlier tmux-based agent manager.
Published October 3, 2026. Based on a TikTok by @reporadarai. Full video notes (markdown)