Referência da CLI

A CLI do i1n é a interface principal para gerenciar a localização. Instale-a globalmente com npm i -g i1n.

Todos os comandos são executados no contexto do diretório atual do projeto, usando a configuração de i1n.config.json.

Inicializa o i1n em um projeto. Executa uma configuração interativa que detecta o framework do seu projeto, define o formato e o diretório do arquivo de localizações, configura o idioma de origem e cria o i1n.config.json.

Este comando só precisa ser executado uma vez por projeto. Execute-o novamente para reconfigurar as configurações.

Envie arquivos de tradução locais para o i1n. A CLI escaneia seus arquivos de localidade (por exemplo, locales/**/*.json) e sincroniza todas as chaves com o projeto.

Use --translate [langs] para acionar a tradução por IA após o push. Exemplo: i1n push --translate es,fr,de,ja traduz para espanhol, francês, alemão e japonês.

Se uma chave e um idioma foram editados em ambos os lados desde a última sincronização (um conflito real), a CLI solicita uma ação interativa: manter o valor local, aceitar o valor do servidor ou abortar o push. Alterações feitas apenas no servidor (edições feitas por outro usuário ou no painel enquanto você trabalhava) são automaticamente gravadas em seus arquivos locais no momento do push, e o i1n.d.ts é regenerado quando necessário.

Flags disponíveis: --translate [langs] aciona a tradução por IA após o push (exemplo: i1n push --translate es,fr,de,ja); --strategy <mode> define a política de conflito como interactive (padrão em um terminal), ours (o local vence), theirs (o servidor vence) ou abort (encerra em qualquer conflito). --force é um atalho para --strategy ours e sobrescreve os valores do servidor, o que é destrutivo e descarta quaisquer edições feitas no servidor por outros colaboradores.

Puxe as traduções do i1n e escreva arquivos locais. Busca todas as traduções, escreve arquivos de local no formato configurado e gera definições de tipo TypeScript i1n.d.ts.

Execute isto após as traduções serem concluídas, ou como parte do seu pipeline de CI/CD para garantir que os arquivos estejam sempre sincronizados.

Adicione novos idiomas de destino ao seu projeto interativamente. O comando verifica os idiomas disponíveis no seu plano e permite a reativação de idiomas usados anteriormente sem consumir novos espaços.

A disponibilidade de idiomas depende do seu plano: Starter suporta 2, Pro suporta 5, Business suporta 12 e Enterprise suporta todos os 182 idiomas.

Exibe limites do projeto e uso atual. Mostra chaves usadas vs. limite, créditos de tradução de IA usados vs. limite, slots de idioma usados vs. disponíveis e uma lista de idiomas ativos.

Use este comando para monitorar o consumo e determinar quando uma atualização de plano pode ser necessária.

Gere regras de contexto de agente de IA para o projeto. Cria arquivos de regras para Cursor (.cursor/rules/i1n.mdc), Claude Code (CLAUDE.md), Windsurf (.windsurfrules), GitHub Copilot (.github/copilot-instructions.md), Codex (AGENTS.md) e Antigravity (.antigravity/rules.md).

Estes arquivos ensinam agentes de IA a usar chaves de tradução em vez de strings codificadas, a colocar chaves em arquivos de namespace corretos, a preservar variáveis de interpolação e a executar i1n push após modificações.

Inicie um servidor do Model Context Protocol (MCP) que expõe as ferramentas i1n a assistentes de codificação de IA. Isso permite que Cursor, Claude Code, Windsurf e outros agentes compatíveis com MCP executem comandos i1n diretamente — push, pull, traduzir, adicionar idiomas e muito mais — sem sair do IDE.

O servidor MCP expõe 7 ferramentas: i1n_status, i1n_push, i1n_pull, i1n_translate, i1n_add_language, i1n_extract_and_translate e i1n_search. O recurso de destaque é o i1n_extract_and_translate — seu agente de IA extrai strings codificadas de um componente, as passa para o i1n, e elas são instantaneamente enviadas, traduzidas para todos os idiomas ativos, e as definições de tipo são regeneradas. Configure-o com: claude mcp add i1n -- npx i1n mcp.

Valide seus arquivos de tradução locais sem tocar na rede: chaves ausentes por idioma, placeholders de interpolação quebrados ({{name}}, {name}, %{name} comparados com seu idioma de origem), valores vazios, arquivos malformados e cobertura por idioma. Ele detecta o clássico assassino silencioso — uma variável perdida na tradução que causa falhas na formatação durante a execução.

Criado para CI: código de saída 0 quando limpo, 1 quando erros são encontrados, 2 em problemas de configuração. Adicione --min-coverage 95 para falhar o build quando a cobertura de tradução cair abaixo do seu limite, e --json para relatórios legíveis por máquina. Nenhuma chamada de API ou segredos são necessários, então ele roda em qualquer pipeline.

Nós o executamos em nosso próprio site no dia em que o criamos — ele encontrou 47 placeholders quebrados que estavam ativos em produção há semanas. Execute npx i1n check antes de cada lançamento.