Comandi CLI

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

Account e consumi

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 YYYY-MM-DD 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.

Avviare una traduzione

Avviare una traduzione richiede tre chiamate, non una, poiché il piano deve essere letto prima di essere pagato. create legge il file, plan trasforma l’istruzione in un piano con relativo prezzo, approve conferma l’operazione.

aiglot batches create ./products.csv --instruction "Traduci le descrizioni in tedesco"
aiglot batches create ./book.xlsx
aiglot batches create https://example.com/strings.json --url
aiglot batches create ./products.csv --name catalogue.csv
aiglot batches plan <id> --instruction "Traduci la colonna name in spagnolo"
aiglot batches plan <id> --refine "Lascia invariati gli SKU"
aiglot batches approve <id>
aiglot batches approve <id> --quality lite
aiglot batches approve <id> --instructions "Mantieni i segnaposto {count} esattamente come scritti"
aiglot batches cancel <id>

Passando --instruction a create, il comando restituisce il file e l’intero piano in un’unica chiamata. Senza di esso, otterrai il file e un set di suggerimenti tra cui scegliere. plan --instruction scrive un piano dove non ne esiste uno; plan --refine modifica quello già presente, quindi usa l’uno o l’altro, mai entrambi.

--url tratta l’argomento come un URL HTTPS che l’API recupera lato server. --name imposta il nome del file registrato dall’API, nel caso il file locale abbia un nome temporaneo.

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 cerca nel nome della traduzione o nel nome del file caricato, e --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 next_cursor della risposta precedente dell’elenco, oppure --all per seguire il cursore fino all’esaurimento. Vedi paginazione. download --output - scrive il CSV nell’output standard.

Glossari

Le coppie linguistiche utilizzano 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 sono operazioni mirate. replace elimina ogni termine assente dal file; delete rimuove l’intero glossario. I comandi distruttivi richiedono conferma su 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

logout dimentica la credenziale memorizzata e la revoca lato server quando il tipo di credenziale supporta la revoca.

Utility e accessi diretti

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 grezza, rendendo utilizzabile un nuovo endpoint REST prima che esista un comando dedicato. --data accetta JSON inline, @file o - per leggere l’input standard. --header "Name: value" può essere ripetuto 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.