---
title: "Comandi CLI"
description: "Utilizza tutti i comandi della CLI di AI Glot per account, utilizzo, traduzioni esistenti, glossari, ricerca lingue, accesso all'API raw e bridging MCP."
canonical: "https://ai-glot.com/docs/it/cli/commands"
updated: "2026-08-12"
---

# Comandi CLI

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

## Account e utilizzo

```bash
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

```bash
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](/docs/cli/automation#pagination). `download --output -` scrive il CSV nello standard output.

> **Info: Creato nell'app web**
>
> Questi comandi operano su traduzioni già create tramite l'app web. In v1, la CLI non può caricare o avviare nuove traduzioni.

## Glossari

Le coppie di lingue utilizzano i tag supportati uniti tra loro, come `en-US-fr`.

```bash
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.

> **Warning: Anteprima di un replace prima dell'esecuzione**
>
> `glossaries replace --dry-run` legge il glossario, calcola localmente la differenza con il tuo file e stampa le modifiche che verrebbero apportate senza inviare nulla. Elenca i termini esatti sotto `removed_terms`, ovvero quelli che verrebbero eliminati perché assenti dal tuo file. Questa è l'unica rete di sicurezza per l'unico comando che elimina termini mai nominati dall'utente; quindi, eseguilo sempre per primo e fermati se l'elenco è più lungo del previsto.

## Autenticazione

```bash
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)

```bash
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.