Commandes CLI
Utilisez toutes les commandes de la CLI AI Glot pour lancer une traduction, gérer les traductions existantes et accéder aux comptes, à l’utilisation, aux glossaires, à la recherche de langues, à l’API brute et à la passerelle MCP.
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 languagesSans dates, usage renvoie les 30 derniers jours. Les dates peuvent être au format YYYY-MM-DD ou utiliser des horodatages ISO complets.
languages est la seule commande qui fonctionne sans aucun identifiant d’authentification. Un agent peut donc vérifier qu’une balise de langue figure dans le catalogue avant de s’authentifier ou de créer un glossaire.
Lancer une traduction
Lancer une traduction nécessite trois appels, et non un seul, car il faut pouvoir consulter le plan avant de le payer. create lit le fichier, plan transforme vos instructions en un plan tarifé, et 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 create ./products.csv --idempotency-key import-2026-10-16
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> --yes
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, vous obtenez le fichier et son plan complet en un seul appel. Sans cette option, la commande renvoie 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 ou l’autre option, jamais les deux.
Les formats texte sont transmis directement dans la requête. Les formats binaires (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML et ZIP) sont automatiquement téléversés au moyen d’un formulaire multipart. Pour PDF, la version 0.3.4 ou ultérieure est nécessaire ; pour .idml, il faut la version 0.3.5 ou ultérieure. --url indique que l’argument est une URL HTTPS que l’API récupère côté serveur. --name définit le nom de fichier enregistré par l’API, notamment lorsque le fichier local porte un nom temporaire. --idempotency-key (version 0.4.0 ou ultérieure) identifie la tentative : si la réponse est perdue et que vous relancez la même commande avec la même clé, vous récupérez le premier lot au lieu d’en créer un second. Si vous réutilisez la même clé avec un autre fichier, la commande renvoie idempotency_key_reused.
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.csvLes traductions archivées sont exclues, sauf si vous passez --archived. --search recherche dans le nom de la traduction ou celui du fichier téléversé. --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 précédente, ou --all pour parcourir toutes les pages. Consultez la pagination. download --output - écrit le fichier CSV sur la sortie standard.
Glossaires
Les paires de langues s’écrivent en accolant les balises prises en charge, par exemple 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-frLes données peuvent être fournies sous forme de fichier CSV à deux colonnes ou de dictionnaire de termes JSON. Les commandes d’ajout et de suppression ne modifient que les termes indiqués. replace supprime tous les termes absents du fichier ; delete supprime tout le glossaire. Dans un terminal interactif, les commandes destructives demandent confirmation. En mode non interactif, elles exigent l’option --force.
--expand-terms inclut les termes de chaque glossaire dans la liste et limite la page à 10 résultats.
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 action, modèle et environnement sont facultatifs. N’incluez pas de clés API, de jetons, d’URL signées ni le contenu intégral d’un fichier. Cette commande sert uniquement à transmettre des commentaires 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 logoutLa déconnexion efface les identifiants enregistrés et les révoque côté serveur lorsque leur 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 zshaiglot api envoie une requête authentifiée directe. Vous pouvez ainsi utiliser un nouvel endpoint REST avant qu’une commande dédiée soit disponible. --data accepte du JSON 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 les identifiants. aiglot mcp fait office de passerelle entre les clients MCP locaux utilisant uniquement stdio et le serveur HTTP distant de AI Glot.