AI Glot websiteOpen AI Glot
CLI e MCPComandi CLI

Comandi CLI

Usa tutti i comandi della CLI di AI Glot per avviare una traduzione, gestire quelle esistenti e amministrare account, utilizzo, glossari, ricerca delle lingue, accesso diretto all’API e collegamento MCP.

Esegui aiglot help --json per ottenere una descrizione leggibile da una macchina, generata dall’albero dei comandi installato.

Account e utilizzo

Terminal
aiglot account
aiglot credits
aiglot usage --from 2026-07-01 --to 2026-07-31 --granularity day
aiglot languages

Se non specifichi le date, usage restituisce i dati degli ultimi 30 giorni. Puoi usare il formato YYYY-MM-DD o timestamp ISO completi.

languages è l’unico comando utilizzabile senza credenziali, perciò un agente può verificare che un tag lingua sia presente nel catalogo prima di autenticarsi o creare un glossario.

Avviare una traduzione

Per avviare una traduzione servono tre chiamate, non una sola: il piano va esaminato prima di essere pagato. create legge il file, plan trasforma le tue istruzioni in un piano con relativo costo e approve conferma l’operazione.

Terminal
aiglot batches create ./products.csv --instruction "Translate the descriptions into German"
aiglot batches create ./book.xlsx
aiglot batches create ./annual-report.pdf
aiglot batches create https://example.com/strings.json --url
aiglot batches create ./products.csv --name catalogue.csv
aiglot batches create ./products.csv --idempotency-key import-2026-10-16
aiglot batches plan <id> --instruction "Translate the name column into Spanish"
aiglot batches plan <id> --refine "Leave the SKUs untouched"
aiglot batches approve <id>
aiglot batches approve <id> --yes
aiglot batches approve <id> --quality lite
aiglot batches approve <id> --instructions "Keep {count} placeholders exactly as written"
aiglot batches cancel <id>

Se passi --instruction a create, il comando restituisce il file e il piano completo in un’unica chiamata. Altrimenti ricevi il file e una serie di suggerimenti tra cui scegliere. plan --instruction crea un piano se non ne esiste ancora uno; plan --refine modifica quello esistente. Passa l’uno o l’altro, mai entrambi.

I formati testuali vengono inviati direttamente; i formati binari (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML e ZIP) vengono caricati automaticamente come dati di un modulo multipart. Per i PDF serve la versione 0.3.4 o successiva, mentre per .idml serve la versione 0.3.5 o successiva. --url interpreta l’argomento come un URL HTTPS, recuperato dall’API sul lato server. --name imposta il nome file registrato dall’API, utile quando il file locale ha un nome temporaneo. --idempotency-key (dalla versione 0.4.0) identifica il tentativo: se la risposta va persa e ripeti lo stesso comando con la stessa chiave, ottieni il primo batch invece di crearne un secondo. Se usi la stessa chiave con un file diverso, il comando restituisce idempotency_key_reused.

Traduzioni esistenti

Terminal
aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "product catalogue"
aiglot batches list --quality-tier lite --created-after 2026-07-01 --created-before 2026-07-31
aiglot batches list --status completed --all
aiglot batches get <id>
aiglot batches rename <id> "French product catalogue"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csv

Le traduzioni archiviate sono escluse, a meno che non venga passato --archived. --search cerca nel nome della traduzione o del file caricato. --quality-tier accetta solo standard o lite. --created-after e --created-before accettano il formato YYYY-MM-DD o un timestamp ISO completo.

Usa --cursor con il valore next_cursor della risposta dell’elenco precedente, oppure --all per scorrere tutte le pagine. Consulta la paginazione. download --output - scrive il CSV nell’output standard.

Glossari

Le coppie di lingue si indicano concatenando i tag supportati, ad esempio en-US-fr.

Terminal
aiglot glossaries list --limit 25 --cursor <cursor>
aiglot glossaries list --expand-terms
aiglot glossaries list --all
aiglot glossaries get en-US-fr
aiglot glossaries create en-US-fr --from terms.csv
aiglot glossaries add en-US-fr --term "checkout=commande"
aiglot glossaries add en-US-fr --from additions.json
aiglot glossaries remove en-US-fr --term checkout
aiglot glossaries replace en-US-fr --from complete.csv --dry-run
aiglot glossaries replace en-US-fr --from complete.csv
aiglot glossaries delete en-US-fr

L’input può essere un CSV a due colonne o una mappa di termini in JSON. Le operazioni di aggiunta e rimozione intervengono solo sui termini indicati. replace elimina tutti i termini assenti dal file, mentre delete rimuove l’intero glossario. Nei terminali interattivi i comandi distruttivi chiedono conferma; in modalità non interattiva richiedono --force.

--expand-terms include i termini di ogni glossario nell’elenco e limita la pagina a 10 risultati.

Feedback

Segnala un problema o suggerisci un miglioramento mentre usi AI Glot:

Terminal
aiglot feedback send \
  --problem "The tool returned an empty result" \
  --situation "I called the MCP translation tool with a valid file" \
  --expected-solution "The response should explain what happened" \
  --action create_translation \
  --model claude-sonnet-4.5 \
  --harness "Claude Desktop"

I tre campi principali accettano testo libero. I campi action, model e harness sono facoltativi. Non includere chiavi API, token, URL firmati o il contenuto completo dei file. Il comando registra solo il feedback e non consuma crediti.

Autenticazione

Terminal
aiglot auth login
aiglot auth login --device
aiglot auth login --key "$AIGLOT_API_KEY"
aiglot auth status
aiglot auth logout

Il logout elimina le credenziali salvate e le revoca sul server, se il tipo di credenziale supporta la revoca.

Comandi di ripiego e utilità

Terminal
aiglot api GET /v1/account
aiglot api PATCH /v1/batches/<id> --data '{"archived":true}'
aiglot api PUT /v1/glossaries/en-fr --data @terms.json
echo '{"upsert":{"cart":"panier"}}' | aiglot api PATCH /v1/glossaries/en-fr --data -
aiglot api GET /v1/account --header "X-Request-Source: ci"
aiglot mcp
aiglot doctor
aiglot completion zsh

aiglot api invia richieste autenticate direttamente all’API, così puoi usare un nuovo endpoint REST anche prima che esista un comando dedicato. --data accetta JSON inline, @file o - per leggere dall’input standard. Puoi ripetere --header "Name: value", ma non puoi impostare Authorization, perché la CLI aggiunge direttamente le credenziali. aiglot mcp collega i client MCP locali che usano solo stdio al server HTTP remoto di AI Glot.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.