localize.dev

Docs / Agents / Codex

Localiser une application avec Codex

Ajoutez localize.dev à ~/.codex/config.toml afin qu'OpenAI Codex puisse trouver le texte de l'interface utilisateur codé en dur, lui attribuer des clés et le traduire, dans la CLI et l'extension IDE.

Comment ça marche

Codex lit les serveurs MCP depuis ~/.codex/config.toml, et la CLI ainsi que l'extension IDE partagent ce fichier. Ajoutez la table [mcp_servers.localize] une fois et les deux pourront appeler les outils de localize.dev.

Codex suit AGENTS.md. npx localize-dev init --agent y ajoute une section qui lui indique d'appeler localize après avoir modifié le texte de l'interface utilisateur et d'exécuter npx localize-dev check --changed avant qu'il ne termine.

Configurez-le

Exécutez d'abord npx localize-dev login dans votre terminal. Il vous connecte via le navigateur et enregistre une clé, que le serveur lit, de sorte que la configuration ci-dessous n'en contient aucune.

  1. Ajoutez la table [mcp_servers.localize] à ~/.codex/config.toml.
  2. Redémarrez l'agent ou rechargez ses serveurs MCP pour qu'il commence à localiser.
  3. Ouvrez votre dépôt et demandez-lui quelque chose de similaire à l'invite ci-dessous.
~/.codex/config.toml
[mcp_servers.localize]
command = "npx"
args = ["-y", "localize-dev", "mcp"]

Ce que vous obtenez

Où va le serveur
~/.codex/config.toml
Serveur
localize-dev mcp, démarré avec npx sur votre machine
Clé
Celui que npx localize-dev login a sauvegardé
Ce que init --agent ajoute
La section AGENTS.md avec les instructions. Ajoutez le serveur manuellement, comme ci-dessus.

Bon à savoir

  • Le fichier de configuration est TOML, pas JSON : command et args vont sous [mcp_servers.localize].
  • Codex ne reçoit pas de hook après modification. La section AGENTS.md et un check dans CI interceptent le texte qu'il laisse codé en dur.
  • Commencez par une invite en lecture seule : demandez à Codex d'exécuter check avant d'ouvrir une pull request. check et config n'ont pas besoin de clé et n'utilisent jamais votre allocation.

Essayez

Demandez quelque chose comme ceci. L'agent doit appeler l'outil check.

“Avant d'ouvrir la PR, vérifiez la présence de texte codé en dur et de traductions manquantes.”

Gardez-le traduit

Le texte que l'agent laisse codé en dur est toujours détecté : npx localize-dev check dans CI échoue une demande de tirage qui ajoute une copie non traduite, et elle n'a pas besoin de clé.

npx localize-dev check

Tous les agents et la référence de l'outil se trouvent sur la page du serveur MCP.