Codex CLI

Codex CLI se connecte à votre espace de travail Pathrule via Pathrule CLI ou l'extension VS Code. L'intégration repose sur trois éléments : les hooks natifs de Codex, un fichier AGENTS.md associé à la racine de l'espace de travail, et les mêmes outils MCP que ceux des autres clients. Avec Claude Code, Codex est l'un des deux clients que Pathrule atteint par un hook à la soumission du prompt.

Cette page décrit ce que l'intégration écrit dans votre projet, ce qui la distingue des flux Claude Code et Cursor, et comment la vérifier.

Ce que Pathrule écrit

Lorsque vous installez Pathrule dans Codex CLI, vous obtenez :

• Une entrée de serveur MCP dans ~/.codex/config.toml, pour que l'assistant puisse appeler les outils pathrule_*. Les autres serveurs déclarés dans ce fichier restent tels quels.
• .codex/hooks.json dans le projet. Il contient l'enregistrement des hooks, fusionné de façon à conserver ceux que vous avez ajoutés vous-même.
• Un bloc balisé dans le fichier .codex/config.toml du projet, qui active les hooks de Codex. Le reste du fichier vous appartient et n'est pas modifié.
• AGENTS.md à la racine de l'espace de travail. Une fois le hook installé, la partie Pathrule de ce fichier se limite à une courte note indiquant que Pathrule est actif et transmis par le hook.
• Des skills matérialisés dans .agents/skills/<name>/SKILL.md, pour que Codex puisse les invoquer par leur nom.

AGENTS.md est l'équivalent de CLAUDE.md pour Codex. Lorsque le hook Codex est installé, le protocole passe par le hook SessionStart plutôt que par le fichier, et les connaissances liées aux chemins arrivent par les hooks de prompt et d'outil : aucune copie du protocole ni aucun fichier de connaissances n'est écrit dans votre arborescence. Sans le hook, AGENTS.md contient le protocole complet et la vue d'ensemble de l'espace de travail, et Pathrule ajoute un AGENTS.md dans chaque répertoire auquel des connaissances sont rattachées, que Codex charge dès que le travail entre dans ce répertoire.

Couverture des hooks

Le contrat de hooks de Codex est proche de celui de Claude Code. Pathrule enregistre des hooks de démarrage de session, de soumission du prompt, d'avant-outil, d'après-outil et d'arrêt :

• Démarrage de session : transmet les métadonnées de l'espace de travail, le protocole et le contexte de votre équipe, une fois par session.
• Soumission du prompt : cadre le tour avec les règles et les mémoires adaptées au prompt, les mémoires les plus pertinentes étant fournies en intégralité.
• Avant-outil : ajoute le nom de ce qui s'applique au chemin touché par le patch ou la commande, et vérifie les règles dotées d'un motif de blocage approuvé avant l'application d'un patch.
• Après-outil : enregistre le résultat.
• Arrêt : permet à une vérification obligatoire approuvée de garder le tour ouvert tant que sa commande n'a pas réussi.

Les principales différences avec Claude Code concernent les outils : Codex utilise son format apply_patch (avec des marqueurs *** Update File:) au lieu d'outils Edit et Write distincts, et il n'existe pas de hook Read. Le script de hook partagé de Pathrule comprend apply_patch, rattache les chemins concernés aux nœuds de l'espace de travail et traite un patch comme une modification : une règle dotée d'un motif de blocage approuvé arrête donc un patch correspondant avant qu'il soit appliqué. Un motif de blocage proposé par un assistant n'est appliqué qu'après approbation par une personne.

L'investissement se situe dans la couche de contenu, pas dans le client : les mêmes mémoires, règles et skills servent Codex comme tous les autres clients.

Isolation par client

Codex cohabite avec Claude Code et Cursor sur la même machine. Vous pouvez en installer un, deux ou les trois. Ils partagent le même espace de travail Pathrule, le même serveur MCP et la même arborescence de contenu. Les configurations lues par chaque client sont indépendantes.

Installation

Via Pathrule CLI :

pathrule setup

Lancez la commande dans le dossier du projet et choisissez Codex lorsqu'elle vous demande quels outils d'IA vous utilisez. Setup vous connecte à Pathrule Cloud si nécessaire, rattache le dossier à un espace de travail, installe l'entrée MCP, mémorise votre choix pour ce dossier et écrit les fichiers Codex. Lancez plutôt pathrule setup --local pour utiliser Pathrule sans compte ; les connaissances restent alors sur cette machine.

Pour câbler les éléments à la main dans un dossier déjà rattaché :

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex ajoute l'entrée MCP à ~/.codex/config.toml. pathrule sync installe le script de hook et écrit les fichiers du projet pour les outils d'IA choisis pour ce dossier, ou, si aucun n'a été choisi, pour ceux qu'il détecte dans le dossier.

Avec l'extension VS Code, choisissez Codex dans Connect AI Clients. L'extension écrit la même entrée MCP et la même configuration de hooks via son CLI intégré.

Remote MCP

Codex peut aussi se connecter à l'endpoint hébergé, sans aucune installation locale :

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

Terminez ensuite la connexion OAuth avec votre compte Pathrule. Remote MCP ne donne à Codex que les outils MCP : il n'installe aucun hook, n'écrit aucun fichier local et ne propose pas de mode local. Voir Pathrule Remote MCP.

Vérification

Ouvrez Codex CLI dans un répertoire rattaché à un espace de travail. Les métadonnées de session Pathrule doivent arriver au démarrage de la session, et l'assistant doit pouvoir appeler pathrule_get_context sur votre répertoire de travail.

Lancez un prompt simple qui touche un chemin doté de contenu. Les règles et mémoires pertinentes doivent arriver avec le prompt, et l'assistant peut approfondir via MCP. Si rien n'arrive, lancez :

pathrule doctor

Le doctor fonctionne en lecture seule. Il indique votre connexion, votre espace de travail et si ce dossier y est rattaché, si l'entrée MCP Pathrule est installée pour Codex et pour chacun des autres clients, ainsi que les fichiers gérés par Pathrule présents dans le dossier et qui les a écrits. Ajoutez --json pour obtenir le rapport complet, qui signale aussi une entrée MCP pointant vers un runtime qui n'existe plus. pathrule repair réécrit une entrée obsolète, réinstalle le script et la configuration des hooks, resynchronise AGENTS.md et relance le doctor.

Ce qui ne change pas

La couche de contenu est identique d'un client à l'autre.

• La mémoire qui parvient à Claude Code par le hook parvient à Codex par ses propres hooks et par les outils MCP.
• Une règle dotée d'un motif de blocage approuvé bloque un patch correspondant sur Codex, tout comme elle bloque une modification sur Claude Code.
• Un skill s'invoque par son nom.

Le contenu que votre équipe rédige pour un assistant profite à tous les assistants.

Pour aller plus loin

• Claude Code pour l'intégration sœur avec hooks natifs.
• Cursor pour l'intégration Cursor.
• Référence des outils MCP pour tous les outils que Codex peut appeler.