Comandi CLI

Esegui aiglot help --json per ottenere una descrizione leggibile dalle macchine, 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 languages

Se non specifichi le date, usage restituisce gli ultimi 30 giorni. Le date possono essere nel formato YYYY-MM-DD o timestamp ISO completi.

languages è l’unico comando che funziona senza credenziali, così un agente può verificare un tag di lingua nel catalogo prima di autenticarsi o creare un glossario.

Avviare una traduzione

Per avviare una traduzione servono tre chiamate, non una, perché il piano va esaminato prima di pagarlo. create legge il file, plan trasforma le istruzioni in un piano con il relativo costo, 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 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> --quality lite
aiglot batches approve <id> --instructions "Keep {count} placeholders exactly as written"
aiglot batches cancel <id>

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

I formati testuali vengono inviati direttamente; quelli binari (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF e ZIP) vengono caricati automaticamente come dati di un modulo multipart. Per i PDF è necessaria la versione 0.3.4 o successiva. --url interpreta l’argomento come URL HTTPS, che l’API recupera lato server. --name imposta il nome file registrato dall’API, utile quando il file locale ha un nome temporaneo.

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.csv

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

Usa --cursor con il valore next_cursor della risposta dell’elenco precedente, oppure --all per seguire il cursore fino alla fine. Consulta la paginazione. download --output - scrive il file CSV sullo standard output.

Glossari

Le coppie di lingue usano tag supportati concatenati, per 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-fr

Puoi fornire un CSV a due colonne o una mappa di termini JSON. I comandi di aggiunta e rimozione agiscono solo sui termini specificati. replace elimina tutti i termini non presenti nel file; delete rimuove l’intero glossario. Nei terminali interattivi, i comandi distruttivi chiedono conferma; in modalità non interattiva è necessario specificare --force.

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

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 sono di 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 soltanto 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 logout

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

Comandi di emergenza 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 zsh

aiglot api invia richieste autenticate direttamente, così puoi usare un nuovo endpoint REST prima che sia disponibile un comando dedicato. --data accetta JSON inline, @file oppure - per leggere dallo standard input. --header "Name: value" può essere ripetuto, ma non può impostare Authorization, perché la CLI aggiunge autonomamente le credenziali. aiglot mcp collega i client MCP locali che usano solo stdio al server HTTP remoto di AI Glot.