CLI commands

Run aiglot help --json for a machine-readable description generated from the installed command tree.

Account and usage

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

Without dates, usage returns the last 30 days. Dates accept YYYY-MM-DD or full ISO timestamps.

languages is the one command that works with no credential at all, so an agent can validate a language tag against the catalogue before authenticating or before writing a glossary.

Start a translation

Starting a translation is three calls, not one, because the plan is meant to be read before it is paid for. create reads the file, plan turns your instruction into a priced plan, approve commits.

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>

Passing --instruction to create returns the file and its full plan in one call. Without it you get the file and a set of suggestions to choose from. plan --instruction writes a plan where there is none; plan --refine edits the one already there, so pass one or the other, never both.

--url treats the argument as an HTTPS URL the API fetches server-side. --name sets the filename the API records, when the local file is named something temporary.

Existing translations

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

Archived translations are excluded unless --archived is passed. --search matches the translation name or the uploaded file name, and --quality-tier accepts only standard or lite. --created-after and --created-before accept YYYY-MM-DD or a full ISO timestamp.

Use --cursor with the next_cursor from the previous list response, or --all to follow the cursor to exhaustion. See pagination. download --output - writes the CSV to standard output.

Glossaries

Language pairs use supported tags joined together, such as 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

Input may be a two-column CSV or a JSON term map. Add and remove are surgical. Replace deletes every term absent from the file; delete removes the complete glossary. Destructive commands ask for confirmation on an interactive terminal and require --force in non-interactive use.

--expand-terms includes each glossary’s terms in the listing and clamps the page to 10.

Feedback

Report a problem or suggest an improvement while using 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"

The three main fields are open text. The action, model and harness fields are optional. Do not include API keys, tokens, signed URLs or full file contents. The command records feedback only and costs no credits.

Authentication

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

Logout forgets the stored credential and revokes it server-side when the credential type supports revocation.

Escape hatches and utilities

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 makes a raw authenticated request, so a new REST endpoint is usable before a dedicated command exists. --data takes inline JSON, @file, or - to read standard input. --header "Name: value" is repeatable but cannot set Authorization, because the CLI supplies the credential itself. aiglot mcp bridges local stdio-only MCP clients to AI Glot’s remote HTTP server.