AI Glot websiteOpen AI Glot
CLI und MCPCLI-Befehle

CLI-Befehle

Nutzen Sie alle AI Glot-CLI-Befehle, um Übersetzungen zu starten, bestehende Übersetzungen zu verwalten und Konten, Nutzung, Glossare, Sprachsuche, direkten API-Zugriff und MCP-Bridging zu handhaben.

Führen Sie aiglot help --json aus, um eine maschinenlesbare Beschreibung der installierten Befehlsstruktur zu erhalten.

Konto und Nutzung

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

Ohne Datumsangaben gibt usage die letzten 30 Tage zurück. Als Datum können Sie YYYY-MM-DD oder einen vollständigen ISO-Zeitstempel angeben.

languages ist der einzige Befehl, der ganz ohne Zugangsdaten funktioniert. So kann ein Agent ein Sprach-Tag anhand des Katalogs überprüfen, bevor er sich authentifiziert oder ein Glossar erstellt.

Übersetzung starten

Zum Starten einer Übersetzung sind drei Aufrufe nötig, nicht einer. So kann der Plan geprüft werden, bevor Kosten anfallen. create liest die Datei ein, plan erstellt aus Ihrer Anweisung einen kostenpflichtigen Plan und approve gibt ihn zur Ausführung frei.

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>

Wenn Sie create die Option --instruction mitgeben, erhalten Sie die Datei und den vollständigen Plan in einem Aufruf. Ohne diese Option bekommen Sie die Datei und mehrere Vorschläge zur Auswahl. plan --instruction erstellt einen Plan, falls noch keiner vorhanden ist. plan --refine bearbeitet den bestehenden Plan. Verwenden Sie daher entweder die eine oder die andere Option, niemals beide.

Textformate werden direkt übermittelt. Binärformate (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML und ZIP) werden automatisch als multipart-Formulardaten hochgeladen. Für PDF ist Version 0.3.4 oder höher erforderlich, für .idml Version 0.3.5 oder höher. Mit --url wird das Argument als HTTPS-URL behandelt, die die API serverseitig abruft. Mit --name legen Sie den Dateinamen fest, unter dem die API die Datei speichert, etwa wenn die lokale Datei einen temporären Namen hat. --idempotency-key (ab Version 0.4.0) kennzeichnet den Auftrag: Geht die Antwort verloren und führen Sie denselben Befehl mit demselben Schlüssel erneut aus, erhalten Sie den ersten Batch zurück statt eines zweiten. Wird derselbe Schlüssel mit einer anderen Datei verwendet, erscheint idempotency_key_reused.

Bestehende Übersetzungen

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

Archivierte Übersetzungen werden nur angezeigt, wenn Sie --archived angeben. --search durchsucht den Übersetzungsnamen und den Namen der hochgeladenen Datei. Für --quality-tier sind nur standard oder lite zulässig. --created-after und --created-before akzeptieren YYYY-MM-DD oder einen vollständigen ISO-Zeitstempel.

Verwenden Sie --cursor mit dem Wert next_cursor aus der vorherigen Listenantwort oder --all, um alle Ergebnisse über den Cursor abzurufen. Siehe Paginierung. download --output - schreibt die CSV-Datei in die Standardausgabe.

Glossare

Sprachpaare bestehen aus aneinandergefügten unterstützten Sprach-Tags, zum Beispiel 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

Als Eingabe sind eine CSV-Datei mit zwei Spalten oder eine JSON-Begriffstabelle möglich. Mit „Hinzufügen“ und „Entfernen“ ändern Sie gezielt einzelne Einträge. „Ersetzen“ löscht alle Begriffe, die nicht in der Datei enthalten sind. „Löschen“ entfernt das gesamte Glossar. Bei destruktiven Befehlen ist in einem interaktiven Terminal eine Bestätigung erforderlich. Bei nicht-interaktiver Nutzung müssen Sie --force angeben.

--expand-terms zeigt die Begriffe der einzelnen Glossare in der Liste an und begrenzt die Anzahl pro Seite auf 10.

Feedback

Melden Sie ein Problem oder schlagen Sie eine Verbesserung vor, während Sie AI Glot verwenden:

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"

Die drei Hauptfelder sind Freitextfelder. Die Felder für Aktion, Modell und Harness sind optional. Geben Sie keine API-Schlüssel, Tokens, signierten URLs oder vollständigen Dateiinhalte an. Der Befehl übermittelt lediglich Feedback und verbraucht keine Credits.

Authentifizierung

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

Beim Abmelden werden die gespeicherten Zugangsdaten gelöscht und serverseitig widerrufen, sofern dieser Zugangsdaten-Typ einen Widerruf unterstützt.

Erweiterte Optionen und Dienstprogramme

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 sendet eine authentifizierte Anfrage direkt an die API. Dadurch können Sie neue REST-Endpunkte nutzen, bevor es dafür einen eigenen Befehl gibt. --data akzeptiert inline angegebenes JSON, @file oder -, um Daten aus der Standardeingabe zu lesen. --header "Name: value" kann mehrfach verwendet werden, aber nicht mit Authorization, da die CLI die Zugangsdaten selbst übermittelt. aiglot mcp verbindet lokale MCP-Clients, die ausschließlich stdio unterstützen, mit dem entfernten HTTP-Server von 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.