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

Descripción general

  • @lingo.dev/cli

Primeros pasos

  • Guía rápida
  • Configuración

Referencia

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

Configuración

  • Controles de claves
  • Formatos
  • Idiomas

Guías

  • Añadir un idioma
  • Traducciones existentes
  • Retraducción
  • Notas de traducción
  • Ejecuciones, estado y recuperación
  • CI/CD
  • Monorepos
  • Proyectos grandes

¿Buscas la versión anterior de la CLI (v0)? Consulta la documentación de la CLI antigua

Otros comandos

Comandos de configuración e identidad. Ninguno toca el contenido fuente: solo gestionan credenciales y vinculaciones de 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 guardan junto a ella para que la sesión se mantenga activa entre usos hasta que hagas logout de forma explícita.

Clave API (CI / no interactivo)#

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

Guarda la clave API. Puedes generar claves en la plataforma de Lingo.dev, en la configuración de API keys de tu organización.

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

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

Muy práctico para trabajos puntuales de CI que no deberían escribir credenciales en disco.

lingo logout#

bash
lingo logout

Elimina ~/.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 o motores existentes, o crear otros nuevos al momento: link te pedirá un nombre, completará la encuesta de incorporación para organizaciones nuevas y creará el recurso mediante la API antes de vincularlo.

lingo unlink#

bash
lingo unlink

Elimina orgId y engineId de .lingo/config.json. No borra la organización ni el motor: solo rompe la vinculación local. Útil antes de volver a vincular el proyecto a otro motor.

lingo whoami#

bash
lingo whoami
lingo whoami --json

Muestra tres cosas:

  1. Identidad — el correo electrónico con el que has iniciado sesión, o si estás usando una clave API.
  2. Org — la organización vinculada (resuelve el nombre desde la API).
  3. Engine — 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/Engine. --json devuelve los mismos datos estructurados para scripts.

Flag global --api-key#

Todos los comandos aceptan una flag --api-key que sustituye las credenciales almacenadas solo para esa ejecución. Es el patrón habitual 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).

Dónde ir después#

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

¿Te ha resultado útil esta página?

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