PlataformaCrear una cuenta

Otros comandos

Max PrilutskiyCEO y cofundador2 min de lectura

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:

bash
lingo login

Abre Lingo.dev en tu navegador para que inicies sesión y autorices la CLI. La CLI guarda la sesión en ~/.lingo/credentials.json y la mantiene activa hasta que ejecutes lingo logout.

Si has creado una organización en la aplicación web y aún no has terminado de configurarla, login muestra a continuación un enlace para completar la configuración:

text
Finish setting up Acme Inc in the web app: https://lingo.dev/orgs/org_a8c...

La configuración en la aplicación web crea el primer motor de la organización a partir de tu sitio web.

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/credentials.json. No hace nada si no habías iniciado sesión.

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 otros nuevos sin salir del proceso: link te pide un nombre y, si vas a crear una organización, te presenta el cuestionario de bienvenida y la crea a través de la API antes de vincularla.

Mientras no hayas terminado de configurar en la aplicación web una organización que hayas creado, link no crea motores en ella. Muestra el enlace para completar la configuración y la lista de motores existentes de la organización. Si no hay ninguno, finaliza mostrando ese enlace: completa la configuración y vuelve a ejecutar lingo link. Esto no afecta a las organizaciones a las que te hayan invitado ni a las ejecuciones con una clave de API.

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 --wait --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 — recupera los resultados del último envío y detecta conflictos.
  • Configuration — .lingo/config.json, lockfile y estado de ejecución.