Início rápido

Do início ao fim: instale, autentique, conecte a um engine, envie os arquivos de origem e baixe as traduções.

Pré-requisitos

Node.js 22+ (node -v para verificar). Depois de instalada, a CLI é executada como lingo.

Configuração#

Instalar

bash

npm install -g @lingo.dev/cli

Ou pnpm add -g @lingo.dev/cli / yarn global add @lingo.dev/cli / bun add -g @lingo.dev/cli.

Autenticar

bash

lingo login

Digite seu e-mail; a CLI envia um código de uso único e armazena um token de sessão em ~/.lingo/auth.json. Para CI / contextos não interativos, use uma chave de API: lingo login --api-key lk_... (ou defina --api-key como flag global em qualquer comando).

Inicializar o projeto

Na raiz do projeto:

bash

lingo init

Solicita o idioma de origem, os idiomas de destino e os padrões de arquivo (globs que apontam para seus arquivos de origem). Grava a seção de localização em .lingo/config.json. Faça commit desse arquivo — ele é a fonte da verdade sobre o que será traduzido.

Conectar a um engine

bash

lingo link

Escolha (ou crie) uma organização e um engine de localização. O engine reúne sua configuração de modelo de IA, glossários, voz da marca e instruções — configure-o uma vez na plataforma Lingo.dev e reutilize em vários projetos. link acrescenta orgId e engineId a .lingo/config.json (que também vai para o versionamento).

Primeiro push#

Com um arquivo de origem não vazio no lugar (por exemplo, locales/en.json):

bash

lingo push --backfill-missing

Traduz todos os destinos ausentes em todos os padrões configurados. A CLI espera a execução terminar e grava as saídas (locales/de.json, locales/fr.json, ...) em disco. Em um checkout limpo, isso pode levar de segundos (JSON pequeno) a minutos (grandes pacotes de markdown).

Quando terminar:

text

✓ Run run_a8c... : localized 12 target file(s), uploaded 1 new artifact(s).

Próximas execuções#

Depois de editar os arquivos de origem, lingo push sem opções traduz apenas o delta — arquivos cujo hash de origem não mudou são ignorados no servidor. Alterações locais nos arquivos de destino são preservadas por padrão; passe --force (com um escopo) para sobrescrever.

bash

lingo push                       # delta only
lingo push docs/en/**/*.md       # scoped: only this subtree
lingo push docs/en/about.md -f   # scoped + force: retranslate even if up to date

Baixar em outra máquina#

push registra o ID da execução em ~/.lingo/runs/<hash>.json (associado ao caminho absoluto do projeto). Em qualquer máquina com o mesmo checkout e as mesmas credenciais:

bash

lingo pull

…busca as saídas do último push. Útil para CI ("o tradutor roda o push no laptop, e o CI roda o pull a cada build") ou simplesmente para retomar depois de fechar o terminal.

Para onde ir agora#

Configuração — esquema de .lingo/config.json, lockfile, onde o estado da execução é armazenado.
lingo push — padrões com escopo, --force, semântica de nova tentativa.
lingo pull — detecção de conflitos, --dry-run.

Do início ao fim: instale, autentique, conecte a um engine, envie os arquivos de origem e baixe as traduções.

Pré-requisitos

Node.js 22+ (node -v para verificar). Depois de instalada, a CLI é executada como lingo.

Configuração#

Instalar

bash

npm install -g @lingo.dev/cli

Ou pnpm add -g @lingo.dev/cli / yarn global add @lingo.dev/cli / bun add -g @lingo.dev/cli.

Autenticar

bash

lingo login

Inicializar o projeto

Na raiz do projeto:

bash

lingo init

Conectar a um engine

bash

lingo link

Primeiro push#

Com um arquivo de origem não vazio no lugar (por exemplo, locales/en.json):

bash

lingo push --backfill-missing

Quando terminar:

text

✓ Run run_a8c... : localized 12 target file(s), uploaded 1 new artifact(s).

Próximas execuções#

bash

lingo push                       # delta only
lingo push docs/en/**/*.md       # scoped: only this subtree
lingo push docs/en/about.md -f   # scoped + force: retranslate even if up to date

Baixar em outra máquina#

push registra o ID da execução em ~/.lingo/runs/<hash>.json (associado ao caminho absoluto do projeto). Em qualquer máquina com o mesmo checkout e as mesmas credenciais:

bash

lingo pull

…busca as saídas do último push. Útil para CI ("o tradutor roda o push no laptop, e o CI roda o pull a cada build") ou simplesmente para retomar depois de fechar o terminal.

Para onde ir agora#

Configuração — esquema de .lingo/config.json, lockfile, onde o estado da execução é armazenado.
lingo push — padrões com escopo, --force, semântica de nova tentativa.
lingo pull — detecção de conflitos, --dry-run.