Free guide · Oct 5, 2026
OpenRig: run Claude Code and Codex as one team
A step-by-step setup guide with requirements, checks and common problems.
The short version
OpenRig is a free, open source tool that runs AI coding agents as a team instead of a pile of terminal windows. You describe the team in a YAML file, start it with one command, and watch every agent from a terminal dashboard. Claude Code and Codex can sit in the same team.
•What you need: a Mac or Linux computer, Node.js 22 or 24, tmux, and a working Claude Code or Codex login (or both).
•What you get: a two-agent starter team in your own repo. One agent owns the task, the other checks the exact result, and you don't relay messages between terminals.
•Before you run it: OpenRig writes hooks and trust settings into your Claude Code and Codex config. Read the "What it changes" section below and back those files up first.
What's in the full guide
- 01Pick your starter team
- 02Check your machine first
- 03What it changes on your machine
- 04Step 1: Install and preview
- 05Step 2: Launch your first team in your repo
- 06Step 3: Open the dashboard
- 07Step 4: Give the owner one real task
- 08Honest limits
- 09Where to go next