Comandos de la CLI

Ejecute aiglot help --json para obtener una descripción legible por máquina 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

Sin fechas, usage devuelve los últimos 30 días. Las fechas aceptan el formato YYYY-MM-DD o marcas de tiempo ISO completas.

languages es el único comando que funciona sin credenciales, permitiendo que un agente valide una etiqueta de idioma contra el catálogo antes de autenticarse o escribir un glosario.

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 se excluyen a menos 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.

Utilice --cursor con el next_cursor de la respuesta de lista anterior, o --all para seguir el cursor hasta el final; consulte paginación. El comando download --output - escribe el CSV en la salida estándar.

Glosarios

Los pares de idiomas utilizan etiquetas compatibles 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

La entrada puede ser un CSV de dos columnas o un mapa de términos JSON. Los comandos add y remove son quirúrgicos. replace elimina cualquier término ausente en el archivo; delete elimina el glosario completo. Los comandos destructivos solicitan confirmación en una terminal interactiva y requieren --force en entornos no interactivos.

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

Autenticación

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

logout olvida la credencial almacenada y la revoca en el servidor si el tipo de credencial admite la revocación.

Alternativas directas 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 solicitud autenticada directa, permitiendo usar un nuevo endpoint de REST antes de que exista un comando dedicado. --data acepta JSON en línea, @archivo o - para leer la entrada estándar. --header "Nombre: valor" se puede repetir, pero no puede establecer Authorization, ya que la CLI proporciona la credencial automáticamente. aiglot mcp conecta clientes MCP locales (solo stdio) con el servidor HTTP remoto de AI Glot.