Outros comandos

Comandos de configuração e identidade. Nenhum deles mexe no conteúdo de origem — apenas gerem credenciais e ligações ao projeto.

lingo login#

Autentique-se no Lingo.dev. Existem dois fluxos:

OTP (predefinido, 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 utilização única para o seu email, valida-o e guarda uma sessão Supabase em ~/.lingo/auth.json. Os tokens de atualização também são guardados aí, para que a sessão se mantenha ativa entre utilizações até fazer explicitamente logout.

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

lingo login --api-key lk_...

Guarda a chave de API. Pode gerar chaves na plataforma Lingo.dev, nas definições de API keys da sua organização.

Também pode passar --api-key como flag global em qualquer comando, o que ignora por completo as credenciais guardadas:

lingo push --api-key lk_...

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

lingo logout#

lingo logout

Limpa ~/.lingo/auth.json. Não faz nada se não tiver sessão iniciada.

lingo link#

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

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

O modo interativo permite-lhe escolher entre as organizações/motores existentes ou criar novos no momento — link vai pedir um nome, fazer o inquérito de onboarding para novas organizações e criar o recurso através da API antes de estabelecer a ligação.

lingo unlink#

lingo unlink

Remove orgId e engineId de .lingo/config.json. Não elimina a organização nem o motor — apenas desfaz a ligação local. Útil antes de voltar a ligar a um motor diferente.

lingo whoami#

lingo whoami
lingo whoami --json

Mostra três elementos:

1. Identity — o email com que tem sessão iniciada, ou se está a usar uma chave de API.
2. Org — a organização ligada (resolve o nome através da API).
3. Engine — o motor ligado (resolve o nome através da API).

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

Se não estiver numa diretoria de projeto ligada, as linhas Org/Engine são omitidas. --json devolve os mesmos dados estruturados para scripting.

Flag global --api-key#

Todos os comandos aceitam uma flag --api-key que substitui as credenciais guardadas apenas nessa invocação. É o padrão habitual 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 alternativa.)

Onde ir a seguir#

• lingo push — tradução com âmbito definido + delta.
• lingo pull — obtenção entre máquinas.
• Configuration — .lingo/config.json, ficheiro de bloqueio, estado de execução.