Comandi CLI

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

Account e utilizzo

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

Senza date, usage restituisce gli ultimi 30 giorni. Le date accettano il formato AAAA-MM-GG o timestamp ISO completi.

languages è l’unico comando che funziona senza alcuna credenziale, consentendo a un agente di validare un tag lingua rispetto al catalogo prima dell’autenticazione o della scrittura di un glossario.

Traduzioni esistenti

aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "catalogo prodotti"
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> "Catalogo prodotti francese"
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 ricerca nel nome della traduzione o nel nome del file caricato, e --quality-tier accetta solo standard o lite. --created-after e --created-before accettano AAAA-MM-GG o un timestamp ISO completo.

Usa --cursor con il next_cursor della risposta precedente, oppure --all per seguire il cursore fino all’esaurimento dei risultati — vedi impaginazione. download --output - scrive il CSV nello standard output.

Glossari

Le coppie di lingue utilizzano i tag supportati uniti tra loro, come 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

L’input può essere un CSV a due colonne o una mappa di termini JSON. add e remove effettuano interventi mirati. replace elimina ogni termine assente dal file; delete rimuove l’intero glossario. I comandi distruttivi richiedono conferma in un terminale interattivo e necessitano di --force per l’uso non interattivo.

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

Autenticazione

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

Il comando logout rimuove la credenziale memorizzata e la revoca lato server se il tipo di credenziale supporta la revoca.

Utility e accessi diretti (Escape hatches)

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 effettua una richiesta autenticata raw, rendendo utilizzabili i nuovi endpoint REST prima che venga creato un comando dedicato. --data accetta JSON inline, @file o - per leggere dallo standard input. --header "Nome: valore" è ripetibile ma non può impostare Authorization, poiché la CLI fornisce autonomamente la credenziale. aiglot mcp collega i client MCP locali (solo stdio) al server HTTP remoto di AI Glot.