Para liberar espaço em disco apagando node_modules, execute npx npkill na sua pasta de projetos, escolha as pastas com as setas e pressione Espaço. A versão 1.0, publicada no npm em 12 de novembro e primeira estável desde junho de 2024, vai muito além de node_modules: traz 20 perfis que também encontram .venv e __pycache__ em Python, target em Rust e Java, .next, .nx e coverage em Node, e pastas de compilação de .NET, Unity, Elixir e muito mais.
yoDEV Testado · 18 de novembro de 2026
Testamos npkill 1.0.0 com Node 22 no Linux, em uma máquina de teste com projetos de sete ecossistemas e oito pastas armadilha. Os resultados que reportamos como nossos saem desse teste.
O que é npkill?
npkill é uma CLI de código aberto (licença MIT, segundo o package.json do repositório) que percorre uma árvore de pastas, lista cada pasta “lixo” que suas ferramentas de desenvolvimento deixaram com seu tamanho e o tempo que você não toca o projeto, e apaga as que você escolhe. Nada é eliminado até que você o selecione. Não precisa instalar: npx npkill a executa diretamente, ou npm i -g npkill se vai usar frequentemente. A versão 1.0 requer Node.js 20.19 ou superior ("engines": { "node": ">=20.19.0" }).
Dentro da interface, Espaço (ou Del) apaga o resultado selecionado, t ativa a seleção múltipla, / filtra por nome ou caminho (aceita regex) e o abre a pasta do projeto.
O que muda no npkill 1.0?
O principal são os perfis: conjuntos de pastas alvo por ecossistema. O perfil padrão, node, cobre node_modules, .next, .nuxt, .angular, .svelte-kit, .vite, .nx, .turbo, .parcel-cache, .output, .docusaurus, storybook-static e coverage. Há perfis para python, java, rust, dotnet, unity, unreal, godot, elixir, cpp, infra e data-science, entre outros. Execute npkill -p sem valor para listá-los, -p python,rust para combiná-los ou -p all para todos.
O resto da versão:
- Alvo inteligente. Muitas pastas contam apenas se os arquivos ao redor confirmam o que são (vemos abaixo, porque é o que mais testamos).
.npkillrc. Um arquivo JSON com seus perfis padrão, exclusões e perfis personalizados. npkill usa o primeiro que encontra: o caminho indicado com--config, depois./.npkillrce depois~/.npkillrc.--jsone--json-streampara scripts e CI.- Uma API. O núcleo agora está separado da CLI e pode ser importado em seu próprio código (documentado no
API.mddo repositório). - Novos filtros:
--older-than 90mostra apenas projetos não tocados há mais de 90 dias, e--excludeagora aceita padrões. - Velocidade. O projeto garante que as buscas são até 3 vezes mais rápidas porque seus workers agora compartilham memória. É uma cifra dos próprios autores; não a medimos.
Cuidado com a documentação: no momento de publicar esta nota (18 de novembro de 2026), o arquivo docs/profiles.md da branch main atribui ao perfil node pastas como .npm, .pnpm-store ou .eslintcache, que o código da versão 1.0.0 não inclui. A lista acima é a do código publicado no npm.
É seguro apagar node_modules com npkill? Tentamos enganá-lo
Sim, e comprovamos. A pergunta que decide se você usa um limpador uma vez ou todo mês é simples: ele apaga algo que não deveria? Uma pasta chamada target é a compilação de Rust em um projeto e as planilhas do time de marketing em outro.
npkill 1.0 resolve isso com regras em seu código: target só conta junto a Cargo.toml, pom.xml ou build.sbt; .venv, venv e env só se contêm pyvenv.cfg; coverage só se guarda lcov.info, coverage-final.json ou clover.xml; a Library de Unity só junto a Assets e ProjectSettings, e deps de Elixir só junto a mix.exs.
Montamos uma máquina de teste de 664 MB com 14 pastas de compilação reais em Node, Python, Rust, Java, Unity, Elixir e .NET, e colocamos oito imitações ao lado: um target/ com uma planilha e sem manifesto, um .venv/ com notas pessoais e sem pyvenv.cfg, um env/ com um arquivo de segredos, uma Library/ cheia de fotos, o deps/ de um projeto em C, o obj/ de um modelo 3D, uma pasta de documentação chamada coverage/ e um .next/ órfão sem package.json.
| Execução | Pastas reais encontradas | Imitações marcadas | Espaço recuperável |
|---|---|---|---|
npkill (perfil node padrão) |
5 | 0 | 258 MB |
npkill -p all |
14 de 14 | 0 de 8 | 633 MB |
Encontrou todas as pastas reais e não tocou em nenhuma imitação. Uma exclusão real das duas pastas node_modules em uma cópia da máquina a deixou em 479 MB (185 MB liberados), com as armadilhas intactas.
Também protege as pastas das quais outros aplicativos dependem. Em um diretório pessoal de teste, um node_modules dentro de ~/.config ficou oculto por padrão e só apareceu com --include-sensitive, marcado como “Contains user configuration data (~/.config)”.
Como eliminar node_modules de todos os seus projetos a partir de um script?
Com cuidado, porque aqui está a única armadilha que encontramos. Para apagar sem interface, npkill tem --delete-all (-D), e na versão 1.0 recusa funcionar com perfis:
--delete-all only can be used with --targets.
To use profiles, run npkill without --delete-all and pick the results.
O problema é que --targets procura pastas por nome, sem as verificações acima. Nossa simulação com npkill -t target -D -y --dry-run listou as pastas target de Rust e Java e também a do marketing. Em um script autônomo, esse é exatamente o erro que os perfis existem para evitar.
Se você precisa de uma limpeza autônoma que preserve as verificações, obtenha os resultados do perfil em JSON e delete você essas rotas. Testamos, até mesmo com um caminho que tinha um espaço:
npkill -p rust,java --json | jq -r '.results[].path' | tr '\n' '\0' | xargs -0 rm -rf
Apagou as duas pastas target reais e deixou em paz a do marketing. Execute-o primeiro sem a parte de xargs para revisar a lista. Use --targets com -D apenas para nomes sem ambigüidade como node_modules, e sempre teste com --dry-run primeiro.
Como liberar espaço em disco com Node, Python e Rust ao mesmo tempo?
Crie um .npkillrc na sua pasta de projetos ou no seu diretório pessoal:
{
"defaultProfiles": ["node", "python", "rust"],
"exclude": ["archive"]
}
A partir daí, um simples npkill revisa os três ecossistemas e pula tudo que estiver sob archive. Em nosso teste, esses mesmos três perfis encontraram as nove pastas de Node, Python e Rust, e a pasta que excluímos ficou de fora. É a forma mais direta de recuperar o espaço em disco que um monorepo ou uma máquina com muitos projetos consome.
Você também pode definir seus próprios perfis. As regras aceitam nextTo (arquivos que devem estar junto à pasta) e contains (arquivos que devem estar dentro). A documentação só descreve nextTo, mas o código da 1.0 valida os dois e funcionaram para nós:
{
"profiles": {
"rust-ci": {
"description": "Rust target folders, only next to Cargo.toml",
"targets": [{ "target": "target", "nextTo": ["Cargo.toml"] }]
},
"venvs": {
"description": "Python virtualenvs that really are virtualenvs",
"targets": [{ "target": ".venv", "contains": ["pyvenv.cfg"] }]
}
}
}
Depois execute npkill -p rust-ci,venvs. Um perfil personalizado com o mesmo nome que um incluído o substitui.
A validação é rígida, e isso é bom: um erro de digitação como "sortby" para npkill com a lista de propriedades válidas, e um nome de perfil desconhecido em defaultProfiles é rejeitado indicando qual é.
Como eliminar um ambiente virtual de Python com npkill?
Execute npkill -p python: lista cada .venv, venv ou env que contenha pyvenv.cfg, junto com __pycache__, .pytest_cache, .mypy_cache e .ruff_cache. Uma pasta chamada .venv ou env sem esse arquivo não aparece; em nosso teste, um env/ com um arquivo de segredos ficou de fora da lista.
npkill ou cargo clean?
Depende do escopo. cargo clean limpa o projeto de Rust em que você está; npkill -p rust percorre todos os seus projetos ao mesmo tempo e mostra quanto espaço cada target ocupa e há quanto tempo não o toca, com --older-than para ficar apenas com os abandonados.
npkill apaga o cache de npm?
Não. O cache global de npm vive no seu diretório pessoal e não é o que o perfil node da versão 1.0 procura, que se concentra nas pastas dentro dos seus projetos. Para o cache, npm tem seu próprio comando, npm cache clean. São duas limpezas distintas que se complementam.
npkill 1.0 quebra meus scripts?
Pode ser. Se você chama npkill do CI ou de seus dotfiles, revise essas mudanças das notas da versão:
--targetagora é--targets.--sort last-modagora é--sort age.-gbagora é--size-unit gb.--bg-colordesaparece.--delete-allagora requer--targets.- As opções desconhecidas agora resultam em erro em vez de serem ignoradas.
Essa última mudança nos surpreendeu. No momento de publicar esta nota, o README da branch main ainda listava -x, --exclude-sensitive e -nu, --no-check-update, e npkill 1.0.0 rejeita os dois com Unknown options. Consulte npkill --help na versão que você tem instalada: na 1.0.0, os resultados sensíveis ficam ocultos por padrão e --include-sensitive os mostra.
E você? Quantos gigas recuperou em sua primeira passada com npkill?
- node_modules
- .venv e caches de Python
- target de Rust ou Java
- Prefiro outra opção (nos conte qual)
Comente abaixo ou, se este artigo chegou para você por email, responda diretamente ao email: sua resposta é publicada aqui.
Relacionado: Mastering npx: A Cheatsheet for npm and Node.js Power Users
