---
title: "CLI commands"
description: "Use every AI Glot CLI command for accounts, usage, existing translations, glossaries, language lookup, raw API access and MCP bridging."
canonical: "https://ai-glot.com/docs/cli/commands"
updated: "2026-08-09"
---

# CLI commands

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

## Account and usage

```bash
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.

## Existing translations

```bash
aiglot batches list --status completed --limit 50
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
```

Use `--cursor` with the `next_cursor` from the previous list response. `download --output -` writes the CSV to standard output.

> **Info: Created in the web app**
>
> These commands operate translations already created through the web app. The CLI cannot upload or start one in v1.

## Glossaries

Language pairs use supported tags joined together, such as `en-US-fr`.

```bash
aiglot glossaries list
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
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.

## Authentication

```bash
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

```bash
aiglot api GET /v1/account
aiglot api PATCH /v1/batches/<id> --data '{"archived":true}'
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. `aiglot mcp` bridges local stdio-only MCP clients to AI Glot's remote HTTP server.