Commandes CLI

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

Compte et utilisation

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

Sans dates, usage renvoie les 30 derniers jours. Les dates acceptent le format YYYY-MM-DD ou les horodatages ISO complets.

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

Lancer une traduction

Lancer une traduction se fait en trois appels, et non un seul, car le plan doit être lu avant d’être payé. create lit le fichier, plan transforme votre instruction en un plan tarifé, et approve valide l’opération.

aiglot batches create ./products.csv --instruction "Translate the descriptions into German"
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 "Translate the name column into Spanish"
aiglot batches plan <id> --refine "Leave the SKUs untouched"
aiglot batches approve <id>
aiglot batches approve <id> --quality lite
aiglot batches approve <id> --instructions "Keep {count} placeholders exactly as written"
aiglot batches cancel <id>

L’ajout de --instruction à create renvoie le fichier et son plan complet en un seul appel. Sans cela, vous obtenez le fichier et un ensemble de suggestions parmi lesquelles choisir. plan --instruction crée un plan là où il n’y en a pas ; plan --refine modifie celui déjà existant. Utilisez l’un ou l’autre, mais jamais les deux.

--url traite l’argument comme une URL HTTPS que l’API récupère côté serveur. --name définit le nom du fichier enregistré par l’API lorsque le fichier local a un nom temporaire.

Traductions existantes

aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "product catalogue"
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> "French product catalogue"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csv

Les traductions archivées sont exclues sauf si --archived est précisé. --search correspond au nom de la traduction ou au nom du fichier importé, et --quality-tier n’accepte que standard ou lite. --created-after et --created-before acceptent le format YYYY-MM-DD ou un horodatage ISO complet.

Utilisez --cursor avec le next_cursor de la réponse de liste précédente, ou --all pour suivre le curseur jusqu’à la fin. Voir la 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 map de termes 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 sur un terminal interactif et nécessitent --force en utilisation non interactive.

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

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.

Solutions de secours 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 ainsi d’utiliser un nouvel endpoint REST avant qu’une commande dédiée n’existe. --data accepte du JSON en ligne, @file ou - pour lire l’entrée standard. --header "Name: value" est répétable mais ne peut pas définir Authorization, car la CLI fournit elle-même l’identifiant. aiglot mcp fait le pont entre les clients MCP locaux limités au stdio et le serveur HTTP distant d’AI Glot.