PathruleO Codex constrói.
O Pathrule lembra.
AGENTS.md mais contexto de equipe com escopo. O Pathrule chega ao Codex por hooks, incluindo um que roda quando você envia um prompt, e traz o conhecimento que seu espaço de trabalho compartilha, selecionado para a tarefa.
CodexexemploSem
Pronto. A página busca /api/orders em um useEffect.
Usa fetch onde a equipe usa o cliente da API.2 tentativas
Com o Pathrule
antes de o Codex agir: 3 notas para features/orders
- Use o cliente da API, não fetch
- React Query para dados
- Botões compartilhados de ui/
Pronto. Os pedidos carregam pelo cliente da API com React Query.
Segue o que a equipe já decidiu.1 tentativa
Como o Pathrule chega ao Codex.
- arquivos que lê: simarquivos que lê
- AGENTS.md e configuração .codex
- antes de cada prompt: simantes de cada prompt
- Hook de prompt
- em torno das chamadas de ferramenta: simem torno das chamadas de ferramenta
- Hooks de ferramenta
- quando pede: simquando pede
- Local ou Remote MCP
A mesma entrega do Claude Code: hooks antes de cada prompt e em torno das chamadas de ferramenta, com o AGENTS.md sempre atualizado.
AGENTS.md vs Pathrule
- Os arquivos de instruções nativos podem ter escopo por caminho e ser compartilhados pelo controle de versão.
- O contexto depende dos arquivos e das orientações que o cliente carrega.
- As alterações seguem as permissões do repositório e o histórico de Git ou de pull requests.
- Preso às ferramentas que leem AGENTS.md nativamente.
- O onboarding segue a configuração de instruções do repositório.
- Recorte vinculado ao caminho. Só o que se aplica ao diretório atual.
- O custo em tokens acompanha o recorte relevante, não o conjunto inteiro de regras.
- Regras e skills revisáveis, com acesso ao espaço de trabalho controlado no servidor.
- O mesmo conteúdo chega a Claude Code, Cursor, GitHub Copilot e Windsurf, cada um no próprio formato.
- Onboarding = “entre no espaço de trabalho; as regras certas aparecem nos caminhos certos”.
Leitura longa: AGENTS.md vs Pathrule: quando cada um faz sentido.
O que o Pathrule acrescenta ao Codex
- Injeção via hookAntes da primeira chamada de ferramentaO Pathrule roda nos hooks que o Codex já expõe, incluindo o que dispara quando você envia um prompt, então o recorte com escopo chega antes de o Codex agir em cada prompt, e não só no início da sessão.
- Grafo indexado por caminhoA subárvore, não o arquivo inteiroUma regra vinculada a
/services/billingsó dispara quando o Codex está agindo dentro desse caminho. O AGENTS.md guarda as regras globais; o Pathrule guarda as que têm escopo. - Três tipos de nóMemórias, regras, skillsAs memórias carregam o contexto que a equipe aprendeu. As regras são consultivas ou estritas. As skills são roteiros de vários passos que o Codex pode invocar pelo nome.
- O mesmo conteúdo em todos os agentesClaude Code, Cursor, Copilot, WindsurfAs mesmas memórias, regras e skills chegam a Claude Code, Cursor, GitHub Copilot e Windsurf, cada um pelos hooks, arquivos e MCP que aquele cliente aceita. Como cada um se conecta.
Perguntas frequentes.
O que é o AGENTS.md?
O arquivo de instruções de padrão aberto lido nativamente por OpenAI Codex, GitHub Copilot, Cursor, Windsurf, Amp, Warp, Aider, Devin, Gemini CLI e Amazon Q. Ele fica na raiz do repositório e pode ser aninhado em qualquer diretório abaixo dela; o Codex concatena os arquivos da raiz até o seu diretório de trabalho e envia esse conteúdo em todo turno.
O que o Pathrule acrescenta ao Codex?
Uma camada vinculada a caminhos acima do AGENTS.md. O Pathrule indexa memórias, regras e skills por caminho e injeta o recorte correspondente no Codex no momento do hook, antes de o Codex agir em cada prompt.
Preciso apagar o AGENTS.md para usar o Pathrule?
Não. O Pathrule fica acima do AGENTS.md. Seu arquivo atual continua funcionando. O AGENTS.md carrega as constantes do repositório inteiro; o Pathrule carrega o conhecimento vinculado a caminhos que o AGENTS.md não consegue modelar bem.
Por que o AGENTS.md não se sustenta no trabalho em escala de equipe?
O AGENTS.md pode ser aninhado e commitado para uso da equipe, e o Codex também tem memórias locais opt-in. A lacuna que resta é compartilhar conhecimento recém-aprendido do espaço de trabalho entre agentes de fornecedores diferentes, selecioná-lo para a tarefa e aplicar um requisito estrito onde existir um hook capaz de bloquear. A cadeia de AGENTS.md do Codex tem um teto documentado de 32 KiB combinados.
Como o Pathrule é instalado no Codex?
Rode npm i -g @pathrule/cli e depois pathrule setup no seu projeto (adicione --local para rodar sem conta). O setup ativa o suporte a hooks do Codex em .codex/config.toml, registra em .codex/hooks.json hooks que apontam para um único script Node.js não ofuscado em ~/.pathrule/bin, atualiza o AGENTS.md e adiciona uma entrada MCP local. O Codex recebe o contexto vinculado ao caminho a cada prompt e em torno das chamadas de ferramenta. Remover as entradas remove o Pathrule.
Dá para conectar o Codex ao Pathrule sem instalar nada?
Sim, apenas para as ferramentas MCP. codex mcp add pathrule --url https://cloud.pathrule.io/mcp conecta o Codex ao Remote MCP com OAuth e uma conta do Pathrule. O Remote MCP não instala hooks nem grava arquivos locais, então o conhecimento chega quando o Codex o pede, e as regras estritas não conseguem bloquear.
O Pathrule vê meu código-fonte?
Não. O Pathrule não envia automaticamente o código-fonte do seu repositório. No modo local não há conta, e o conhecimento fica na sua máquina. No modo Cloud, o Pathrule Cloud armazena as memórias, regras e skills que sua equipe escreve, o início de cada prompt é enviado para ranquear o que se aplica, e o pathrule snapshot, quando você ou seu agente o executam, envia a árvore de arquivos, os manifestos, pequenas amostras de documentação e metadados recentes do git. O detalhamento completo está na página de Segurança.