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)#
lingo login
lingo login --email you@company.com # skip the email prompt
lingo login --email you@company.com --code 123456 # skip the code prompt tooEnví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)#
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:
lingo push --api-key lk_...Ideal para jobs puntuales de CI que no deberían escribir credenciales en disco.
lingo logout#
lingo logoutBorra ~/.lingo/auth.json. No hace nada si no habías iniciado sesión.
lingo link#
lingo link
lingo link --org org_a8c... --engine eng_b9d... # skip promptsVincula 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#
lingo unlinkQuita 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#
lingo whoami
lingo whoami --jsonMuestra tres cosas:
- Identidad — el correo electrónico con el que iniciaste sesión, o si estás usando una clave de API.
- Org — la organización vinculada (resuelve el nombre desde la API).
- Motor — el motor vinculado (resuelve el nombre desde la API).
Email: you@company.com
Org: Acme Inc (org_a8c...)
Engine: Production (eng_b9d...)
Auth: sessionSi 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:
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.
