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
aiglot account
aiglot credits
aiglot usage --from 2026-07-01 --to 2026-07-31 --granularity day
aiglot languagesSe 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.
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
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.csvLe 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.
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-frL’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:
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
aiglot auth login
aiglot auth login --device
aiglot auth login --key "$AIGLOT_API_KEY"
aiglot auth status
aiglot auth logoutIl logout elimina le credenziali salvate e le revoca sul server, se il tipo di credenziale supporta la revoca.
Comandi di ripiego e utilità
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 zshaiglot 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.