localize.dev

Documenti / Agenti / Gemini CLI

Localizza un'app con Gemini CLI

Aggiungi localize.dev a settings.json di Gemini CLI in modo che l'agente terminale di Google possa controllare, localizzare e tradurre il testo dell'interfaccia utente della tua app.

Come funziona

Gemini CLI legge i server MCP da mcpServers in ~/.gemini/settings.json, o in .gemini/settings.json nel progetto per condividerli con il team.

Inizia con config. Indica all'agente quali lingue vengono spedite dall'app, dove si trovano i file di localizzazione e cosa c'è nel glossario, in modo che il codice che scrive utilizzi la tua libreria i18n e i tuoi termini.

Configuralo

Esegui prima npx localize-dev login nel tuo terminale. Ti autentica tramite il browser e salva una chiave, che il server legge, quindi la configurazione sottostante non ne contiene nessuna.

  1. Aggiungi localize a mcpServers in settings.json.
  2. Riavvia l'agente o ricarica i suoi server MCP, in modo che avvii localize.
  3. Apri il tuo repository e chiedigli qualcosa come il prompt qui sotto.
~/.gemini/settings.json
{
  "mcpServers": {
    "localize": {
      "command": "npx",
      "args": ["-y", "localize-dev", "mcp"]
    }
  }
}

Cosa ottieni

Dove va il server
~/.gemini/settings.json
Server
localize-dev mcp, avviato con npx sulla tua macchina
Chiave
Quello che npx localize-dev login ha salvato
Cosa aggiunge init --agent
La sezione AGENTS.md con le istruzioni. Aggiungi il server manualmente, come sopra.

Buono a sapersi

  • Gemini CLI legge GEMINI.md per le istruzioni del progetto. Per utilizzare la sezione che scrive init --agent, punta l'impostazione del file di contesto di Gemini CLI su AGENTS.md o copia la sezione in GEMINI.md.
  • /mcp in Gemini CLI elenca i server connessi e i loro strumenti, il modo più rapido per vedere che localize è stato avviato.

Provalo

Chiedi qualcosa del genere. L'agente dovrebbe chiamare lo strumento config.

“Quali lingue distribuisce questa app e cosa c'è nel suo glossario?”

Mantienilo tradotto

Il testo che l'agente lascia hardcoded viene comunque rilevato: npx localize-dev check in CI fallisce una pull request che aggiunge testo non tradotto e non necessita di una chiave.

npx localize-dev check

Tutti gli agenti e il riferimento allo strumento si trovano nella pagina del server MCP.