stamatios
← Voltar ao feed
Jardineiro poda galhos secos de árvore feita de código, ferramenta Fallow detecta código morto em TypeScript
Dev & Engenharia

Fallow analisa codebases TypeScript em busca de código morto e drift

resumo de ~3 min

O que é o Fallow

Fallow é uma ferramenta de "inteligência de codebase" para TypeScript e JavaScript. Ela combina uma camada de análise estática gratuita com uma camada opcional de inteligência de runtime, com o objetivo de ajudar times a encontrarem e removerem código morto, duplicação e drift de arquitetura.

A camada estática identifica código não utilizado (arquivos, exports e dependências), lógica duplicada, hotspots de complexidade, drift de arquitetura, drift de estilos de design system e branches de feature flags no grafo de módulos. A camada de runtime, opcional, mostra o que realmente executou em produção: hot paths, cold paths e evidências para deletar código com mais confiança.

Como funciona na prática

O primeiro uso não exige configuração: basta rodar npx fallow. A partir daí, é possível ir além com comandos específicos como fallow dead-code, fallow dupes, fallow health e fallow fix --dry-run. Os resultados de código morto, duplicação, complexidade e estilos aparecem em uma única passada.

A proposta da ferramenta inclui: deletar código frio com confiança, reduzir duplicação antes que ela se espalhe, priorizar refatorações com base em análise de complexidade e saúde, adicionar evidências via TypeScript (uso exato de símbolos, contratos de classes, arquivos afetados e testes direcionados) e incorporar evidências de runtime.

Fluxos de trabalho e integrações

O Fallow pode ser usado de três formas principais: via CLI (funciona localmente, em CI e em loops de agentes), como extensão do VS Code (diagnósticos em tempo real, Code Lens e correções com um clique) e via MCP e agentes, com chamadas de ferramentas estruturadas para Claude Code, Cursor e outros agentes.

A documentação também lista suporte a Neovim, hooks do Claude Code, Node.js bindings, badges de saúde, integração com CI, análise de React e Next.js, plugins personalizados, análise de CSS/SCSS/Tailwind e migração a partir de ferramentas como knip e jscpd.

Modelo mental

A ferramenta se apoia em duas camadas conceituais: a análise estática responde "o que está conectado a quê?", enquanto a inteligência de runtime responde "o que realmente executou?". O ponto de encontro entre as duas é o "fallow health", métrica de saúde do codebase. A instalação é possível via npx, npm, pnpm, yarn, cargo, Docker ou binários pré-compilados para macOS, Linux e Windows.