llms.txt
Compare with other sites' llms.txt files →# OpenRig
Self-hosted coordination for persistent teams of coding agents.
OpenRig is a command-line tool (`rig`, from the npm package `@openrig/cli`) and a local daemon that run your Claude Code and Codex agents in terminal sessions. There's no JavaScript or Python library to import; you use it from a terminal (`rig up`, `rig send`) or through an agent. Start with Get help or Help for agents.
- [Installing OpenRig as an agent](https://github.com/mvschwarz/openrig/blob/v0.7.10/skills/rigs/SKILL.md): the rigs skill covers install and the first view; add it with `npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.10/skills/rigs --skill rigs --agent claude-code` for Claude Code or `npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.10/skills/rigs --skill rigs --agent codex` for Codex
## Start here / Get help
- [Get help](https://openrig.dev/help.md)
- [Help for agents](https://openrig.dev/help/agents.md)
- [From your first pair to a team of your own](https://openrig.dev/guides/growing-your-team.md)
- [Run OpenRig across machines](https://openrig.dev/guides/multiple-machines.md)
## Pages
- [Overview](https://openrig.dev/docs.md)
- [What Is A Rig](https://openrig.dev/docs/what-is-a-rig.md)
- [Architecture](https://openrig.dev/docs/architecture.md)
- [CLI reference](https://openrig.dev/docs/cli.md)
- [MCP tools](https://openrig.dev/docs/mcp.md)
- [Configuration](https://openrig.dev/docs/configuration.md)
- [Troubleshooting](https://openrig.dev/docs/troubleshooting.md)
- [Faq](https://openrig.dev/docs/faq.md)
- [Specs Overview](https://openrig.dev/specs.md)
- [Taxonomy](https://openrig.dev/specs/taxonomy.md)
- [Arena](https://openrig.dev/arena.md)
- [Guides Overview](https://openrig.dev/guides.md)
- [Claude Vs Codex](https://openrig.dev/guides/claude-vs-codex.md)
- [Model Diversity](https://openrig.dev/guides/model-diversity.md)
- [Ha Pair](https://openrig.dev/guides/ha-pair.md)
- [Pod Vs Single](https://openrig.dev/guides/pod-vs-single.md)
- [Factory Topology](https://openrig.dev/guides/factory-topology.md)
- [Growing Organically](https://openrig.dev/guides/growing-organically.md)
- [Adversarial Review](https://openrig.dev/explore/adversarial-review.md)
- [Research Cluster](https://openrig.dev/explore/research-cluster.md)
- [Security Hardening](https://openrig.dev/explore/security-hardening.md)
- [Continuous Refactor](https://openrig.dev/explore/continuous-refactor.md)
- [Secrets Manager](https://openrig.dev/explore/secrets-manager.md)
- [Claude Managed Agents](https://openrig.dev/compare/claude-managed-agents.md)
- [Claude Agent Teams](https://openrig.dev/compare/claude-agent-teams.md)
- [Claude Subagents](https://openrig.dev/compare/claude-subagents.md)
- [Crewai](https://openrig.dev/compare/crewai.md)
- [N8n](https://openrig.dev/compare/n8n.md)
- [Openclaw](https://openrig.dev/compare/openclaw.md)
- [Paperclip](https://openrig.dev/compare/paperclip.md)
- [OpenRig](https://openrig.dev/index.md)
- [What is OpenRig](https://openrig.dev/what-is.md)
- [What's new](https://openrig.dev/whats-new.md)
- [Added: rig exec run <row> --harness claude|codex runs a queue task as one finite turn through the maintained ACP adapter, with --plan, --wait, status and cancel (a cancel is acknowledged, not settled) (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-rig-exec-run-row-harness-claude.md)
- [Added: rig seat status shows a Claude seat's latest permission request, with suggested rules labelled (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-rig-seat-status-shows-claude-seat.md)
- [Added: Spec advisories show as launch warnings and never stop a launch, and an unknown uses key gets one (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-spec-advisories-show-launch-warnings-never.md)
- [Changed: After installing 0.7.10, restart the daemon (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-run-npm-install-g-openrig-cli.md)
- [Changed: OpenRig's own plugin goes to 0.1.26: it adds a permission-request hook and changes the refocus hook (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-openrig-core-plugin-moves-0-1-25.md)
- [Changed: Run rig agent validate <path>: a single-value uses.<category> now selects that resource, so a member fails to resolve if its pool doesn't hold it (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-run-rig-agent-validate-path-single-value.md)
- [Changed: If you run an OpenShell environment, rebuild its guest image with this release's guest.py (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-openshell-users-rebuild-guest-image-release.md)
- [Changed: The rigs skill tries a user-writable npm prefix, or a version manager's Node, before a project-local install (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-rigs-skill-tries-user-writable-npm-prefix.md)
- [Changed: Under load, the execution view reads the review registry once per request, queue listings build one recovery index instead of a scan per task, and the event drain reads at most 500 rows at a time (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-execution-view-reads-review-registry-once.md)
- [Changed: The OpenShell worker still can't be cleaned up against OpenShell 0.1.6, so recreate and restore can't run yet; its guest now passes the exec's CA settings to Claude and does useful work and a verified export (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-guest-passes-exec-s-ca-settings.md)
- [Changed: OpenShell's maintained cleanup still fails against OpenShell 0.1.6 (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-owned-environment-deletes-read-podman-s-inventor.md)
- [Changed: Docs and tests: Codex named profiles, openrig-core skill loading, what the runner contract has run, telemetry's guarantee beside the separate, untested openrig-telemetry exporter, and a real-tmux test that waits for the prompt (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-docs-tests.md)
- [Changed: A held post-compaction step goes in over an unreadable input box, so an unrecognised draft may receive the restore text (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-held-post-compaction-step-goes-over-unreadable.md)
- [Changed: Sends leave any tmux mode a person has open (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-sends-leave-any-tmux-mode-person.md)
- [Changed: rig up can print advisory warnings (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-rig-up-print-advisory-warnings.md)
- [Changed: Managed Codex seats run tool commands in a non-login shell, so login- or rc-only setup, shell functions and aliases may be missing, and a model request for login: true gets Codex's refusal (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-managed-codex-seats-run-tool-commands.md)
- [Fixed: A step held after a managed compaction now goes in after two idle polls even when the input box can't be read, instead of waiting forever; rig compact <seat> --state says when that happened (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-after-two-idle-polls-t-read.md)
- [Fixed: Sends now leave any tmux mode, including one a person has open, and a refusal says why (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-delivery-leaves-every-tmux-mode-refusal.md)
- [Fixed: A stale record naming a reused tmux pane no longer stops a send from leaving the mode (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-stale-record-naming-reused-tmux-pane.md)
- [Fixed: Writable views size the pane they show (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-writable-views-size-pane-show.md)
- [Fixed: Herdr views kept from 0.7.5 to 0.7.9 keep working after upgrading (Linux Herdr 0.9.5): a kept viewer stays confirmed and a follow view goes on adding tiles (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-herdr-views-kept-0-7-5.md)
- [Fixed: Routing and status: a send to this host's own ID stays local, rig broadcast says UNCONFIRMED instead of FAILED for an uncertain recipient, refusals for seats handed over before 0.7.9 say why, rig roster reads conflicting activity as unknown, and set-runtime finds pod recaps (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-routing-status-send-seat-rig-host.md)
- [Fixed: Refocus names a gap in its trace instead of failing (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-refocus-names-trace-gap-instead-failing.md)
- [Fixed: The stuck sweep stops filing informational updates to people as unclaimed work (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-stuck-sweep-stops-filing-informational-updates.md)
- [Fixed: rig slack status counts cross-host relays still in flight (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-rig-slack-status-counts-cross-host-relays.md)
- [Fixed: Plain rig works in managed Codex seats however OpenRig was installed, with a Codex that supports allow_login_shell, because tool commands now run in a non-login shell, so login-only shell setup may be missing (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-plain-rig-works-managed-codex-seats.md)
- [Fixed: Clearer errors: a refused terminal token says "Terminal auth failed", the TUI shows the daemon's launch refusal, and rig doctor gives up on a silent listener after 2 seconds (OpenRig 0.7.10)](https://openrig.dev/whats-new/v0-7-10-errors-clearer-refused-terminal-token-says.md)
- [Added: A person's typed words on a runner seat's permission ask now count: a plain yes or no answers it; any other words choose nothing, so OpenRig's default permits the request when the agent offered an allow option, and a runner can pass the words to the agent after its turn, never as the answer (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-person-s-typed-words-reach-agent.md)
- [Added: Each permit OpenRig grants a runner by default is now recorded, once, as a stream item: read them with rig stream list --tag runner-permission-permit (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-each-permit-openrig-grants-default-recorded.md)
- [Added: A working beat keeps a runner's long, quiet turn reading working, and the conformance check no longer falsely fails a correct runner on a busy machine (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-working-beat-keeps-long-quiet-turn.md)
- [Added: Experimental and unsupported (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-experimental-unsupported.md)
- [Added: New daemon reads let a client list people and the default person, read a person's open updates without Slack, and read a rig's messages in one request (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-new-daemon-reads-two-dajiaohuang-people.md)
- [Added: Options and views: specs.builtins_visible: false hides built-in specs, a Claude member's plugin_channels pass to --channels (not yet run with a real channel plugin), and rig context add <url> installs into a new nested name (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-options-views-specs-builtins-visible-false.md)
- [Changed: After installing 0.7.9, restart the daemon: four database updates run on its first start (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-restart-daemon-after-installing-run-npm.md)
- [Changed: Stream intake is on by default: each rig stream emit opens a row for the kernel's queue worker (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-stream-intake-default.md)
- [Changed: OpenRig's own plugin goes to 0.1.25 and keeps a copy of each file it replaces (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-bundled-openrig-core-plugin-advances-0-1.md)
- [Changed: If you run an OpenShell environment, rebuild its guest image with this release's helper (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-if-run-openshell-environment-rebuild-guest.md)
- [Changed: The OpenShell worker still doesn't work in 0.7.9: in release testing it couldn't reach its model, and deleting an owned environment didn't run (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-openshell-worker-still-doesn-t-work.md)
- [Changed: Stream intake is on by default; rig config set stream.intake off keeps 0.7.8's behaviour (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-stream-intake-default-see-before-upgrade.md)
- [Changed: Fresh Pi seats, and fresh Codex seats on 0.164.0 or later, get OpenRig's guidance outside your repository's AGENTS.md (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-fresh-pi-seats-fresh-codex-seats.md)
- [Changed: rig down removes OpenRig's own additions from a working folder once no live seat uses them (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-rig-down-removes-openrig-s-own.md)
- [Changed: After upgrading, the Slack connector marks asks that ended earlier as handled, at Slack's edit rate: about an hour for 450 asks (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-after-upgrading-slack-connector-edits-asks.md)
- [Changed: A later answer to a settled ask gets 409 qitem_already_terminal and records nothing (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-later-answer-settled-ask-gets-409.md)
- [Changed: rig send --verify reports unconfirmed and exits 1 when it can't see what its Enter did (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-rig-send-verify-reports-unconfirmed-exits.md)
- [Changed: rig export with no -o writes rig-export.yaml beside an existing rig.yaml instead of replacing it (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-rig-export-o-writes-rig-export-yaml.md)
- [Changed: rig workspace validate exits 1 for malformed optional frontmatter (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-rig-workspace-validate-exits-1-malformed.md)
- [Changed: When an active rig name matches more than one rig, rig env lists the matching rig IDs and stops, and rig doctor --spec reports unknown, instead of using the first match (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-active-rig-name-matches-more-one.md)
- [Changed: New default kernels start in <workspace.root>/kernel; existing kernels stay where they are (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-new-default-kernels-start-workspace-root.md)
- [Fixed: Delivery: fewer messages are held or misdirected on Claude seats, held messages are announced when a seat starts, undelivered reminders retry, and a stalled tmux client ends after 30 seconds (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-delivery-fewer-deliveries-held-misdirected-claud.md)
- [Fixed: Status: idle Claude and busy Codex seats read correctly in more layouts, an unreadable pane reads unknown rather than its last verdict, and uncertain sends read unconfirmed (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-status-receipts-idle-claude-busy-codex.md)
- [Fixed: Guidance and handover: an edited culture or startup file reaches the next start, shared CLAUDE.md and AGENTS.md files stop growing, and several Claude rebuild and resume failures are repaired (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-guidance-handover-edited-culture-startup-file.md)
- [Fixed: Asks: in a shared workspace, any registered person can settle another's ask and the first answer wins, and Slack records a click on a re-parked ask (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-asks-shared-workspace-any-registered-person.md)
- [Fixed: Install and hosts: preflight warns when a Codex seat's login shell can't find rig, rig doctor no longer hangs on a silent port, and upgrade backups work without the sqlite3 CLI (OpenRig 0.7.9)](https://openrig.dev/whats-new/v0-7-9-install-hosts-upgrade-skill-backs-up.md)
- [Added: A runner seat's permission requests now reach a person: the default person gets an ordinary ask in the Feed and on Slack, with no setup (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-runner-seat-s-permission-requests-reach.md)
- [Added: A conformance check tests a runner's answered path (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-runner-conformance-check-node-docs-reference.md)
- [Added: An example runner for DeepSeek Harness (dsh) comes with its preset to build against (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-example-runner-deepseek-harness-dsh-preset.md)
- [Added: A seat activity grant lets a runner outside the host's hook setup report activity for one seat, without the install-wide hook token (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-seat-activity-grant-lets-runner-outside.md)
- [Added: The NVIDIA OpenShell sandbox reference isn't usable in 0.7.8: in release testing its Claude worker never connected, so no work ran (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-0-7-8-includes-rig-environment.md)
- [Added: Seats: each OpenRig home can have its own tmux server, a Claude member can opt out of MCP, and rig launch --seats first-starts seats; skill copies, activity hooks and startup declarations are kept across rig down, resumes and exports; and stops are clearer (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-seats-isolated-tmux-server-per-openrig.md)
- [Added: Hosts: rig host edit and rig host remove arrive, OpenRig warns when another user's daemon holds the port, and rig daemon status shows a pending start (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-hosts-setup-rig-host-edit-rig.md)
- [Changed: After installing 0.7.8, restart the daemon: four database updates store new seat settings, among them a Claude seat's MCP opt-out and who answers a seat's permission requests (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-restart-daemon-after-installing-run-npm.md)
- [Changed: OpenRig's own plugin goes to 0.1.24 and keeps a copy of each file it replaces (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-bundled-openrig-core-plugin-advances-0-1.md)
- [Changed: The install is larger because the MCP SDK is now needed at runtime, so a clean install runs (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-install-larger-0-7-8-installs.md)
- [Changed: A runner that follows section 7 of the runner contract now gets answers or permits instead of refusals; --deny keeps a seat refusing (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-runner-following-section-7-gets-answers.md)
- [Changed: On tmux older than 3.7c, OPENRIG_TMUX_CONTROL=1 uses spawned clients instead of a control client (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-tmux-older-3-7c-openrig-tmux.md)
- [Fixed: tmux: no crash with OPENRIG_TMUX_CONTROL=1 when control clients end together, and a submit key a read-only client blocks is pasted instead (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-tmux-openrig-tmux-control-1-crash.md)
- [Fixed: Wakes: reminders stop at a full quota, escalations stay deliverable with no person to reach, OpenRig's own Codex hooks are trusted when no choice is recorded, and refusals name their fix (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-wakes-openrig-wake-suspend-matches-destinations.md)
- [Fixed: Slack: a typed reply to a parked decision is recorded as the answer, row bodies render Markdown, and resolved decisions stop showing as live asks (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-slack-usage-typed-replies-parked-decisions.md)
- [Fixed: TUI: agent pages show health and recent work, pod, spec and instance-table views read correctly, and rig terminal open mission:<id> --follow --provider herdr follows a mission (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-tui-views-agent-pages-show-health.md)
- [Fixed: Also: MCP text is cut between whole characters, an ACP cancel survives a failed note, long transcript lines read faster, and Pi and the kernel dashboard get recovery guides (OpenRig 0.7.8)](https://openrig.dev/whats-new/v0-7-8-also-mcp-text-cut-between-whole.md)
- [Changed: After installing 0.7.7, restart the daemon so the fixes take effect (OpenRig 0.7.7)](https://openrig.dev/whats-new/v0-7-7-restart-daemon-after-installing-fixes-take.md)
- [Fixed: A Claude agent at an empty prompt under Claude's 'Update installed' line reads idle again, so managed compaction no longer waits on it (OpenRig 0.7.7)