OpenRig: organizar Claude Code e Codex em uma equipe de agentes com YAML

Para quem é

O OpenRig é para desenvolvedores que querem organizar vários agentes de código em uma equipe fixa: um rig envolve seus harness, a equipe de agentes é definida em YAML e sobe com um único comando. Sua capacidade mais marcante é rodar Claude Code e Codex no mesmo rig, gerenciados como um único sistema. O valor está na "equipe": em vez de cuidar de cada agente em janelas de terminal separadas, escreva os membros em um mesmo YAML e deixe um comando e verificações de prontidão unificadas cuidarem de tudo.

Antes de começar, confira o ambiente e só siga quando os quatro itens estiverem cumpridos: Node.js 22 ou 24 (22 no Apple silicon), tmux, macOS ou Linux (Windows via WSL2) e um Claude Code ou Codex com sessão iniciada. Resolva qualquer falta primeiro — só isso já evita a maioria dos erros depois. Se você só usa outros agentes, fica no Windows nativo ou usa outra versão do Node, o suporte oficial não está descrito: trate como não confirmado.

Ao contrário, três situações pedem espera: quem só opera interface gráfica e não quer escrever configuração; quem precisa rodar direto no Windows nativo (sem WSL2); e quem quer clientes além de Claude Code e Codex — a documentação oficial não cobre esses usos. Dito de outro modo: se você normalmente roda um único cliente e não precisa de inicialização unificada, a estrutura de equipe do rig traz pouco ganho.

A primeira tentativa em 3 minutos

O caminho principal recomendado é um só: instale o skill rigs no Claude Code com o comando oficial, presumindo que o ambiente da seção anterior esteja pronto. Execute no terminal:

npx skills add https://github.com/mvschwarz/openrig/tree/v0.7.0/skills/rigs --skill rigs --agent claude-code

O v0.7.0 do comando é o caminho de versão fixo indicado na página oficial: copie-o como está. Instalado o skill, escreva em YAML a definição da sua equipe de agentes; a ordem é: instalar o skill, escrever o YAML, inicializar quando preciso (rig setup) e iniciar (rig up). Oficialmente, só se diz que a equipe é definida em YAML e sobe com um comando; campos, exemplos e locais de arquivo não são fornecidos. Quanto aos detalhes de configuração, vale o que o próprio skill traz após a instalação; não escreva a configuração no chute.

Em seguida vem a inicialização. Antes de executar o rig setup, conheça os efeitos colaterais: ele adiciona um bloco OpenRig ao ~/.tmux.conf; no macOS, pode instalar o tmux via Homebrew; e, a menos que você passe --no-herdr, também instala o Herdr. Esse é o ponto de confirmação antes de executar — se não quer o Herdr, execute com --no-herdr.

Por fim, a inicialização: execute rig up; ele sobe as sessões do tmux, cada harness e os arquivos de inicialização, e roda as verificações de prontidão. Sinais de sucesso observáveis: as sessões da equipe aparecem no tmux, cada harness inicia e as verificações dão resultado item por item. Se não há sessões ou uma verificação falha, volte à lista do ambiente e confira a versão do Node e o tmux. Não se diz oficialmente se o rig up altera arquivos ou acessa a rede: não confirmado. Até aqui nenhum membro fez trabalho real; confirme primeiro uma inicialização saudável antes de entregar trabalho de verdade.

Casos de uso

Caso 1: fazer Claude Code e Codex colaborarem no mesmo time. Cenário: você usa os dois clientes e quer tê-los em um mesmo sistema gerenciado. Método: instalado o skill rigs, defina os dois harness no YAML da equipe e execute rig up. Resultado esperável: ambos sobem como um único sistema, suas sessões aparecem no tmux, as verificações dão resultado item por item e os dois membros ficam visíveis no tmux, o que facilita comparar.

Caso 2: condensar a preparação diária em um comando. Cenário: você não quer abrir o tmux na mão e subir os membros um a um todos os dias. Método: com o YAML da equipe definido, execute rig up ao começar o dia e deixe com ele as sessões do tmux, os harness, os arquivos de inicialização e as verificações. Resultado esperável: a preparação repetitiva se reduz a um comando, e o resultado das verificações diz de cara se a equipe está pronta.

Os dois casos se encadeiam bem: confirme primeiro com o caso 1 que a formação funciona e depois transforme-a na entrada fixa do dia a dia, como no caso 2. Ambos os casos param onde a documentação oficial para: como os membros dividem o trabalho após iniciar e quais tarefas executam não têm exemplo oficial; aqui nada é inventado.

Limites de uso

• Ambiente e clientes: a lista oficial se limita a Node.js 22 ou 24 (22 no Apple silicon), tmux, macOS/Linux (WSL2) e um Claude Code ou Codex com sessão iniciada; outros clientes, Windows nativo e outras versões do Node seguem sem confirmação.
• Superfície de instalação e versão: a instalação vai por npx skills add e o comando oficial fica preso a --agent claude-code; não há marketplace de plugins nem caminho equivalente para outros clientes documentado, não infira por conta própria. O caminho de instalação aponta fixado para v0.7.0 e a forma de atualizar não é descrita.
• Efeitos colaterais e ponto de confirmação: o rig setup adiciona um bloco OpenRig ao ~/.tmux.conf, pode instalar o tmux via Homebrew e instala o Herdr a menos que você passe --no-herdr; confirme antes de executar que aceita essas mudanças.
• Definição da equipe: os campos concretos do YAML, exemplos e locais de arquivo não constam da documentação oficial; não invente a configuração.
• Verificações de prontidão: quem executa é o rig up, mas o que exatamente é checado e o comportamento diante de falha não estão documentados; confie na saída do comando e não presuma repetição automática nem rollback.
• Comportamento em tarefas: o OpenRig orquestra equipes; a documentação oficial não trata de reescrever textos nem de alterar arquivos do usuário. O comportamento de arquivos, comandos e rede dos membros em execução depende do cliente escolhido; este texto não tira conclusões de segurança adicionais.
• Itens não confirmados: licença e preços, desinstalação, comportamento de saída e limpeza do rig up e o limite de membros por rig — nada disso foi encontrado na documentação oficial.