localize.dev

Docs / Agents / Gemini CLI

Localiser une application avec Gemini CLI

Ajoutez localize.dev à settings.json de Gemini CLI afin que l'agent terminal de Google puisse vérifier, localiser et traduire le texte de l'interface utilisateur de votre application.

Comment ça marche

Gemini CLI lit les serveurs MCP à partir de mcpServers dans ~/.gemini/settings.json, ou dans .gemini/settings.json dans le projet pour les partager avec l'équipe.

Commencez par config. Il indique à l'agent quelles langues l'application expédie, où se trouvent les fichiers de locale et ce qui se trouve dans le glossaire, afin que le code qu'il écrit utilise votre bibliothèque i18n et vos termes.

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 localize aux mcpServers dans settings.json.
  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.
~/.gemini/settings.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Ce que vous obtenez

Où va le serveur
~/.gemini/settings.json
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

  • Gemini CLI lit GEMINI.md pour les instructions du projet. Pour utiliser la section que init --agent écrit, pointez le paramètre de fichier de contexte de Gemini CLI sur AGENTS.md ou copiez la section dans GEMINI.md.
  • /mcp dans Gemini CLI liste les serveurs connectés et leurs outils, le moyen le plus rapide de voir que localize a démarré.

Essayez

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

“Quelles langues cette application prend-elle en charge, et que contient son glossaire?”

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.