---
title: "Comandos da CLI"
description: "Use todos os comandos da CLI do AI Glot para contas, uso, traduções existentes, glossários, busca de idiomas, acesso bruto à API e ponte MCP."
canonical: "https://ai-glot.com/docs/pt/cli/commands"
updated: "2026-08-12"
---

# Comandos da CLI

Execute `aiglot help --json` para obter uma descrição legível por máquina gerada a partir da árvore de comandos instalada.

## Conta e uso

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

Sem datas, o comando `usage` retorna os últimos 30 dias. As datas aceitam o formato `AAAA-MM-DD` ou timestamps ISO completos.

`languages` é o único comando que funciona sem qualquer credencial, permitindo que um agente valide uma tag de idioma no catálogo antes de se autenticar ou de criar um glossário.

## Traduções existentes

```bash
aiglot batches list --status completed --limit 50
aiglot batches list --archived --search "catálogo de produtos"
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> "Catálogo de produtos em Francês"
aiglot batches archive <id>
aiglot batches archive <id> --undo
aiglot batches download <id> --output ./translated.csv
```

Traduções arquivadas são excluídas a menos que `--archived` seja passado. `--search` busca no nome da tradução ou no nome do arquivo enviado, e `--quality-tier` aceita apenas `standard` ou `lite`. `--created-after` e `--created-before` aceitam `AAAA-MM-DD` ou um timestamp ISO completo.

Use `--cursor` com o `next_cursor` da resposta de lista anterior, ou `--all` para seguir o cursor até o fim — veja [paginação](/docs/cli/automation#pagination). O comando `download --output -` escreve o CSV na saída padrão.

> **Info: Criado no app web**
>
> Estes comandos operam traduções já criadas através do app web. A CLI não pode fazer upload ou iniciar traduções na v1.

## Glossários

Os pares de idiomas usam tags suportadas unidas, como `en-US-fr`.

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

A entrada pode ser um CSV de duas colunas ou um mapa de termos JSON. `add` e `remove` são precisos (cirúrgicos). `replace` deleta todos os termos ausentes no arquivo; `delete` remove o glossário completo. Comandos destrutivos solicitam confirmação em terminais interativos e exigem `--force` em uso não interativo.

`--expand-terms` inclui os termos de cada glossário na listagem e limita a página a 10 itens.

> **Warning: Pré-visualize um replace antes de executá-lo**
>
> O comando `glossaries replace --dry-run` lê o glossário, compara-o com o seu arquivo localmente e imprime o que seria alterado sem enviar nada ao servidor. Ele lista os termos exatos em `removed_terms` — aqueles que seriam deletados por estarem ausentes no seu arquivo. Esta é a única rede de segurança para o comando que deleta termos que o usuário não nomeou explicitamente; execute-o primeiro e pare se a lista for maior do que o esperado.

## Autenticação

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

O `logout` remove a credencial armazenada e a revoga no servidor, quando o tipo de credencial suporta revogação.

## Utilitários e acesso direto (Escape hatches)

```bash
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` faz uma requisição autenticada bruta, permitindo que um novo endpoint REST seja utilizado antes mesmo de existir um comando dedicado. `--data` aceita JSON inline, `@arquivo` ou `-` para ler a entrada padrão. `--header "Nome: valor"` pode ser repetido, mas não pode definir `Authorization`, pois a CLI fornece a credencial automaticamente. `aiglot mcp` conecta clientes MCP locais (apenas stdio) ao servidor HTTP remoto do AI Glot.