Vai al contenuto
Pathrule

codex

Codex costruisce.
Pathrule ricorda.

AGENTS.md più il contesto del team, legato ai percorsi. Pathrule raggiunge Codex tramite hook, incluso uno che viene eseguito quando invii un prompt, e porta la conoscenza condivisa del tuo workspace, selezionata per l'attività.

Codexesempio
Aggiungi una pagina ordini.

Senza

Fatto. La pagina recupera /api/orders in un useEffect.

Usa fetch dove il team usa il client api.2 tentativi

Con Pathrule

prima che Codex agisca: 3 note per features/orders

  • Usa il client api, non fetch
  • React Query per i dati
  • Pulsanti condivisi da ui/

Fatto. Gli ordini si caricano tramite il client api con React Query.

In linea con ciò che il team ha già deciso.1 tentativo

Come Pathrule raggiunge Codex.

file che legge: sìfile che legge
AGENTS.md e la configurazione .codex
prima di ogni prompt: sìprima di ogni prompt
Hook sul prompt
attorno alle chiamate agli strumenti: sìattorno alle chiamate agli strumenti
Hook sugli strumenti
quando chiede: sìquando chiede
Locale, o Remote MCP

La stessa consegna di Claude Code: hook prima di ogni prompt e attorno alle chiamate agli strumenti, con AGENTS.md sempre aggiornato.

AGENTS.md vs Pathrule

Solo AGENTS.mdindicazioni native
  • I file di istruzioni nativi possono essere legati a un percorso e condivisi tramite il controllo di versione.
  • Il contesto dipende dai file e dalle indicazioni che il client carica.
  • Le modifiche seguono i permessi del repository e la sua cronologia Git o delle pull request.
  • Legato agli strumenti che leggono AGENTS.md nativamente.
  • L'onboarding segue la configurazione delle istruzioni del repository.
Pathrule + Codexper questo percorso
  • Porzione legata al percorso. Solo ciò che si applica alla directory corrente.
  • Il costo in token cresce con la porzione pertinente, non con l'intero insieme di regole.
  • Regole e skill revisionabili, con accesso al workspace controllato lato server.
  • Gli stessi contenuti raggiungono Claude Code, Cursor, GitHub Copilot e Windsurf, ciascuno nel proprio formato.
  • Onboarding = "entra nel workspace: le regole giuste compaiono sui percorsi giusti".

Approfondimento: AGENTS.md vs Pathrule: quando conviene l'uno e quando l'altro.

Cosa aggiunge Pathrule a Codex

  • Iniezione tramite hookPrima di qualsiasi chiamata a uno strumentoPathrule si aggancia agli hook che Codex già espone, compreso quello che scatta quando invii un prompt, così la porzione pertinente arriva prima che Codex agisca su ogni prompt, non solo all'avvio della sessione.
  • Grafo indicizzato per percorsoIl sottoalbero, non tutto il fileUna regola associata a /services/billing si attiva solo quando Codex lavora sotto quel percorso. AGENTS.md conserva le regole globali; Pathrule quelle con ambito.
  • Tre tipi di nodoMemorie, regole, skillLe memorie portano il contesto appreso dal team. Le regole sono consultive o vincolanti. Le skill sono playbook in più passaggi che Codex può richiamare per nome.
  • Stessi contenuti, ogni agenteClaude Code, Cursor, Copilot, WindsurfLe stesse memorie, regole e skill raggiungono Claude Code, Cursor, GitHub Copilot e Windsurf, ciascuno attraverso gli hook, i file e il supporto MCP di quel client. Come è collegato ciascuno.

Domande frequenti.

Che cos'è AGENTS.md?

Il file di istruzioni a standard aperto letto nativamente da OpenAI Codex, GitHub Copilot, Cursor, Windsurf, Amp, Warp, Aider, Devin, Gemini CLI e Amazon Q. Si trova alla radice del repository e può essere annidato in qualsiasi directory sottostante; Codex concatena i file dalla radice fino alla tua directory di lavoro e invia quel contenuto a ogni turno.

Cosa aggiunge Pathrule a Codex?

Un livello legato ai percorsi sopra AGENTS.md. Pathrule indicizza memorie, regole e skill per percorso e inietta la porzione corrispondente in Codex tramite gli hook, prima che Codex agisca su ogni prompt.

Devo eliminare AGENTS.md per usare Pathrule?

No. Pathrule si colloca sopra AGENTS.md. Il tuo file attuale continua a funzionare. AGENTS.md porta le costanti valide per tutto il repository; Pathrule porta la conoscenza legata ai percorsi che AGENTS.md non sa modellare bene.

Perché AGENTS.md non regge quando si lavora su scala di team?

AGENTS.md può essere annidato e committato per l'uso in team, e Codex ha anche memorie locali facoltative. La lacuna che resta è condividere tra agenti di fornitori diversi la conoscenza del workspace appena appresa, selezionarla per l'attività e far rispettare un requisito vincolante dove esiste un hook che può bloccare. La catena di AGENTS.md di Codex ha un tetto complessivo documentato di 32 KiB.

Come si installa Pathrule in Codex?

Esegui npm i -g @pathrule/cli, poi pathrule setup nel tuo progetto (aggiungi --local per usarlo senza account). Il setup attiva il supporto agli hook di Codex in .codex/config.toml, registra in .codex/hooks.json degli hook che puntano a un unico script Node.js non offuscato in ~/.pathrule/bin, aggiorna AGENTS.md e aggiunge una voce MCP locale. Codex riceve il contesto legato al percorso a ogni prompt e attorno alle chiamate agli strumenti. Rimuovere le voci rimuove Pathrule.

Posso collegare Codex a Pathrule senza installare nulla?

Sì, ma solo per gli strumenti MCP. codex mcp add pathrule --url https://cloud.pathrule.io/mcp collega Codex a Remote MCP con OAuth e un account Pathrule. Remote MCP non installa hook né scrive file locali, quindi la conoscenza arriva quando Codex la chiede, e le regole vincolanti non possono bloccare.

Pathrule vede il mio codice sorgente?

No. Pathrule non carica automaticamente il codice sorgente del tuo repository. In modalità locale non c'è alcun account e la conoscenza resta sulla tua macchina. In modalità cloud, Pathrule Cloud conserva le memorie, le regole e le skill che il tuo team scrive, l'inizio di ogni prompt viene inviato per classificare ciò che si applica e pathrule snapshot, quando lo esegui tu o il tuo agente, carica l'albero dei file, i manifest, brevi estratti della documentazione e i metadati git recenti. Il dettaglio completo è nella pagina Sicurezza.

Una sola configurazione.
Poi ricorda.

  • Guida alla configurazioneOgni passaggio per Codex, con ciò che scrive il setup.