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

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

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. O comando download --output - escreve o CSV na saída padrão.

Glossários

Os pares de idiomas usam tags suportadas unidas, como 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

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.

Autenticação

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)

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.