localize.dev

Documentación / Agentes / Codex

Localizar una aplicación con Codex

Agregue localize.dev a ~/.codex/config.toml para que OpenAI Codex pueda encontrar texto de interfaz de usuario codificado, asignarle claves y traducirlo, tanto en la CLI como en la extensión del IDE.

Cómo funciona

Codex lee los servidores MCP desde ~/.codex/config.toml, y la CLI y la extensión del IDE comparten ese archivo. Agregue la tabla [mcp_servers.localize] una vez y ambos podrán llamar a las herramientas de localize.dev.

Codex sigue AGENTS.md. npx localize-dev init --agent agrega una sección allí que le indica que llame a localize después de cambiar el texto de la interfaz de usuario y que ejecute npx localize-dev check --changed antes de que termine.

Configúralo

Primero ejecuta npx localize-dev login en tu terminal. Te inicia sesión a través del navegador y guarda una clave, que el servidor lee, por lo que la configuración a continuación no lleva ninguna.

  1. Agrega la tabla [mcp_servers.localize] a ~/.codex/config.toml.
  2. Reinicia el agente o recarga sus servidores MCP para que comience a localizar.
  3. Abre tu repositorio y pídele algo similar a la indicación de abajo.
~/.codex/config.toml
[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]

Lo que obtienes

Dónde va el servidor
~/.codex/config.toml
Servidor
localize-dev mcp, iniciado con npx en tu máquina
Clave
El que guardó npx localize-dev login
Lo que añade init --agent
La sección AGENTS.md con las instrucciones. Agrega el servidor manualmente, como se indicó anteriormente.

Bueno saberlo

  • El archivo de configuración es TOML, no JSON: command y args van debajo de [mcp_servers.localize].
  • Codex no recibe un hook posterior a la edición. La sección AGENTS.md y un check en CI capturan el texto que deja codificado.
  • Comience con una indicación de solo lectura: pida a Codex que ejecute check antes de abrir una solicitud de extracción. check y config no necesitan clave y nunca usan su asignación.

Pruébalo

Pregunta algo como esto. El agente debería llamar a la herramienta check.

“Antes de abrir el PR, verifica si hay texto codificado y traducciones faltantes.”

Mantenlo traducido

El texto que el agente deja codificado aún se detecta: npx localize-dev check en CI falla una solicitud de extracción que agrega una copia no traducida, y no necesita una clave.

npx localize-dev check

Todos los agentes y la referencia de herramientas están en la página del servidor MCP.