CLI-Befehle

Führen Sie aiglot help --json aus, um eine maschinenlesbare Beschreibung des installierten Befehlsbaums abzurufen.

Konto und Nutzung

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 vollständige ISO-Zeitstempel angeben.

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

Übersetzung starten

Zum Starten einer Übersetzung sind drei Aufrufe nötig, nicht nur einer. So wird der Plan geprüft, bevor dafür bezahlt wird. create liest die Datei ein, plan erstellt aus Ihrer Anweisung einen kostenpflichtigen Plan und approve gibt ihn frei.

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>

Wenn Sie create mit --instruction aufrufen, 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 einen 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 und ZIP) werden automatisch als Multipart-Formulardaten hochgeladen. Für PDF ist Version 0.3.4 oder höher erforderlich. 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, wenn die lokale Datei einen temporären Namen hat.

Bestehende Übersetzungen

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 sucht im Übersetzungsnamen und im Namen der hochgeladenen Datei. Für --quality-tier sind nur standard und 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 Seiten abzurufen. Weitere Informationen finden Sie unter Paginierung. download --output - schreibt die CSV-Datei in die Standardausgabe.

Glossare

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

Als Eingabe ist 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. In interaktiven Terminals fragen destruktive Befehle nach einer Bestätigung. Bei nicht interaktiver Verwendung ist --force erforderlich.

--expand-terms fügt die Begriffe jedes Glossars in die Liste ein und begrenzt die Seitengröße auf 10.

Feedback

Melden Sie bei der Nutzung von AI Glot ein Problem oder schlagen Sie eine Verbesserung vor:

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 erfasst lediglich Feedback und verbraucht kein Guthaben.

Authentifizierung

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 der jeweilige Zugangstyp einen Widerruf unterstützt.

Direkte API-Aufrufe und Hilfsprogramme

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 authentifizierte API-Aufrufe direkt. So können Sie neue REST-Endpunkte nutzen, bevor dafür ein eigener Befehl verfügbar ist. --data akzeptiert Inline-JSON, @file oder - zum Einlesen aus der Standardeingabe. --header "Name: value" kann mehrfach verwendet werden, aber nicht für Authorization, da die CLI die Zugangsdaten selbst übermittelt. aiglot mcp verbindet lokale MCP-Clients, die nur Standard-Ein-/Ausgabe unterstützen, mit dem entfernten HTTP-Server von AI Glot.