AI Glot websiteOpen AI Glot
CLI et MCPCommandes CLI

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

Terminal
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 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.

Terminal
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

Terminal
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 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.

Terminal
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 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 :

Terminal
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

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

La 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

Terminal
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 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.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.