Comandos CLI

Documentación de referencia para los comandos CLI de Lingo.dev

Esta página contiene la lista completa de comandos disponibles a través de la CLI de Lingo.dev. Para acceder a esta documentación desde la propia CLI, ejecuta el siguiente comando:

npx lingo.dev@latest --help

lingo.dev

Usage: lingo.dev [options] [command]

Lingo.dev CLI

Options:
  -v, --version         Mostrar versión
  -y, --no-interactive  Desactivar modo interactivo
  -h, --help            Mostrar ayuda

Commands:
  init [options]        Inicializar proyecto Lingo.dev
  i18n [options]        Ejecutar motor de localización
  auth [options]        Mostrar estado de autenticación actual
  login                 Autenticarse con la API de Lingo.dev
  logout                Cerrar sesión de la API de Lingo.dev
  show                  Imprimir la configuración actual
  config                Gestionar la configuración de la CLI de Lingo.dev
  lockfile [options]    Crear un archivo de bloqueo si no existe
  cleanup [options]     Eliminar claves de los archivos de destino que no existen en el
                        archivo fuente
  mcp                   Usar el proveedor de contexto de modelo de Lingo.dev con tu agente de IA
  ci [options]          Ejecutar acción de CI/CD de Lingo.dev
  status [options]      Mostrar el estado del proceso de localización
  run [options]         Ejecutar el motor de localización de Lingo.dev
  purge [options]       Eliminar traducciones para el --bucket, --file, --key,
                        --locale especificados
  help [command]        mostrar ayuda para el comando

lingo.dev init

Usage: lingo.dev init [options]

Inicializar proyecto Lingo.dev

Options:
  -f --force                Sobrescribir configuración existente (default: false)
  -s --source <locale>      Locale de origen (default: "en")
  -t --targets <locale...>  Lista de locales de destino (default: "es")
  -b, --bucket <type>       Tipo de bucket (default: "json")
  -p, --paths [path...]     Lista de rutas para el bucket (default: [])
  -y, --no-interactive      Desactivar modo interactivo
  -h, --help                Mostrar ayuda

lingo.dev i18n

Usage: lingo.dev i18n [options]

Ejecutar motor de localización

Options:
  --locale <locale>    Locale a procesar
  --bucket <bucket>    Bucket a procesar
  --key <key>          Clave a procesar. Procesa solo una clave de traducción específica,
                       útil para depuración o actualización de una sola entrada
  --file [files...]    Archivo a procesar. Procesa solo una ruta específica, puede
                       contener asterisco * para coincidir con múltiples archivos. Útil si
                       tienes muchos archivos y quieres enfocarte en uno específico.
                       Especifica más archivos separados por comas o espacios.
  --frozen             Ejecutar en modo de solo lectura - falla si alguna traducción necesita
                       actualización, útil para pipelines de CI/CD para detectar traducciones faltantes
  --force              Ignorar archivo de bloqueo y procesar todas las claves, útil para
                       retraducción completa
  --verbose            Mostrar salida detallada incluyendo datos de procesamiento intermedio
                       y detalles de comunicación con la API
  --interactive        Habilitar modo interactivo para revisar y editar traducciones
                       antes de que sean aplicadas
  --api-key <api-key>  Establecer explícitamente la clave API a usar, anula la clave API
                       predeterminada de la configuración
  --debug              Pausar la ejecución al inicio para propósitos de depuración, espera
                       confirmación del usuario antes de continuar
  --strict             Detener el procesamiento al primer error en lugar de continuar
                       con otros locales/buckets
  -h, --help           Mostrar ayuda

lingo.dev auth

Uso: lingo.dev auth [opciones]

Mostrar el estado actual de autenticación

Opciones:
  --login     Iniciar sesión en tu cuenta (obsoleto: usa 'lingo.dev login' en su lugar)
  --logout    Cerrar sesión de tu cuenta (obsoleto: usa 'lingo.dev logout'
              en su lugar)
  -h, --help  Mostrar ayuda

lingo.dev login

Uso: lingo.dev login [opciones]

Autenticarse con la API de Lingo.dev

Opciones:
  -h, --help  Mostrar ayuda

lingo.dev logout

Uso: lingo.dev logout [opciones]

Cerrar sesión de la API de Lingo.dev

Opciones:
  -h, --help  Mostrar ayuda

lingo.dev show

Uso: lingo.dev show [opciones] [comando]

Muestra la configuración actual

Opciones:
  -h, --help       Mostrar ayuda

Comandos:
  config           Mostrar la configuración actual
  locale <tipo>    Mostrar la lista de locales
  files [opciones] Mostrar la lista de archivos gestionados por Lingo.dev
  help [comando]   mostrar ayuda para el comando

lingo.dev show config

Uso: lingo.dev show config [opciones]

Mostrar la configuración actual

Opciones:
  -h, --help  Mostrar ayuda

lingo.dev show locale

Uso: lingo.dev show locale [opciones] <tipo>

Mostrar la lista de locales

Argumentos:
  tipo        Tipo de locales a mostrar, ya sea "sources" o "targets"

Opciones:
  -h, --help  Mostrar ayuda

lingo.dev show files

Uso: lingo.dev show files [opciones]

Mostrar la lista de archivos gestionados por Lingo.dev

Opciones:
  --source    Mostrar solo archivos fuente, archivos que contienen las
              traducciones originales
  --target    Mostrar solo archivos destino, archivos que contienen contenido traducido
  -h, --help  Mostrar ayuda

lingo.dev config

Uso: lingo.dev config [opciones] [comando]

Gestionar la configuración de la CLI de Lingo.dev

Opciones:
  -h, --help         Mostrar ayuda

