Pitch: 8n8, um mapa visual para entender código, principalmente escrito por IA
Já faz um tempo que quase todo código que eu escrevo passa pela IA. E isso tem um efeito colateral chato: o código cresce bem mais rápido do que eu consigo ler. Peço uma coisa pequena, o agente mexe em vários arquivos em minutos, e isso me leva cada vez mais a só aceitar e confiar no teste que ele mesmo escreveu. Depois do commit fica aquela voz na cabeça perguntando, quem chama quem, por onde o dado passa, o que mudou de fato no fluxo.
Procurei alguma ferramenta para auxiliar com isso, de preferência que mostrasse de forma visual e rápida, mas não achei nada que me servisse. Eu só queria algo que eu colocasse o código e gerasse um algo parecido com os nós do n8n, aquele que a gente brinca, mas facilita muito pra quem não quer ver a cara do código.
Daí saiu o 8n8. E caso não tenha percebido, o nome é um trocadilho.
É open source ✅
É extensão vscode ✅
É CLI e PWA ✅
É pacote npm ✅
Fiz um vídeo curto mostrando do 8n8 em ação.
Como funciona
Você aponta uma pasta e ele desenha o mapa. Começa pelos arquivos e como eles se ligam. Aqui, por exemplo, um arquivo Python faz um POST pra uma rota, e o 8n8 liga isso ao arquivo TypeScript que atende essa rota:
Clicando num nó você entra nele. Uma função vira o passo a passo dela: as chamadas, o if com os dois caminhos, a requisição HTTP, o banco e o retorno.
E qualquer nó abre o código de verdade, com arquivo e linha. Dá pra pedir um resumo, sugestões de melhoria e conversar sobre aquele trecho.
Quem desenha o mapa não é a IA
Essa foi a decisão que mais pesou. Se a IA montasse o mapa, eu ia ter que revisar o mapa também, e aí não resolvia nada. Então quem faz isso é o Tree-sitter, que faz o parsing do código. O mesmo código gera sempre o mesmo mapa.
O LLM só entra pra escrever os resumos e as sugestões. Sem ele o mapa funciona normal, só fica sem os textos. Se você tem o Claude Code instalado, ele usa a sua assinatura e não precisa de chave. Também dá pra usar OpenRouter, OpenAI, Anthropic ou Ollama.
Por enquanto ele lê Python e TypeScript, e uma pasta misturando as duas vira um mapa só. Cada linguagem é um plugin separado, então adicionar outra não é um bicho de sete cabeças. Roda tudo local, sem servidor externo.
Pra testar
npx 8-n-8 .
Precisa de Node 22.13 ou mais novo. O pacote ficou 8-n-8 porque o npm não me deixou usar 8n8. Também tem uma extensão pro VS Code, que por enquanto você instala a partir do repositório.
É open source (GPL-3.0): github.com/Ferreira-Jefferson/8n8
Se testar, me conta o que achou, principalmente se ajudou a entender algum fluxo importante.
E se tem alguma linguagem que você queria ver lá, fala também.