Commandes de la 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 utilisation

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

Sans dates, usage renvoie les données des 30 derniers jours. Les dates peuvent être au format YYYY-MM-DD ou sous forme d’horodatages ISO complets.

languages est la seule commande qui fonctionne sans aucun identifiant. Un agent peut donc valider un code de langue à partir du catalogue avant de s’authentifier ou de rédiger un glossaire.

Lancer une traduction

Lancer une traduction nécessite trois appels, et non un seul, car le plan doit être consulté avant d’être payé. create lit le fichier, plan transforme votre instruction en un plan tarifé, puis approve lance le traitement.

aiglot batches create ./products.csv --instruction "Translate the descriptions into German"
aiglot batches create ./book.xlsx
aiglot batches create ./annual-report.pdf
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>

Avec --instruction dans create, le fichier et le plan complet sont renvoyés en un seul appel. Sans cette option, vous obtenez le fichier et plusieurs suggestions parmi lesquelles choisir. plan --instruction crée un plan s’il n’en existe pas encore ; plan --refine modifie le plan existant. Utilisez l’une de ces options, mais jamais les deux.

Les formats texte sont transmis directement. Les formats binaires (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF et ZIP) sont automatiquement envoyés en données de formulaire multipart. Pour les PDF, la version 0.3.4 ou ultérieure est nécessaire. --url indique que l’argument est une URL HTTPS que l’API récupérera côté serveur. --name définit le nom de fichier enregistré par l’API, utile lorsque le fichier local porte 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 vous utilisez --archived. --search recherche dans le nom de la traduction ou celui du fichier importé. --quality-tier accepte uniquement standard ou lite. --created-after et --created-before acceptent le format YYYY-MM-DD ou un horodatage ISO complet.

Utilisez --cursor avec la valeur next_cursor de la réponse de liste précédente, ou --all pour parcourir toutes les pages. Consultez la pagination. download --output - écrit le CSV dans la sortie standard.

Glossaires

Les paires de langues sont composées de codes pris en charge, réunis, par exemple, sous la forme 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

Les données d’entrée peuvent être un CSV à deux colonnes ou une table de correspondance de termes au format JSON. Les commandes d’ajout et de suppression n’agissent que sur les termes concernés. replace supprime tous les termes absents du fichier ; delete supprime le glossaire entier. Les commandes destructives demandent une confirmation dans un terminal interactif et nécessitent --force en mode non interactif.

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

Commentaires

Signalez un problème ou suggérez une amélioration pendant que vous utilisez AI Glot :

aiglot feedback send \
  --problem "The tool returned an empty result" \
  --situation "I called the MCP translation tool with a valid file" \
  --expected-solution "The response should explain what happened" \
  --action create_translation \
  --model claude-sonnet-4.5 \
  --harness "Claude Desktop"

Les trois champs principaux acceptent du texte libre. Les champs d’action, de modèle et d’environnement sont facultatifs. N’incluez pas de clés API, de jetons, d’URL signées ni le contenu intégral de fichiers. Cette commande enregistre uniquement le commentaire et ne coûte aucun crédit.

Authentification

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

La déconnexion efface l’identifiant enregistré et le révoque côté serveur si son type permet la révocation.

Accès direct 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 envoie une requête authentifiée brute. Vous pouvez ainsi utiliser un nouvel endpoint REST avant qu’une commande dédiée soit disponible. --data accepte du JSON fourni directement, @file ou - pour lire depuis l’entrée standard. L’option --header "Name: value" peut être répétée, mais ne permet pas de définir Authorization, car la CLI fournit elle-même l’identifiant. aiglot mcp relie les clients MCP locaux fonctionnant uniquement sur stdio au serveur HTTP distant d’AI Glot.