Referência de comandos da CLI

Encontre comandos da CLI para configuração, tradução e manutenção de catálogos.

Use lingo --help para consultar os comandos e lingo <command> --help para ver as opções. lingo --version identifica a geração instalada. O pacote atual é @lingo.dev/cli; projetos i18n.json usam um manual separado, o manual da v0.

Se você já tem um projeto i18n.json, consulte Migração para ver a correspondência entre os workflows antigos e os comandos atuais.

Inicializar #

lingo init cria a estrutura inicial com idiomas de origem e destino e padrões de arquivos. A opção de forçar substitui as entradas de arquivos existentes e pode descartar opções avançadas; confira a configuração resultante antes de traduzir.

Entrar #

lingo login armazena uma sessão do navegador ou uma chave de API validada. A opção local --api-key mantém a chave salva. Já a opção global, quando usada em outro comando, vale apenas para aquela execução.

Sair #

lingo logout remove as credenciais salvas. As chaves definidas no ambiente e as fornecidas na execução continuam válidas.

Ver identidade #

lingo whoami informa a identidade e o tipo de autenticação; --json fornece a saída em formato legível por máquina. Se houver uma falha de conexão, o comando recorre às informações salvas, mas isso não equivale a uma verificação online.

lingo link salva os IDs da organização e do engine de localização usados na tradução de arquivos. Os IDs selecionam os recursos, mas não concedem acesso a eles.

lingo unlink remove esses IDs e preserva os arquivos, as configurações de localização e os recursos remotos.

Enviar #

lingo push envia os arquivos de origem. Seus modos permitem distinguir entre armazenar uma base inicial, traduzir de forma incremental, preencher destinos ausentes, atualizar chaves e forçar a substituição. --wait também obtém os resultados. Execute o comando novamente para tentar refazer as tarefas que falharam.

Obter #

lingo pull obtém os resultados da execução mais recente registrada localmente e verifica os hashes dos destinos antes de gravar. --dry-run mostra uma prévia do que será gravado, mas ainda pode se conectar ao servidor.

Excluir #

lingo purge mostra uma prévia ou exclui os destinos derivados. Com filtros de arquivo ou idioma, remove apenas as entradas de destino selecionadas do Lockfile; sem filtros, remove o Lockfile inteiro. Catálogos XCStrings compartilhados são ignorados.

Extrair #

lingo extract transforma chamadas estáticas compatíveis de TypeScript/TSX em JSONC de origem e declarações. Trata-se de extração local, não de reescrita ou tradução automática.

Verificar #

lingo check falha quando um arquivo de destino não existe e, se .lingo/lock.json estiver presente, quando um arquivo de origem tiver sido alterado desde a última tradução. Não faz chamadas de rede nem exige chave de API. Sem o Lockfile, verifica apenas se os arquivos de destino existem. Em projetos React, também verifica se o catálogo e os tipos estão atualizados, além de conferir o contexto, os itens órfãos e as traduções ausentes. Não verifica as chaves nos arquivos de destino que não usam React nem avalia a qualidade da tradução.

Limpar #

lingo clean remove imediatamente as entradas órfãs de origem e as entradas de destino desatualizadas dos catálogos JSONC. Não oferece uma opção de simulação nem regenera as declarações.

Guia #

lingo guide [name] exibe as orientações offline sobre React incluídas no pacote. Os nomes são index, setup-react, api e migrate; sem um nome, exibe o índice. Se o nome for desconhecido, informa as opções disponíveis. O guia corresponde à versão instalada do pacote.

Guia para agentes #

lingo agent-guide [name] é voltado a agentes de IA. Quando nenhum nome é informado, exibe o guia para agentes, que explica a configuração, o acesso à conta e o MCP server, além de listar os guias para agentes e pessoas. Quando um nome é informado, exibe o guia correspondente, incluindo guias de stack que não aparecem na lista. Os guias correspondem à versão instalada do pacote.

Agente #

lingo agent setup verifica se os agentes de programação que detecta (Claude Code, Codex e Cursor, além daquele em que está sendo executado) têm o MCP server da Lingo.dev e indica a configuração do MCP para os que não têm; nunca altera as configurações desses agentes. --client permite especificar quais agentes verificar no lugar dos detectados, incluindo os que não foram detectados. Quando não há nenhum agente para verificar, a operação falha sem gravar nada. Dentro de um projeto, também grava o bloco da Lingo.dev em AGENTS.md e em um CLAUDE.md existente, a menos que ele importe um AGENTS.md que receba o bloco; nunca cria CLAUDE.md. Mantém o arquivo inalterado e informa o motivo quando não é possível lê-lo, quando ele aponta para fora do projeto ou quando seus marcadores de bloco não formam pares; corrija o arquivo e execute a configuração novamente. --dry-run mostra o plano, -y grava sem perguntar e --status mostra o que está configurado para os agentes detectados, ignorando --client. Configurar com um agente de programação inclui prompts para você enviar ao seu agente.

Atualizar #

lingo update usa o método de instalação detectado. Use seu gerenciador de pacotes para instalar uma versão específica. As verificações de atualização ficam em cache e são ignoradas quando um ambiente de CI é detectado ou quando estão desativadas por variável de ambiente.

Pontuar #

lingo score está registrado, mas não aparece na ajuda padrão. Executa combinações locais de avaliador e modelo via OpenRouter e salva os resultados localmente, sem adicionar registros ao histórico do Radar.