AI Glot websiteOpen AI Glot
CLI y MCPComandos de la CLI

Comandos de la CLI

Utiliza todos los comandos de la CLI de AI Glot para iniciar una traducción, gestionar las existentes y administrar cuentas, uso, glosarios, consultas de idiomas, acceso directo a la API y conexión con MCP.

Ejecuta aiglot help --json para obtener una descripción legible por máquina generada a partir del árbol de comandos instalado.

Cuenta y uso

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

Si no se indican fechas, usage devuelve los últimos 30 días. Las fechas pueden especificarse como YYYY-MM-DD o como marcas de tiempo ISO completas.

languages es el único comando que funciona sin credenciales, por lo que un agente puede validar una etiqueta de idioma en el catálogo antes de autenticarse o de escribir un glosario.

Iniciar una traducción

Para iniciar una traducción hacen falta tres llamadas, no una, porque el plan debe consultarse antes de pagarlo. create lee el archivo, plan convierte tus instrucciones en un plan con precio y approve confirma el proceso.

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>

Si pasas --instruction a create, recibirás el archivo y el plan completo en una sola llamada. Si no lo haces, recibirás el archivo y varias sugerencias para elegir. plan --instruction crea un plan cuando todavía no existe; plan --refine modifica el plan existente. Pasa uno u otro, nunca ambos.

Los formatos de texto se envían en línea. Los formatos binarios (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF, InDesign IDML y ZIP) se suben automáticamente como datos de formulario multiparte. PDF requiere la versión 0.3.4 o posterior, e .idml, la versión 0.3.5 o posterior. --url interpreta el argumento como una URL HTTPS que la API obtiene desde el servidor. --name establece el nombre de archivo que registra la API, por si el archivo local tiene un nombre temporal. --idempotency-key (versión 0.4.0 o posterior) identifica el intento: si se pierde la respuesta y vuelves a ejecutar el mismo comando con la misma clave, recuperarás el primer lote en lugar de crear otro. Si reutilizas la misma clave con un archivo distinto, se devuelve idempotency_key_reused.

Traducciones 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

Las traducciones archivadas no se incluyen, salvo que se pase --archived. --search busca coincidencias en el nombre de la traducción o en el nombre del archivo subido, y --quality-tier solo acepta standard o lite. --created-after y --created-before aceptan YYYY-MM-DD o una marca de tiempo ISO completa.

Usa --cursor con el valor next_cursor de la respuesta de la lista anterior, o --all para recorrer todos los resultados. Consulta paginación. download --output - escribe el CSV en la salida estándar.

Glosarios

Los pares de idiomas se forman uniendo las etiquetas compatibles, por ejemplo, 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

La entrada puede ser un CSV de dos columnas o un mapa de términos en JSON. Las operaciones de añadir y eliminar son selectivas. La operación de reemplazo elimina todos los términos que no estén en el archivo; la operación de eliminación borra el glosario entero. Los comandos destructivos solicitan confirmación en un terminal interactivo y requieren --force si se ejecutan de forma no interactiva.

--expand-terms incluye los términos de cada glosario en el listado y limita la página a 10 elementos.

Comentarios

Informa de un problema o sugiere una mejora mientras utilizas 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"

Los tres campos principales admiten texto libre. Los campos de acción, modelo y entorno son opcionales. No incluyas claves de API, tokens, URL firmadas ni el contenido completo de archivos. El comando solo registra los comentarios y no consume créditos.

Autenticación

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

Al cerrar sesión se olvida la credencial almacenada y se revoca en el servidor si el tipo de credencial lo permite.

Alternativas y utilidades

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 realiza una solicitud autenticada directa, por lo que puedes utilizar un nuevo endpoint REST antes de que exista un comando específico. --data admite JSON en línea, @file o - para leer desde la entrada estándar. --header "Name: value" se puede repetir, pero no permite establecer Authorization, ya que la CLI proporciona la credencial. aiglot mcp conecta los clientes MCP locales que solo usan stdio con el servidor HTTP remoto de 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.