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)#
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 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)#
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:
lingo push --api-key lk_...Muy práctico para trabajos puntuales de CI que no deberían escribir credenciales en disco.
lingo logout#
lingo logoutElimina ~/.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 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#
lingo unlinkElimina 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#
lingo whoami
lingo whoami --jsonMuestra tres cosas:
- Identidad — el correo electrónico con el que has iniciado sesión, o si estás usando una clave API.
- Org — la organización vinculada (resuelve el nombre desde la API).
- Engine — 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/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:
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.
