Comandos de la CLI

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

Cuenta y uso

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

Si no indicas fechas, usage devuelve los últimos 30 días. Puedes usar el formato YYYY-MM-DD o 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

Iniciar una traducción requiere tres llamadas, no una, porque primero hay que revisar el plan y después pagarlo. create lee el archivo, plan convierte tus instrucciones en un plan con precio y approve lo confirma.

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>

Si pasas --instruction a create, obtendrás el archivo y el plan completo en una sola llamada. Si no, recibirás el archivo y varias sugerencias entre las que elegir. plan --instruction crea un plan si todavía no existe; plan --refine modifica el plan existente. Usa una opción u otra, nunca ambas.

Los formatos de texto se envían directamente; los archivos binarios (Excel, OpenDocument, Word, PowerPoint, EPUB, PDF y ZIP) se suben automáticamente como datos de formulario multipart. Para PDF se necesita la versión 0.3.4 o posterior. --url indica que el argumento es 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.

Traducciones 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

Las traducciones archivadas no se incluyen, salvo que pases --archived. --search busca en el nombre de la traducción o en el del archivo subido; --quality-tier solo acepta standard o lite. --created-after y --created-before admiten el formato 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 todas las páginas. Consulta paginación. download --output - escribe el CSV en la salida estándar.

Glosarios

Los pares de idiomas se indican con las etiquetas admitidas concatenadas, por ejemplo, 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

Puedes usar un CSV de dos columnas o un mapa de términos JSON. Añadir y eliminar son operaciones puntuales. Reemplazar elimina todos los términos que no aparecen en el archivo; eliminar suprime el glosario completo. Los comandos destructivos piden confirmación en un terminal interactivo y requieren --force si se usan 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 usas 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"

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

Autenticación

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 elimina la credencial guardada y se revoca en el servidor si el tipo de credencial permite revocarla.

Alternativas y utilidades

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