Outros comandos

Comandos de configuração e identidade. Nenhum deles altera o conteúdo-fonte — eles só gerenciam credenciais e vínculos do projeto.

lingo login#

Autentica no Lingo.dev. Há dois fluxos:

OTP (padrão, interativo)#

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

Envia um código de uso único para o seu e-mail, valida esse código e armazena uma sessão do Supabase em ~/.lingo/auth.json. Os tokens de atualização ficam armazenados junto para que a sessão continue válida entre execuções, até que você rode explicitamente logout.

Chave de API (CI / não interativo)#

lingo login --api-key lk_...

Armazena a chave de API. Gere as chaves na plataforma Lingo.dev, em API keys, nas configurações da sua organização.

Você também pode passar --api-key como uma flag global em qualquer comando, ignorando completamente as credenciais armazenadas:

lingo push --api-key lk_...

Prático para jobs pontuais de CI que não devem gravar credenciais em disco.

lingo logout#

lingo logout

Limpa ~/.lingo/auth.json. Não faz nada se você não estiver logado.

lingo link#

lingo link
lingo link --org org_a8c... --engine eng_b9d...   # skip prompts

Vincula o projeto atual a uma organização e a um engine de localização. Grava orgId + engineId em .lingo/config.json (faça commit).

No modo interativo, você pode escolher entre suas orgs/engines existentes ou criar novas na hora — link vai pedir um nome, aplicar a pesquisa de onboarding para novas orgs e criar o recurso via API antes de fazer o vínculo.

lingo unlink#

lingo unlink

Remove orgId e engineId de .lingo/config.json. Não exclui a org nem o engine — apenas desfaz o vínculo local. Útil antes de vincular novamente a outro engine.

lingo whoami#

lingo whoami
lingo whoami --json

Mostra três coisas:

1. Identidade — o e-mail com que você está logado, ou se está usando uma chave de API.
2. Org — a organização vinculada (resolve o nome pela API).
3. Engine — o engine vinculado (resolve o nome pela API).

Email:   you@company.com
  Org:     Acme Inc (org_a8c...)
  Engine:  Production (eng_b9d...)
  Auth:    session

Se você não estiver em um diretório de projeto vinculado, as linhas de Org/Engine serão omitidas. --json retorna os mesmos dados estruturados para scripting.

Flag global --api-key#

Todo comando aceita a flag --api-key, que substitui as credenciais armazenadas apenas naquela execução. Um padrão comum em CI:

env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --api-key "$LINGO_API_KEY"

(A CLI também lê LINGO_API_KEY do ambiente como fallback.)

Próximos passos#

• lingo push — tradução com escopo + delta.
• lingo pull — sincronização entre máquinas.
• Configuration — .lingo/config.json, lockfile, estado de execução.