|
Documentación
Agenda una demoPlataforma
PlataformaMCPCLI
APIFlujos de trabajo
GuíasRegistro de cambios

Descripción general

  • @lingo.dev/cli

Primeros pasos

  • Inicio rápido
  • Configuración

Referencia

  • lingo push
  • lingo pull
  • Otros comandos
  • lingo purge

Configuración

  • Controles de claves
  • Formatos
  • Idiomas

Guías

  • Agregar un idioma
  • Traducciones existentes
  • Retraducción
  • Notas del traductor
  • Ejecuciones, estado y recuperación
  • CI/CD
  • Monorepos
  • Proyectos grandes

¿Buscas el CLI anterior (v0)? Consulta la documentación del CLI anterior

Otros comandos

Comandos de configuración e identidad. Ninguno toca el contenido fuente: solo administran credenciales y vinculaciones del proyecto.

lingo login#

Autentícate en Lingo.dev. Hay dos flujos:

OTP (predeterminado, interactivo)#

bash
lingo login
lingo login --email you@company.com           # skip the email prompt
lingo login --email you@company.com --code 123456   # skip the code prompt too

Envía un código de un solo uso a tu correo electrónico, lo verifica y guarda una sesión de Supabase en ~/.lingo/auth.json. Los tokens de actualización se almacenan junto a ella para que la sesión se mantenga activa entre una y otra hasta que ejecutes logout explícitamente.

Clave de API (CI / no interactivo)#

bash
lingo login --api-key lk_...

Guarda la clave de API. Genera las claves en la plataforma de Lingo.dev, dentro de la configuración de API keys de tu organización.

También puedes pasar --api-key como una bandera global en cualquier comando, lo que omite por completo las credenciales guardadas:

bash
lingo push --api-key lk_...

Ideal para jobs puntuales de CI que no deberían escribir credenciales en disco.

lingo logout#

bash
lingo logout

Borra ~/.lingo/auth.json. No hace nada si no habías iniciado sesión.

lingo link#

bash
lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

Vincula el proyecto actual a una organización y a un motor de localización. Escribe orgId + engineId en .lingo/config.json (haz commit).

El modo interactivo te permite elegir entre tus organizaciones y motores existentes o crear nuevos en el momento: link te pedirá un nombre, hará la encuesta de onboarding para organizaciones nuevas y creará el recurso mediante la API antes de vincularlo.

lingo unlink#

bash
lingo unlink

Quita orgId y engineId de .lingo/config.json. No elimina la organización ni el motor; solo rompe la vinculación local. Útil antes de volver a vincularlo a otro motor.

lingo whoami#

bash
lingo whoami
lingo whoami --json

Muestra tres cosas:

  1. Identidad — el correo electrónico con el que iniciaste sesión, o si estás usando una clave de API.
  2. Org — la organización vinculada (resuelve el nombre desde la API).
  3. Motor — el motor vinculado (resuelve el nombre desde la API).
text
Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

Si no estás en un directorio de proyecto vinculado, se omiten las líneas de Org/Motor. --json devuelve los mismos datos estructurados para scripting.

Bandera global --api-key#

Todos los comandos aceptan una bandera --api-key que reemplaza las credenciales guardadas solo para esa ejecución. Es un patrón estándar en CI:

yaml
env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --api-key "$LINGO_API_KEY"

(La CLI también lee LINGO_API_KEY desde el entorno como alternativa).

Qué sigue#

  • lingo push — traducción con alcance definido + delta.
  • lingo pull — obtención entre máquinas.
  • Configuration — .lingo/config.json, lockfile, estado de ejecución.

¿Te resultó útil esta página?

Max PrilutskiyMax Prilutskiy·Actualizado hace 5 días·2 min de lectura