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

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

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. download --output - écrit le CSV vers la sortie standard.

Glossaires

Les paires de langues utilisent des tags supportés joints, comme 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’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.

Authentification

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

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.