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, usage retorna os últimos 30 dias. As datas aceitam YYYY-MM-DD ou timestamps ISO completos.

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

Iniciar uma tradução

Iniciar uma tradução exige três chamadas, não uma, porque o plano deve ser consultado antes de ser pago. create lê o arquivo, plan transforma sua instrução em um plano com preço definido e approve confirma a operação.

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

Ao passar --instruction para create, você recebe o arquivo e o plano completo em uma única chamada. Sem esse parâmetro, recebe o arquivo e uma lista de sugestões para escolher. plan --instruction cria um plano quando ainda não existe nenhum; plan --refine edita o plano existente. Passe um ou outro, nunca os dois.

Os formatos de texto são enviados no corpo da chamada; os formatos binários (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF e ZIP) são enviados automaticamente como dados de formulário multipart. PDF requer a versão 0.3.4 ou posterior. --url indica que o argumento é uma URL HTTPS que a API buscará no servidor. --name define o nome de arquivo registrado pela API, útil quando o arquivo local tem um nome temporário.

Traduções existentes

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

As traduções arquivadas não são incluídas, a menos que você passe --archived. --search busca pelo nome da tradução ou pelo nome do arquivo enviado, e --quality-tier aceita apenas standard ou lite. --created-after e --created-before aceitam YYYY-MM-DD ou um timestamp ISO completo.

Use --cursor com o next_cursor da resposta da listagem anterior ou --all para percorrer todas as páginas. Consulte paginação. download --output - envia o CSV para a saída padrão.

Glossários

Os pares de idiomas usam etiquetas compatíveis concatenadas, 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 em JSON. Adicionar e remover alteram apenas os termos indicados. Substituir exclui todos os termos que não estejam no arquivo; excluir remove o glossário inteiro. Em um terminal interativo, os comandos destrutivos pedem confirmação. Em modo não interativo, exigem --force.

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

Feedback

Relate um problema ou sugira uma melhoria durante o uso do 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"

Os três campos principais aceitam texto livre. Os campos de ação, modelo e harness são opcionais. Não inclua chaves de API, tokens, URLs assinadas nem o conteúdo integral de arquivos. O comando apenas registra o feedback e não consome créditos.

Autenticação

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

O logout apaga a credencial armazenada e a revoga no servidor, se o tipo de credencial permitir revogação.

Alternativas e utilitários

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 solicitação autenticada diretamente, permitindo usar um novo endpoint REST antes que exista um comando específico para ele. --data aceita JSON em linha, @file ou - para ler da entrada padrão. É possível repetir --header "Name: value", mas não definir Authorization, pois a CLI fornece a credencial automaticamente. aiglot mcp conecta clientes MCP locais que usam apenas stdio ao servidor HTTP remoto do AI Glot.