CLI-Befehle

Führen Sie aiglot help --json aus, um eine maschinenlesbare Beschreibung zu erhalten, die aus dem installierten Befehlsbaum generiert wird.

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 aus. Daten werden im Format YYYY-MM-DD oder als vollständige ISO-Zeitstempel akzeptiert.

languages ist der einzige Befehl, der völlig ohne Anmeldedaten funktioniert. So kann ein Agent einen Sprach-Tag gegen den Katalog validieren, bevor eine Authentifizierung erfolgt oder ein Glossar erstellt wird.

Eine Übersetzung starten

Das Starten einer Übersetzung umfasst drei Aufrufe, keinen einzelnen, da der Plan eingesehen werden soll, bevor er bezahlt wird. create liest die Datei, plan wandelt Ihre Anweisung in einen bepreisten Plan um, approve bestätigt die Ausführung.

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

Die Übergabe von --instruction an create gibt die Datei und den vollständigen Plan in einem einzigen Aufruf zurück. Ohne diesen Parameter erhalten Sie die Datei und eine Auswahl an Vorschlägen. plan --instruction erstellt einen Plan, sofern noch keiner vorhanden ist; plan --refine bearbeitet den bestehenden Plan. Verwenden Sie daher entweder das eine oder das andere, niemals beides.

--url behandelt das Argument als HTTPS-URL, die die API serverseitig abruft. --name legt den Dateinamen fest, den die API registriert, 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 ausgeschlossen, es sei denn, --archived wird übergeben. --search gleicht den Namen der Übersetzung oder den Namen der hochgeladenen Datei ab, und --quality-tier akzeptiert nur standard oder lite. --created-after und --created-before akzeptieren YYYY-MM-DD oder einen vollständigen ISO-Zeitstempel.

Verwenden Sie --cursor mit dem next_cursor aus der vorherigen Listenantwort oder --all, um dem Cursor bis zum Ende zu folgen. Siehe Pagination. download --output - schreibt die CSV in die Standardausgabe.

Glossare

Sprachpaare verwenden unterstützte, zusammengefügte Tags, wie 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

Die Eingabe kann eine zwei-spaltige CSV oder eine JSON-Term-Map sein. Add und remove sind punktuelle Eingriffe. Replace löscht jeden Begriff, der in der Datei fehlt; delete entfernt das gesamte Glossar. Destruktive Befehle fordern in einem interaktiven Terminal eine Bestätigung an und erfordern bei nicht-interaktiver Nutzung --force.

--expand-terms schließt die Begriffe jedes Glossars in die Auflistung ein und begrenzt die Seite auf 10 Einträge.

Authentifizierung

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

Logout löscht die gespeicherten Anmeldedaten und widerruft diese serverseitig, sofern der Typ der Anmeldedaten einen Widerruf unterstützt.

Escape-Hatches 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 führt eine rohe authentifizierte Anfrage aus, sodass ein neuer REST-Endpunkt nutzbar ist, bevor ein dedizierter Befehl existiert. --data akzeptiert Inline-JSON, @datei oder - zum Lesen der Standardeingabe. --header "Name: value" kann mehrfach angegeben werden, kann aber nicht Authorization setzen, da die CLI die Anmeldedaten selbst bereitstellt. aiglot mcp verbindet lokale, reine stdio-MCP-Clients mit dem Remote-HTTP-Server von AI Glot.