PlataformaCriar uma conta

Outros comandos

Max PrilutskiyCEO e cofundador2 min de leitura

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:

bash
lingo login

Abre o Lingo.dev no seu navegador, onde você faz login e autoriza a CLI. A CLI salva a sessão em ~/.lingo/credentials.json e a mantém ativa até você executar lingo logout.

Se você criou uma organização no aplicativo web e ainda não concluiu a configuração, login exibe um link para finalizá-la:

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

A configuração no aplicativo web cria o primeiro engine da organização a partir do seu site.

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

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

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

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

lingo logout#

bash
lingo logout

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

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

O modo interativo permite escolher entre suas organizações e engines existentes ou criar novos ali mesmo: link pede um nome e, no caso de uma nova organização, apresenta o questionário de configuração inicial e cria a organização pela API antes de fazer a vinculação.

Enquanto a configuração de uma organização que você criou não for concluída no aplicativo web, link não cria engines nela. Em vez disso, exibe o link para concluir a configuração e lista os engines existentes da organização. Se não houver nenhum, encerra a execução exibindo esse link para que você possa concluir a configuração e executar lingo link novamente. Isso não afeta as organizações para as quais você foi convidado e que usam uma chave de API.

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

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

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 fallback.)

Próximos passos#

  • lingo push — tradução com escopo + delta.
  • lingo pull — traz as saídas do último push, com detecção de conflitos.
  • Configuration — .lingo/config.json, lockfile, estado de execução.