Codex CLI

O Codex CLI se conecta ao seu espaço de trabalho do Pathrule pelo Pathrule CLI ou pela extensão do VS Code. A integração tem três partes: os hooks nativos do Codex, um arquivo AGENTS.md complementar na raiz do espaço de trabalho e a mesma superfície de ferramentas MCP que os outros clientes usam. Junto com o Claude Code, o Codex é um dos dois clientes que o Pathrule alcança com um hook de envio de prompt.

Esta página mostra o que é gravado no seu projeto para a integração, como ela se diferencia dos fluxos do Claude Code e do Cursor e como verificar se tudo está funcionando.

O que o Pathrule grava

Quando você instala o Pathrule no Codex CLI, você recebe:

• Uma entrada de servidor MCP em ~/.codex/config.toml, para que o assistente possa chamar as ferramentas pathrule_*. Os outros servidores desse arquivo continuam como estão.
• .codex/hooks.json no projeto. São os registros de hooks, mesclados de modo que qualquer hook que você mesmo tenha adicionado seja mantido.
• Um bloco marcado no .codex/config.toml do projeto que ativa os hooks do Codex. O restante desse arquivo é seu e não é alterado.
• AGENTS.md na raiz do espaço de trabalho. Com o hook instalado, a parte do Pathrule nesse arquivo é uma nota curta informando que o Pathrule está ativo e é entregue pelo hook.
• Skills materializadas em .agents/skills/<name>/SKILL.md, para que o Codex possa invocá-las pelo nome.

AGENTS.md é o equivalente do CLAUDE.md no Codex. Quando o hook do Codex está instalado, o protocolo chega pelo hook SessionStart em vez do arquivo, e o conhecimento dos caminhos chega pelos hooks de prompt e de ferramenta. Assim, nenhuma cópia do protocolo nem arquivo de conhecimento é gravado na sua árvore. Sem o hook, o AGENTS.md traz o protocolo completo e a visão geral do espaço de trabalho, e o Pathrule adiciona um AGENTS.md em cada diretório que tem conhecimento associado, que o Codex carrega quando o trabalho entra nesse diretório.

Cobertura de hooks

O contrato de hooks do Codex é parecido com o do Claude Code. O Pathrule registra hooks de início de sessão, envio de prompt, antes da ferramenta, depois da ferramenta e parada:

• Início de sessão entrega os metadados do espaço de trabalho, o protocolo e o contexto da sua equipe uma vez por sessão.
• Envio de prompt delimita o turno com as regras e memórias adequadas ao prompt, trazendo as memórias mais relevantes com o conteúdo completo.
• Antes da ferramenta adiciona os nomes do que se aplica ao caminho afetado pelo patch ou comando e verifica as regras que têm um padrão de bloqueio aprovado antes que o patch seja aplicado.
• Depois da ferramenta registra o resultado.
• Parada permite que uma verificação obrigatória aprovada mantenha o turno aberto até que o comando dela tenha passado.

As principais diferenças em relação ao Claude Code estão na superfície de ferramentas: o Codex usa o formato apply_patch (com marcadores *** Update File:) em vez de ferramentas Edit e Write separadas, e não existe hook de Read. O script de hook compartilhado do Pathrule entende o apply_patch, associa os caminhos afetados aos nós do espaço de trabalho e trata um patch como uma edição. Com isso, uma regra com padrão de bloqueio aprovado impede um patch correspondente antes que ele seja aplicado. Um padrão de bloqueio proposto por um assistente só passa a valer depois que uma pessoa o aprova.

O investimento fica na camada de conteúdo, não no cliente, então as mesmas memórias, regras e skills atendem o Codex e todos os outros clientes.

Isolamento por cliente

O Codex convive com o Claude Code e o Cursor na mesma máquina. Você pode instalar um, dois ou os três. Eles compartilham o mesmo espaço de trabalho do Pathrule, o mesmo servidor MCP e a mesma árvore de conteúdo. As configurações que cada cliente lê são independentes.

Instalação

Pelo Pathrule CLI:

pathrule setup

Execute o comando na pasta do projeto e escolha Codex quando ele perguntar quais ferramentas de IA você usa. O setup faz você entrar no Pathrule Cloud quando necessário, vincula a pasta a um espaço de trabalho, instala a entrada MCP, guarda sua escolha para esta pasta e grava os arquivos do Codex. Se preferir usar o Pathrule sem conta, execute pathrule setup --local; nesse caso, o conhecimento fica nesta máquina.

Para configurar as partes manualmente em uma pasta que já está vinculada:

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex adiciona a entrada MCP em ~/.codex/config.toml. pathrule sync instala o script de hook e grava os arquivos do projeto para as ferramentas de IA escolhidas para esta pasta ou, se nenhuma foi escolhida, para as que ele detectar na pasta.

Pela extensão do VS Code, escolha Codex em Connect AI Clients. A extensão grava a mesma entrada MCP e a mesma configuração de hooks por meio do CLI incluído nela.

Remote MCP

O Codex também pode se conectar ao endpoint hospedado, sem nenhuma instalação local:

codex mcp add pathrule --url https://cloud.pathrule.io/mcp

Depois, conclua o login OAuth com sua conta do Pathrule. O Remote MCP dá ao Codex apenas as ferramentas MCP: ele não instala hooks, não grava arquivos locais e não tem modo local. Veja Pathrule Remote MCP.

Verificação

Abra o Codex CLI em um diretório que você vinculou a um espaço de trabalho. Os metadados de sessão do Pathrule devem chegar no início da sessão, e o assistente deve conseguir chamar pathrule_get_context no seu diretório de trabalho.

Envie um prompt simples que envolva um caminho com conteúdo. As regras e memórias relevantes devem chegar junto com o prompt, e o assistente pode se aprofundar pelo MCP. Se nada chegar, execute:

pathrule doctor

O doctor é somente leitura. Ele informa seu login, o espaço de trabalho e se esta pasta está vinculada, se a entrada MCP do Pathrule está instalada para o Codex e para cada um dos outros clientes, e quais arquivos gerenciados pelo Pathrule estão na pasta e quem os gravou. Adicione --json para ver o relatório completo, que também aponta uma entrada MCP que referencia um runtime que não existe mais. pathrule repair regrava uma entrada desatualizada, reinstala o script de hook e a configuração de hooks, sincroniza o AGENTS.md de novo e executa o doctor mais uma vez.

O que não muda

A camada de conteúdo é idêntica em todos os clientes.

• A mesma memória que aparece para o Claude Code pelo hook aparece para o Codex pelos hooks dele e pelas ferramentas MCP.
• Uma regra com padrão de bloqueio aprovado bloqueia um patch correspondente no Codex da mesma forma que bloqueia uma edição no Claude Code.
• Uma skill pode ser invocada pelo nome.

Se a sua equipe escreve conteúdo para um assistente, todos os assistentes recebem esse conteúdo.

O que ler em seguida

• Claude Code, a integração irmã com hooks nativos.
• Cursor, a integração com o Cursor.
• Referência das ferramentas MCP, com todas as ferramentas que o Codex pode chamar.