Codex CLI

Codex CLI se conecta a tu espacio de trabajo de Pathrule mediante Pathrule CLI o la extensión de VS Code. La integración tiene tres piezas: los hooks nativos de Codex, un archivo complementario AGENTS.md en la raíz del espacio de trabajo y la misma superficie de herramientas MCP que usan los demás clientes. Codex es, junto con Claude Code, uno de los dos clientes a los que Pathrule llega con un hook de envío de prompt.

Esta página explica qué se escribe en tu proyecto para la integración, en qué se diferencia de los flujos de Claude Code y Cursor, y cómo verificarla.

Qué escribe Pathrule

Cuando instalas Pathrule en Codex CLI, obtienes:

• Una entrada de servidor MCP en ~/.codex/config.toml, para que el asistente pueda llamar a las herramientas pathrule_*. Los demás servidores de ese archivo se mantienen tal como están.
• .codex/hooks.json en el proyecto. Contiene el registro de los hooks, combinado de forma que se conservan los hooks que hayas agregado tú.
• Un bloque marcado en el .codex/config.toml del proyecto que activa los hooks de Codex. El resto de ese archivo es tuyo y no se modifica.
• AGENTS.md en la raíz del espacio de trabajo. Con el hook instalado, la parte de Pathrule es una nota breve que indica que Pathrule está activo y que el hook se encarga de la entrega.
• Skills materializadas en .agents/skills/<name>/SKILL.md, para que Codex pueda invocarlas por su nombre.

AGENTS.md es el equivalente de CLAUDE.md para Codex. Cuando el hook de Codex está instalado, el protocolo viaja en el hook SessionStart en lugar del archivo, y el conocimiento de cada ruta llega mediante los hooks de prompt y de herramientas, así que no se escribe en tu árbol ninguna copia del protocolo ni archivos de conocimiento. Sin el hook, AGENTS.md contiene el protocolo completo y la descripción general del espacio de trabajo, y Pathrule agrega un AGENTS.md en cada directorio que tenga conocimiento asociado, que Codex carga cuando el trabajo entra en ese directorio.

Cobertura de hooks

El contrato de hooks de Codex se parece mucho al de Claude Code. Pathrule registra hooks de inicio de sesión, envío de prompt, antes de herramienta, después de herramienta y detención:

• Inicio de sesión entrega los metadatos del espacio de trabajo, el protocolo y el contexto de tu equipo una vez por sesión.
• Envío de prompt acota el turno con las reglas y memorias que corresponden al prompt, con las memorias más relevantes completas.
• Antes de herramienta agrega los nombres de lo que aplica a la ruta que toca el parche o el comando, y comprueba las reglas que tienen un patrón de bloqueo aprobado antes de que se aplique un parche.
• Después de herramienta registra el resultado.
• Detención permite que una comprobación obligatoria aprobada mantenga abierto el turno hasta que su comando haya pasado.

Las principales diferencias con Claude Code están en la superficie de herramientas: Codex usa su formato apply_patch (con marcadores *** Update File:) en lugar de herramientas separadas de Edit y Write, y no tiene hook de Read. El script de hooks compartido de Pathrule entiende apply_patch, resuelve las rutas afectadas a los nodos del espacio de trabajo y trata un parche como una edición, de modo que una regla con un patrón de bloqueo aprobado detiene un parche que coincida antes de que se aplique. Un patrón de bloqueo propuesto por un asistente no se aplica hasta que una persona lo apruebe.

La inversión está en la capa de contenido, no en el cliente, así que las mismas memorias, reglas y skills sirven para Codex y para cualquier otro cliente.

Aislamiento por cliente

Codex convive con Claude Code y Cursor en la misma máquina. Puedes instalar uno, dos o los tres. Comparten el mismo espacio de trabajo de Pathrule, el mismo servidor MCP y el mismo árbol de contenido. Las configuraciones que lee cada cliente son independientes.

Instalación

Con Pathrule CLI:

pathrule setup

Ejecútalo en la carpeta del proyecto y elige Codex cuando te pregunte qué herramientas de IA usas. El setup inicia sesión en Pathrule Cloud si hace falta, vincula la carpeta a un espacio de trabajo, instala la entrada MCP, recuerda tu elección para esta carpeta y escribe los archivos de Codex. Si quieres usar Pathrule sin cuenta, ejecuta pathrule setup --local; en ese caso, el conocimiento se queda en esta máquina.

Para conectar las piezas a mano en una carpeta que ya está vinculada:

pathrule install codex
pathrule sync
pathrule doctor

pathrule install codex agrega la entrada MCP a ~/.codex/config.toml. pathrule sync instala el script de hooks y escribe los archivos del proyecto para las herramientas de IA elegidas para esta carpeta o, si no se eligió ninguna, para las que detecte en ella.

Con la extensión de VS Code, elige Codex en Connect AI Clients. La extensión escribe la misma entrada MCP y la misma configuración de hooks mediante su CLI integrada.

Remote MCP

Codex también puede conectarse al endpoint alojado, sin instalar nada localmente:

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

Después, completa el inicio de sesión con OAuth usando tu cuenta de Pathrule. Remote MCP le da a Codex solo las herramientas MCP: no instala hooks, no escribe archivos locales y no tiene modo local. Consulta Pathrule Remote MCP.

Verificación

Abre Codex CLI en un directorio que hayas vinculado a un espacio de trabajo. Los metadatos de sesión de Pathrule deberían llegar al inicio de la sesión, y el asistente debería poder llamar a pathrule_get_context sobre tu directorio de trabajo.

Ejecuta un prompt sencillo que toque una ruta con contenido. Las reglas y memorias relevantes deberían llegar con el prompt, y el asistente puede profundizar mediante MCP. Si no llega nada, ejecuta:

pathrule doctor

El doctor es de solo lectura. Informa tu sesión, tu espacio de trabajo y si esta carpeta está vinculada, si la entrada MCP de Pathrule está instalada para Codex y para cada uno de los demás clientes, y qué archivos gestionados por Pathrule hay en la carpeta y quién los escribió. Agrega --json para obtener el informe completo, que también señala una entrada MCP que apunta a un runtime que ya no existe. pathrule repair reescribe una entrada obsoleta, reinstala el script y la configuración de hooks, vuelve a sincronizar AGENTS.md y ejecuta el doctor de nuevo.

Lo que no cambia

La capa de contenido es idéntica en todos los clientes.

• La misma memoria que le llega a Claude Code mediante el hook le llega a Codex mediante sus propios hooks y las herramientas MCP.
• Una regla con un patrón de bloqueo aprobado bloquea un parche que coincida en Codex, igual que bloquea una edición en Claude Code.
• Una skill se puede invocar por su nombre.

Si tu equipo escribe contenido para un asistente, todos los asistentes lo reciben.

Qué leer a continuación

• Claude Code para la integración hermana con hooks nativos.
• Cursor para la integración con Cursor.
• Referencia de herramientas MCP para ver todas las herramientas que puede llamar Codex.