@lingo.dev/cli
@lingo.dev/cli envía tu contenido fuente a un motor de localización, que lo traduce en el servidor y vuelve a escribir los resultados en disco, en el mismo comando con --wait o más tarde con lingo pull. Sustituye al flujo heredado de npx lingo.dev: mismo proyecto, pero una arquitectura totalmente distinta.
Qué ha cambiado frente a la CLI heredada#
La CLI heredada (npx lingo.dev run) extraía cadenas, llamaba directamente a un LLM desde tu máquina y escribía los archivos de una sola pasada en local. La CLI actual divide el trabajo en push y pull:
lingo pushsube las fuentes a tu motor, pone en marcha un flujo de trabajo del lado del servidor y espera a que termine o devuelve al instante un ID de ejecuciónlingo pullrecupera los resultados del push más reciente. Funciona aunque hayas cerrado el terminal a mitad de la traducción, siempre que hagas pull en la misma máquina y desde el mismo checkout.- Un lockfile (
.lingo/lock.json) registra la última versión de cada destino conocida por el servidor para que la detección de conflictos pueda avisarte de ediciones locales antes de que se sobrescriban
Esto permite algo que la CLI heredada no podía hacer: traducciones largas sin dejar el terminal colgado. Haz push, cierra el terminal y recupera los resultados más tarde.
Esperar los resultados#
lingo push sube las fuentes, inicia el flujo de trabajo en el servidor y sale en cuanto se envía la ejecución; no espera a que terminen las traducciones ni escribe los resultados. Recógelos con lingo pull o añade --wait (-w) para hacerlo todo en un solo comando.
lingo push # submit the run and exit (default)
lingo pull # later: re-attach to the most recent push and download its outputs
lingo push --wait # submit, wait, and write outputs in one command--wait(-w) bloquea hasta que termine el flujo de trabajo y escribe los resultados en el mismo comando.lingo pullvuelve a enlazarse con el push más reciente de este proyecto y descarga sus resultados. Funciona incluso después de cerrar el terminal. El estado de la ejecución se guarda por máquina en~/.lingo/runs/<project-hash>.json, asociado a la ruta del proyecto, así quepullretoma el proceso en la misma máquina y desde el mismo checkout.
Autenticación: ambos comandos leen LINGO_API_KEY (o --api-key, o una sesión de lingo login). En CI, configura LINGO_API_KEY y no necesitas nada más.
Modos de push#
| Comando | Modo | Cuándo |
|---|---|---|
lingo push | Incremental: compara las fuentes con .lingo/lock.json, traduce solo las claves nuevas o modificadas en los destinos existentes y conserva el resto | Para las ejecuciones habituales (añade --wait en CI) |
lingo push --backfill-missing | Bootstrap: rellena los ARCHIVOS de destino que aún no existen | Primer push o después de añadir un idioma nuevo |
lingo push --force | Retraducción completa: sobrescribe todos los destinos (incluidas las ediciones manuales); --yes/-y omite la confirmación | En contadas ocasiones (p. ej., tras un cambio en el glosario o en el motor) |
--backfill-missing es una bandera de bootstrap. Lanza una solicitud nueva con un alcance acotado y solo añade archivos de destino completos que faltan; NO traduce claves recién añadidas en archivos ya traducidos (la ejecución muestra "already up-to-date" y la clave se omite). Para cambios continuos, usa lingo push sin opciones.
Editar traducciones a mano#
lingo push sin opciones conserva las ediciones manuales por clave:
- Edita una cadena de destino (sin cambios en su fuente) → esa cadena se conserva; las demás claves siguen actualizándose.
- Cambia la fuente de una clave editada → se genera una traducción nueva para esa clave, sustituyendo la edición manual.
- Se añade una nueva clave fuente → se traduce y se añade, incluso en archivos con ediciones manuales.