Graph Indexer para Codex CLI: MCP en config.toml

Graph Indexer para Codex CLI es un servidor MCP local que da a Codex referencias exactas, grafos de llamadas e impacto de cambios. Como Codex guarda los servidores MCP en ~/.codex/config.toml, npx graph-indexer init imprime el bloque TOML para pegar ahí y escribe en AGENTS.md, que Codex lee, un bloque gestionado con las reglas de búsqueda.

¿Cómo añado Graph Indexer a Codex?

Ejecuta init para Codex desde la raíz del repositorio, con Node.js 22.5 o superior:

npx graph-indexer init --agents codex

Codex también se selecciona solo cuando el repositorio tiene un AGENTS.md o un directorio .codex. A diferencia de otros agentes, init no escribe ningún archivo de configuración de proyecto para Codex: imprime la entrada del servidor y deja intacta tu configuración global.

¿Qué hace `npx graph-indexer init` con Codex?

Para Codex CLI, init hace dos cosas:

Acción	Detalle
Imprime una entrada TOML	Una tabla `[mcp_servers.graph-indexer]` con `command`, `args` y `cwd` apuntando al repositorio
Escribe `AGENTS.md`	Un bloque gestionado con las reglas de búsqueda y cuándo usar `find_references`, `call_graph`, `change_impact` y `check_changes`

También añade .graph-indexer/ al .gitignore.

¿Cómo es la configuración de Codex?

Añade esto a ~/.codex/config.toml. La forma manual del README pasa el repositorio con --repo:

[mcp_servers.graph-indexer]
command = "npx"
args = ["-y", "graph-indexer@3", "serve", "--repo", "/ruta/al/repo"]

El bloque que imprime init usa cwd = "/ruta/al/repo" en lugar del argumento --repo. Ambos apuntan el servidor al repositorio que quieres indexar.

¿Soporta Graph Indexer hooks en Codex?

El comando hook de Graph Indexer entiende los payloads de Codex: el código fuente indica que Codex comparte el formato de Claude Code y reconoce nombres de herramienta de Codex como apply_patch y exec_command. Sin embargo, init --hooks no escribe una configuración de hooks para Codex, así que en Codex la vía soportada son las herramientas MCP más el bloque de AGENTS.md.

¿Qué gana Codex con Graph Indexer?

Codex gana ocho herramientas de solo lectura. En una sesión de Codex, estas son las que conviene usar:

find_references para los puntos de llamada exactos de una función, con kind en inherit para subclases e implementaciones.
call_graph para llamadores de llamadores.
change_impact antes de cambiar una firma, y check_changes después.
read_code para leer varios símbolos a la vez en lugar de abrir archivos enteros.

El bloque de AGENTS.md indica además al agente que explore de una pasada y lea la función o las 50 o 100 líneas que necesita en vez de archivos completos. Las herramientas devuelven texto plano, acotado y con el mejor resultado primero. Consulta la referencia de herramientas y la guía de instalación.

Preguntas frecuentes

¿Por qué init no edita la configuración de Codex por mí?

Codex guarda sus servidores MCP en el ~/.codex/config.toml de usuario e init solo escribe archivos de proyecto, así que nunca edita ese archivo global. En su lugar imprime el TOML para que lo revises y lo pegues.

¿Uso cwd o --repo para indicar el repositorio?

Cualquiera de los dos. El bloque que imprime init fija cwd al repositorio. El ejemplo manual del README pasa --repo. Sin ninguno, el servidor indexa el repositorio git que contiene su directorio de trabajo.

¿Dónde lee Codex las instrucciones de búsqueda?

En AGENTS.md. init añade ahí un bloque gestionado corto, entre marcas graph-indexer:start y graph-indexer:end, y lo actualiza en su sitio cuando vuelves a ejecutar init.

¿Sirve con varios repositorios en Codex?

El bloque impreso va atado a un repositorio mediante cwd. Con varios repositorios, define una entrada de servidor por repo con nombres distintos, o quita la ruta y lanza Codex desde dentro del repositorio.