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 YYYY-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 escrever um glossário.

Iniciar uma tradução

Iniciar uma tradução requer três chamadas, não apenas uma, pois o plano deve ser lido antes de ser pago. O create lê o arquivo, o plan transforma sua instrução em um plano com preço e o approve confirma a execução.

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>

Passar --instruction para o create retorna o arquivo e seu plano completo em uma única chamada. Sem isso, você recebe o arquivo e um conjunto de sugestões para escolher. plan --instruction escreve um plano onde não existe nenhum; plan --refine edita o plano já existente, portanto, use um ou outro, nunca ambos.

--url trata o argumento como uma URL HTTPS que a API busca no servidor. --name define o nome do arquivo que a API registra, caso o arquivo local tenha 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

Traduções arquivadas são excluídas a menos que --archived seja passado. --search corresponde ao nome da tradução ou ao 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 de lista anterior, ou --all para seguir o cursor até o fim. Veja paginação. download --output - escreve o CSV na saída padrão.

Glossários

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 operações cirúrgicas. replace deleta todo termo ausente do arquivo; delete remove o glossário completo. Comandos destrutivos solicitam confirmação em um terminal interativo e requerem --force em uso não interativo.

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

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 a revogação.

Recursos avançados 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 requisição autenticada bruta, permitindo que um novo endpoint REST seja usado antes que um comando dedicado exista. --data aceita JSON inline, @arquivo ou - para ler a entrada padrão. --header "Nome: valor" é repetível, mas não pode definir Authorization, pois a CLI fornece a credencial automaticamente. aiglot mcp faz a ponte entre clientes MCP locais apenas stdio e o servidor HTTP remoto do AI Glot.