AI Glot websiteOpen AI Glot
CLI e MCPComandos da CLI

Comandos da CLI

Use todos os comandos da CLI do AI Glot para iniciar uma tradução, gerenciar traduções existentes e cuidar de contas, uso, glossários, consulta de idiomas, acesso direto à API e integração com MCP.

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

Conta e uso

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

Sem informar datas, usage retorna os últimos 30 dias. As datas podem estar no formato YYYY-MM-DD ou ser timestamps ISO completos.

languages é o único comando que funciona sem nenhuma credencial. Assim, um agente pode validar uma tag de idioma no catálogo antes de 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 analisado 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.

Terminal
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 create ./products.csv --idempotency-key import-2026-10-16
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> --yes
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 essa opção, recebe o arquivo e uma lista de sugestões para escolher. plan --instruction cria um plano quando ainda não há nenhum; plan --refine edita o plano existente. Use uma opção ou outra, nunca as duas.

Os formatos de texto são enviados diretamente na chamada; os formatos binários (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML e ZIP) são enviados automaticamente como dados de formulário multipart. Para PDF, é necessária a versão 0.3.4 ou posterior; para .idml, a versão 0.3.5 ou posterior. --url interpreta o argumento como uma URL HTTPS que a API busca no servidor. --name define o nome de arquivo registrado pela API, caso o arquivo local tenha um nome temporário. --idempotency-key (versão 0.4.0 ou posterior) identifica a tentativa: se a resposta se perder e você executar o mesmo comando novamente com a mesma chave, receberá o primeiro lote, em vez de criar outro. Se a mesma chave for usada com um arquivo diferente, o comando retornará idempotency_key_reused.

Traduções existentes

Terminal
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 ficam de fora, a menos que você passe --archived. --search procura 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 tags aceitas concatenadas, como en-US-fr.

Terminal
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 constam no arquivo; excluir remove o glossário inteiro. Em um terminal interativo, comandos destrutivos pedem confirmação. Em usos não interativos, 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:

Terminal
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 ambiente são opcionais. Não inclua chaves de API, tokens, URLs assinadas nem o conteúdo completo dos arquivos. O comando apenas registra o feedback e não consome créditos.

Autenticação

Terminal
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, quando o tipo de credencial permite revogação.

Acesso direto e utilitários

Terminal
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 à API, permitindo usar um novo endpoint REST antes da criação de um comando específico. --data aceita JSON na linha de comando, @file ou - para ler da entrada padrão. É possível repetir --header "Name: value", mas não usá-lo para definir Authorization, pois a CLI fornece a própria credencial. aiglot mcp conecta clientes MCP locais que usam apenas stdio ao servidor HTTP remoto do AI Glot.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search AI Glot Docs documentation and read it in full, instead of answering from memory.

https://ai-glot.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://ai-glot.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.