Comandos de CLI

tyndale init

Inicializa un nuevo proyecto de Tyndale. Crea tyndale.config.json con valores predeterminados sensatos.

npx tyndale init

tyndale auth

Configura las credenciales de tu proveedor de AI.

npx tyndale auth

tyndale translate

Extrae cadenas traducibles y genera traducciones para todos los locales configurados.

npx tyndale translate [options]

Opción	Descripción
--locale <code>	Traduce solo un locale específico
--force	Vuelve a traducir todas las cadenas, no solo los cambios
--dry-run	Muestra qué se traduciría sin escribir archivos
--token-budget <n>	Presupuesto de tokens por lote de AI (predeterminado: 50000)
--concurrency <n>	Máximo de sesiones de traducción en paralelo (detectado automáticamente)

tyndale validate

Comprueba que todos los locales tengan traducciones completas y bien formadas. No se realizan llamadas a AI.

npx tyndale validate

Sale con código 1 si se encuentran problemas. Ideal para pipelines de CI.

tyndale extract

Extrae cadenas traducibles sin traducirlas. Útil para revisar qué se enviará al proveedor de AI.

npx tyndale extract

tyndale translate-docs

Traduce archivos de documentación (MDX/MD) para cualquier framework compatible. Detecta automáticamente tu framework de documentación o usa la configuración de tyndale.config.json.

npx tyndale translate-docs [options]

Opción	Descripción
--content-dir <path>	Sobrescribe el directorio de contenido de la documentación
--force	Vuelve a traducir toda la documentación, no solo los archivos faltantes
--concurrency <n>	Máximo de sesiones de traducción en paralelo (detectado automáticamente)

Frameworks compatibles: Starlight, Docusaurus, VitePress, MkDocs, Nextra.

translate-docs escribe .tyndale-docs-state.json en la raíz de tu proyecto para rastrear los hashes de los documentos fuente. Haz commit de este archivo para que los clones nuevos puedan omitir la documentación sin cambios sin volver a traducirla.

tyndale translate-docs setup

Detecta tu framework de documentación y guarda la configuración en tyndale.config.json.

npx tyndale translate-docs setup

Escanea tu proyecto en busca de señales del framework (dependencias de paquetes y archivos de configuración), confirma el framework detectado y escribe la sección docs en tu configuración.

tyndale model

Cambia el modelo de AI usado para las traducciones.

npx tyndale model