PlataformaCriar uma conta

Outros comandos

Max PrilutskiyCEO e cofundador2 min de leitura

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:

bash
lingo login

Abre o Lingo.dev no seu navegador, onde pode iniciar sessão e autorizar a CLI. A CLI guarda a sessão em ~/.lingo/credentials.json e mantém-na atualizada até executar lingo logout.

Se criou uma organização na aplicação Web e ainda não concluiu a configuração, login apresenta uma ligação para a concluir:

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

A configuração na aplicação Web cria o primeiro motor da organização a partir do seu site.

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

bash
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:

bash
lingo push --api-key lk_...

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

lingo logout#

bash
lingo logout

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

bash
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 e os motores existentes ou criar novos sem sair do processo: link pede um nome, apresenta o questionário de configuração inicial para uma nova organização e cria-a através da API antes de estabelecer a ligação.

Enquanto a configuração de uma organização que criou na aplicação Web estiver por concluir, link não cria motores nessa organização. Apresenta a ligação para concluir a configuração e lista os motores existentes da organização. Se não existir nenhum, termina apresentando essa ligação: conclua a configuração e volte a executar lingo link. As organizações para as quais recebeu um convite e que utilizam uma chave de API não são afetadas.

bash
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#

bash
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).
text
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:

yaml
env:
  LINGO_API_KEY: ${{ secrets.LINGO_API_KEY }}
steps:
  - run: lingo push --backfill-missing --yes --wait --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 — vai buscar os resultados do último push, com deteção de conflitos.
  • Configuration — .lingo/config.json, ficheiro de bloqueio, estado de execução.