Solução de problemas

Este erro significa que a CLI do i1n não está instalada globalmente ou não está no seu PATH. Execute npm install -g i1n para instalá-la. Se você usa um gerenciador de versões (nvm, fnm), certifique-se de que o diretório global de binários esteja no seu PATH.

No macOS/Linux, você pode verificar o caminho de instalação com which i1n. Se estiver usando bun, execute bun install -g i1n em vez disso.

Isso ocorre quando a chave de API em i1n.config.json está faltando, expirou ou é inválida. Gere uma nova chave nas configurações da sua organização em dashboard.i1n.ai e execute i1n init para reconfigurar.

Certifique-se de que está usando a chave de API correta para a organização que possui o projeto. Cada organização tem suas próprias chaves — uma chave de uma organização não pode acessar os projetos de outra.

Se o i1n push reportar zero chaves ou pular arquivos, verifique se o seu diretório de locais e o formato do arquivo correspondem à configuração em i1n.config.json. Execute o i1n init para reconfigurar, se necessário.

As causas comuns incluem padrões glob incorretos, formatos de arquivo incompatíveis (por exemplo, JSON simples quando JSON aninhado está configurado) ou arquivos de tradução vazios.

Isso geralmente significa que o projeto não tem traduções no servidor. Execute o i1n push primeiro para enviar suas chaves de origem, depois o i1n pull para baixar as traduções.

Se você enviou chaves, mas o pull retorna arquivos vazios, verifique se os idiomas de destino foram adicionados ao seu projeto usando i1n add-language ou através do painel.

Se o seu IDE mostrar erros após o pull, certifique-se de que i1n.d.ts está incluído na sua compilação TypeScript. A CLI atualiza automaticamente o tsconfig.json, mas configurações manuais podem precisar de ajustes.

Nunca modifique o i1n.d.ts diretamente — ele é regenerado a cada i1n pull. Se o arquivo parecer corrompido, exclua-o e execute o i1n pull novamente.