---
title: "Commandes du CLI"
description: "Utilisez toutes les commandes du CLI AI Glot pour les comptes, la consommation, les traductions existantes, les glossaires, la recherche de langues."
canonical: "https://ai-glot.com/docs/fr/cli/commands"
updated: "2026-08-12"
---

# Commandes du CLI

Exécutez `aiglot help --json` pour obtenir une description lisible par machine générée à partir de l'arborescence des commandes installées.

## Compte et consommation

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

Sans dates précisées, `usage` renvoie les 30 derniers jours. Les dates acceptent le format `AAAA-MM-JJ` ou les horodatages ISO complets.

`languages` est la seule commande qui fonctionne sans aucun identifiant, permettant ainsi à un agent de valider un code de langue par rapport au catalogue avant de s'authentifier ou de rédiger un glossaire.

## Traductions existantes

```bash
aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "catalogue produit"
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> "Catalogue produit français"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csv
```

Les traductions archivées sont exclues sauf si l'option `--archived` est présente. `--search` recherche dans le nom de la traduction ou le nom du fichier téléchargé, et `--quality-tier` n'accepte que `standard` ou `lite`. `--created-after` et `--created-before` acceptent le format `AAAA-MM-JJ` ou un horodatage ISO complet.

Utilisez `--cursor` avec le `next_cursor` de la réponse précédente, ou `--all` pour suivre le curseur jusqu'à la fin — voir la section [pagination](/docs/cli/automation#pagination). `download --output -` écrit le CSV vers la sortie standard.

> **Info: Créées dans l'application web**
>
> Ces commandes agissent sur des traductions déjà créées via l'application web. Le CLI ne peut pas télécharger ni lancer de traduction en v1.

## Glossaires

Les paires de langues utilisent des tags supportés joints, comme `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'entrée peut être un CSV à deux colonnes ou une table de correspondance JSON. Les commandes `add` et `remove` sont chirurgicales. `replace` supprime chaque terme absent du fichier ; `delete` supprime le glossaire complet. Les commandes destructives demandent une confirmation dans un terminal interactif et nécessitent l'option `--force` en usage non interactif.

`--expand-terms` inclut les termes de chaque glossaire dans la liste et limite la page à 10 éléments.

> **Warning: Prévisualiser un remplacement avant l'exécution**
>
> `glossaries replace --dry-run` lit le glossaire, compare les différences avec votre fichier localement et affiche les modifications prévues sans rien envoyer. Il liste précisément les termes sous `removed_terms` — ceux qui seraient supprimés car absents de votre fichier. C'est le seul filet de sécurité pour cette commande qui supprime des termes que l'utilisateur n'a pas nommés : exécutez-la toujours en premier et arrêtez-vous si la liste est plus longue que prévu.

## Authentification

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

`logout` oublie l'identifiant stocké et le révoque côté serveur lorsque le type d'identifiant supporte la révocation.

## Accès directs et utilitaires

```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` effectue une requête authentifiée brute, permettant d'utiliser un nouveau point de terminaison REST avant qu'une commande dédiée n'existe. `--data` accepte du JSON en ligne, un fichier via `@file`, ou l'entrée standard via `-`. L'option `--header "Name: value"` est répétable mais ne peut pas définir `Authorization`, car le CLI fournit lui-même l'identifiant. `aiglot mcp` fait le pont entre les clients MCP locaux (stdio uniquement) et le serveur HTTP distant d'AI Glot.