Referência de comandos da CLI

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

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

Para projetos i18n.json existentes, a secção Migração indica os comandos atuais que correspondem aos fluxos de trabalho anteriores.

Inicializar #

lingo init cria a estrutura inicial dos idiomas de origem e de destino e dos padrões de ficheiros. A opção de substituição forçada substitui as entradas de ficheiros existentes e pode eliminar opções avançadas; reveja a configuração resultante antes de traduzir.

Iniciar sessão #

lingo login guarda uma sessão do navegador ou uma chave de API validada. A opção local --api-key guarda a chave de forma persistente. A opção global, quando usada noutro comando, aplica-se apenas a essa execução.

Terminar sessão #

lingo logout elimina as credenciais guardadas de forma persistente. As chaves definidas no ambiente ou fornecidas na execução do comando continuam a ter efeito.

Consultar identidade #

lingo whoami indica a identidade e o tipo de autenticação; --json apresenta os dados num formato legível por máquina. O recurso a informações guardadas em caso de falha de ligação não constitui uma verificação online.

lingo link guarda os IDs da organização e do motor de localização usados na tradução de ficheiros. Os IDs permitem selecionar recursos, mas não concedem acesso.

lingo unlink remove esses IDs, mantendo os ficheiros, as definições de localização e os recursos remotos.

Enviar #

lingo push envia os ficheiros de origem. Os diferentes modos permitem distinguir entre guardar uma versão de referência, traduzir de forma incremental, preencher destinos em falta, atualizar chaves e forçar a substituição. --wait também obtém os resultados. Voltar a executar o comando permite tentar novamente as tarefas que falharam.

Obter #

lingo pull obtém a execução mais recente registada localmente e verifica os hashes de destino antes de escrever. --dry-run permite pré-visualizar as decisões de escrita, mas pode ainda assim contactar o servidor.

Eliminar #

lingo purge permite pré-visualizar ou eliminar os destinos derivados. Com filtros de ficheiro ou idioma, remove apenas as entradas de destino selecionadas do Lockfile; sem filtros, remove o Lockfile completo. Os catálogos XCStrings partilhados são ignorados.

Extrair #

lingo extract converte as chamadas estáticas TypeScript/TSX suportadas 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 falta um ficheiro de destino e, se .lingo/lock.json estiver presente, quando um ficheiro de origem foi alterado desde a última tradução. Não faz chamadas de rede nem requer uma chave de API. Sem o Lockfile, verifica apenas se os ficheiros de destino existem. Nos projetos React, verifica também se o catálogo e os tipos estão atualizados, bem como o contexto, os elementos órfãos e as traduções em falta. Não verifica as chaves nos ficheiros de destino que não sejam React nem avalia a qualidade das traduções.

Limpar #

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

Guia #

lingo guide [name] apresenta as orientações sobre React incluídas no pacote e disponíveis sem ligação à Internet. Os nomes são index, setup-react, api e migrate; se omitir o nome, é selecionado o índice. Se indicar um nome desconhecido, são apresentadas as opções disponíveis. O guia corresponde à versão instalada do pacote.

Guia para agentes #

lingo agent-guide [name] destina-se a agentes de IA. Se não for indicado um nome, apresenta o guia para agentes, que abrange a configuração, o início de sessão e o MCP server, e enumera os guias para agentes e para pessoas. Se for indicado um nome, apresenta o guia correspondente, incluindo os guias de tecnologias que não constam da lista. Os guias correspondem à versão instalada do pacote.

Agente #

lingo agent setup verifica se os agentes de programação que deteta (Claude Code, Codex e Cursor, além daquele em que está a ser executado) têm o MCP server da Lingo.dev e indica a configuração do MCP para os que não o têm; nunca altera as respetivas configurações. --client permite especificar os agentes a verificar em alternativa, incluindo os que não foram detetados. Se não houver nenhum agente para verificar, termina com erro sem escrever nada. Dentro de um projeto, também escreve o bloco da Lingo.dev em AGENTS.md e num CLAUDE.md existente, a menos que este importe um AGENTS.md que receba o bloco; nunca cria CLAUDE.md. Se não for possível ler um ficheiro, se este apontar para fora do projeto ou se contiver marcadores de bloco sem correspondência, mantém-no inalterado e indica o motivo; corrija o ficheiro e volte a executar a configuração. --dry-run mostra o plano, -y escreve sem pedir confirmação e --status mostra o que está configurado para os agentes detetados, ignorando --client. Configurar com um agente de programação inclui instruções para fornecer ao seu agente.

Atualizar #

lingo update usa o método de instalação detetado. Use o seu gestor de pacotes para instalar uma versão específica. As verificações de atualizações são guardadas em cache e ignoradas quando é detetado um ambiente de CI ou quando são desativadas através do ambiente.

Pontuar #

lingo score está registado, mas não aparece na ajuda habitual. Executa combinações locais de avaliadores e modelos através do OpenRouter e guarda os resultados localmente, sem acrescentar registos ao histórico do Radar.