PlataformaCrear una cuenta

Otros comandos

Max PrilutskiyCEO y cofundador2 min de lectura

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:

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 actualizada hasta que ejecutas lingo logout.

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

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

Al configurar la organización en la aplicación web, se crea su primer motor a partir de tu sitio web.

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/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 nuevos en el mismo proceso: link te pide un nombre, te presenta la encuesta de incorporación si la organización es nueva y la crea a través de la API antes de vincularla.

Mientras la configuración de una organización que creaste siga pendiente en la aplicación web, 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 invitaron ni a las que usas con una clave de API.

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