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.
Vincular #
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.
Desvincular #
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.