Comandos:
  set <clave> <valor> Establecer una clave de configuración a un valor
  unset <clave>       Eliminar una clave de configuración
  get <clave>         Obtener el valor de una clave de configuración
  help [comando]      mostrar ayuda para el comando

lingo.dev config set

Usage: lingo.dev config set [options] <key> <value>

Establecer una clave de configuración a un valor

Arguments:
  key         Clave de configuración a establecer
  value       Nuevo valor

Options:
  -h, --help  Mostrar ayuda

lingo.dev config unset

Usage: lingo.dev config unset [options] <key>

Eliminar una clave de configuración

Arguments:
  key         Clave de configuración a eliminar

Options:
  -h, --help  Mostrar ayuda

lingo.dev config get

Usage: lingo.dev config get [options] <key>

Obtener el valor de una clave de configuración

Arguments:
  key         Clave de configuración

Options:
  -h, --help  Mostrar ayuda

lingo.dev lockfile

Usage: lingo.dev lockfile [options]

Crear un archivo de bloqueo si no existe

Options:
  -f, --force  Forzar la creación de un archivo de bloqueo
  -h, --help   Mostrar ayuda

lingo.dev cleanup

Usage: lingo.dev cleanup [options]

Eliminar claves de los archivos de destino que no existen en el archivo fuente

Options:
  --locale <locale>  Localización específica para limpiar
  --bucket <bucket>  Bucket específico para limpiar
  --dry-run          Mostrar lo que se eliminaría sin realizar cambios
  --verbose          Mostrar salida detallada incluyendo:
    - Lista de claves que serían eliminadas.
    - Pasos de procesamiento.
  -h, --help         Mostrar ayuda

lingo.dev mcp

Usage: lingo.dev mcp [options]

Utilizar el proveedor de contexto de modelo de Lingo.dev con su agente de IA

Options:
  -h, --help  Mostrar ayuda

lingo.dev ci

Usage: lingo.dev ci [options]

Ejecutar acción de CI/CD de Lingo.dev

Options:
  --parallel [boolean]             Ejecutar en modo paralelo
  --api-key <key>                  Clave API
  --pull-request [boolean]         Crear una solicitud de extracción con los cambios
  --commit-message <message>       Mensaje de commit
  --pull-request-title <title>     Título de la solicitud de extracción
  --working-directory <dir>        Directorio de trabajo
  --process-own-commits [boolean]  Procesar commits realizados por esta acción
  -h, --help                       Mostrar ayuda

lingo.dev status

Usage: lingo.dev status [options]

Mostrar el estado del proceso de localización

Options:
  --locale <locale>    Localización a procesar
  --bucket <bucket>    Bucket a procesar
  --file [files...]    Archivo a procesar. Procesa solo los archivos que incluyen esta
                       cadena en su ruta. Útil si tienes muchos archivos
                       y quieres centrarte en uno específico. Especifica más archivos
                       separados por comas o espacios.
  --force              Ignorar el archivo de bloqueo y procesar todas las claves, útil para
                       estimar una retraducción completa
  --verbose            Mostrar salida detallada incluyendo recuentos de palabras a nivel de clave
  --api-key <api-key>  Establecer explícitamente la clave API a utilizar, anula la clave
                       API predeterminada de la configuración
  -h, --help           Mostrar ayuda

lingo.dev may-the-fourth

Usage: lingo.dev may-the-fourth [options]

Que la Fuerza te acompañe

Options:
  -h, --help  Mostrar ayuda

lingo.dev run

Usage: lingo.dev run [options]

Ejecutar el motor de localización de Lingo.dev

Options:
  --source-locale <source-locale>  Localización a usar como localización fuente. Por defecto es
                                   i18n.json locale.source
  --target-locale <target-locale>  Localización a usar como localización destino. Por defecto es
                                   i18n.json locale.targets
  --bucket <bucket>                Bucket a procesar
  --file <file>                    Archivo a procesar. Procesa solo los archivos que
                                   coinciden con este patrón glob en su ruta. Usa
                                   comillas alrededor de los patrones para evitar la expansión del shell
                                   (p.ej., --file '**/*.json'). Útil
                                   si tienes muchos archivos y quieres centrarte
                                   en uno específico. Especifica más archivos
                                   separados por comas o espacios. Acepta patrones
                                   glob.
  --key <key>                      Clave a procesar. Procesa solo una clave de
                                   traducción específica, útil para actualizar una
                                   sola entrada. Acepta patrones glob.
  --force                          Ignorar el archivo de bloqueo y procesar todas las claves, útil
                                   para una retraducción completa
  --api-key <api-key>              Establecer explícitamente la clave API a utilizar, anula
                                   la clave API predeterminada de la configuración
  --debug                          Pausar la ejecución al inicio para propósitos de
                                   depuración, espera la confirmación del usuario antes
                                   de continuar
  --concurrency <concurrency>      Número de tareas concurrentes a ejecutar
  --watch                          Vigilar los archivos fuente para detectar cambios y
                                   retraducir automáticamente
  --debounce <milliseconds>        Retraso de debounce en milisegundos para el modo
                                   de vigilancia (por defecto: 5000ms)
  -h, --help                       Mostrar ayuda

lingo.dev purge

Uso: lingo.dev purge [opciones]

Eliminar traducciones para el --bucket, --file, --key, --locale especificados

Opciones:
  --bucket <bucket>  Bucket a procesar
  --file [files...]  Archivo(s) a procesar. Solo procesa archivos que coincidan con
                     el/los patrón(es) glob proporcionado(s).
  --key <key>        Clave a eliminar. Elimina todas las claves de traducción que coincidan con
                     el patrón glob proporcionado.
  --locale <locale>  Locale a procesar
  --yes-really       Omite la confirmación interactiva y elimina sin preguntar.
  -h, --help         Mostrar ayuda