¿Cómo liberar espacio borrando node_modules? npkill 1.0 ahora limpia 20 ecosistemas

Para liberar espacio en disco borrando node_modules, ejecuta npx npkill en tu carpeta de proyectos, elige las carpetas con las flechas y pulsa Espacio. La versión 1.0, publicada en npm el 12 de noviembre y primera estable desde junio de 2024, va mucho más allá de node_modules: trae 20 perfiles que también encuentran .venv y __pycache__ en Python, target en Rust y Java, .next, .nx y coverage en Node, y carpetas de compilación de .NET, Unity, Elixir y más.

:white_check_mark: yoDEV Tested · 18 de noviembre de 2026
Probamos npkill 1.0.0 con Node 22 en Linux, sobre una máquina de prueba con proyectos de siete ecosistemas y ocho carpetas trampa. Los resultados que reportamos como nuestros salen de esa prueba.

¿Qué es npkill?

npkill es una CLI de código abierto (licencia MIT, según el package.json del repositorio) que recorre un árbol de carpetas, lista cada carpeta “basura” que dejaron tus herramientas de desarrollo con su tamaño y el tiempo que llevas sin tocar el proyecto, y borra las que tú eliges. No se elimina nada hasta que lo seleccionas. No hace falta instalarla: npx npkill la ejecuta directamente, o npm i -g npkill si la vas a usar a menudo. La versión 1.0 requiere Node.js 20.19 o superior ("engines": { "node": ">=20.19.0" }).

Dentro de la interfaz, Espacio (o Supr) borra el resultado seleccionado, t activa la selección múltiple, / filtra por nombre o ruta (admite regex) y o abre la carpeta del proyecto.

¿Qué cambia en npkill 1.0?

Lo principal son los perfiles: conjuntos de carpetas objetivo por ecosistema. El perfil por defecto, node, cubre node_modules, .next, .nuxt, .angular, .svelte-kit, .vite, .nx, .turbo, .parcel-cache, .output, .docusaurus, storybook-static y coverage. Hay perfiles para python, java, rust, dotnet, unity, unreal, godot, elixir, cpp, infra y data-science, entre otros. Ejecuta npkill -p sin valor para listarlos, -p python,rust para combinarlos o -p all para todos.

El resto de la versión:

  • Objetivos inteligentes. Muchas carpetas solo cuentan si los archivos de alrededor confirman lo que son (lo vemos abajo, porque es lo que más probamos).
  • .npkillrc. Un archivo JSON con tus perfiles por defecto, exclusiones y perfiles propios. npkill usa el primero que encuentra: la ruta indicada con --config, luego ./.npkillrc y luego ~/.npkillrc.
  • --json y --json-stream para scripts y CI.
  • Una API. El núcleo ahora está separado de la CLI y se puede importar en tu propio código (documentado en el API.md del repositorio).
  • Filtros nuevos: --older-than 90 muestra solo proyectos sin tocar desde hace más de 90 días, y --exclude ahora acepta patrones.
  • Velocidad. El proyecto asegura que las búsquedas son hasta 3 veces más rápidas porque sus workers ahora comparten memoria. Es una cifra de los propios autores; no la medimos.

Ojo con la documentación: al momento de publicar esta nota (18 de noviembre de 2026), el archivo docs/profiles.md de la rama main atribuye al perfil node carpetas como .npm, .pnpm-store o .eslintcache, que el código de la versión 1.0.0 no incluye. La lista de arriba es la del código publicado en npm.

¿Es seguro borrar node_modules con npkill? Intentamos engañarlo

Sí, y lo comprobamos. La pregunta que decide si usas un limpiador una vez o cada mes es simple: ¿borra alguna vez algo que no debe? Una carpeta llamada target es la compilación de Rust en un proyecto y las hojas de cálculo del equipo de marketing en otro.

npkill 1.0 lo resuelve con reglas en su código: target solo cuenta junto a Cargo.toml, pom.xml o build.sbt; .venv, venv y env solo si contienen pyvenv.cfg; coverage solo si guarda lcov.info, coverage-final.json o clover.xml; el Library de Unity solo junto a Assets y ProjectSettings, y el deps de Elixir solo junto a mix.exs.

Armamos una máquina de prueba de 664 MB con 14 carpetas de compilación reales en Node, Python, Rust, Java, Unity, Elixir y .NET, y pusimos ocho imitaciones al lado: un target/ con una hoja de cálculo y sin manifiesto, un .venv/ con notas personales y sin pyvenv.cfg, un env/ con un archivo de secretos, un Library/ lleno de fotos, el deps/ de un proyecto en C, el obj/ de un modelo 3D, una carpeta de documentación llamada coverage/ y un .next/ huérfano sin package.json.

Ejecución Carpetas reales encontradas Imitaciones marcadas Espacio recuperable
npkill (perfil node por defecto) 5 0 258 MB
npkill -p all 14 de 14 0 de 8 633 MB

Encontró todas las carpetas reales y no tocó ninguna imitación. Un borrado real de las dos carpetas node_modules en una copia de la máquina la dejó en 479 MB (185 MB liberados), con las trampas intactas.

También protege las carpetas de las que dependen otras aplicaciones. En un directorio personal de prueba, un node_modules dentro de ~/.config quedó oculto por defecto y solo apareció con --include-sensitive, marcado como “Contains user configuration data (~/.config)”.

¿Cómo eliminar node modules de todos tus proyectos desde un script?

Con cuidado, porque aquí está la única trampa que encontramos. Para borrar sin interfaz, npkill tiene --delete-all (-D), y en la versión 1.0 se niega a funcionar con perfiles:

--delete-all only can be used with --targets.
To use profiles, run npkill without --delete-all and pick the results.

El problema es que --targets busca carpetas por nombre, sin las comprobaciones de arriba. Nuestra simulación con npkill -t target -D -y --dry-run listó las carpetas target de Rust y Java y también la de marketing. En un script desatendido, ese es exactamente el error que los perfiles existen para evitar.

Si necesitas una limpieza desatendida que conserve las comprobaciones, toma los resultados del perfil en JSON y borra tú esas rutas. Lo probamos, incluso con una ruta que tenía un espacio:

npkill -p rust,java --json | jq -r '.results[].path' | tr '\n' '\0' | xargs -0 rm -rf

Borró las dos carpetas target reales y dejó en paz la de marketing. Ejecútalo primero sin la parte de xargs para revisar la lista. Usa --targets con -D solo para nombres sin ambigüedad como node_modules, y prueba siempre antes con --dry-run.

¿Cómo liberar espacio en disco con Node, Python y Rust a la vez?

Crea un .npkillrc en tu carpeta de proyectos o en tu directorio personal:

{
  "defaultProfiles": ["node", "python", "rust"],
  "exclude": ["archive"]
}

A partir de ahí, un simple npkill revisa los tres ecosistemas y se salta todo lo que esté bajo archive. En nuestra prueba, esos mismos tres perfiles encontraron las nueve carpetas de Node, Python y Rust, y la carpeta que excluimos quedó fuera. Es la forma más directa de recuperar el disk space que se come un monorepo o una máquina con muchos proyectos.

También puedes definir tus propios perfiles. Las reglas aceptan nextTo (archivos que deben estar junto a la carpeta) y contains (archivos que deben estar dentro). La documentación solo describe nextTo, pero el código de la 1.0 valida los dos y a nosotros nos funcionaron ambos:

{
  "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"] }]
    }
  }
}

Luego ejecuta npkill -p rust-ci,venvs. Un perfil propio con el mismo nombre que uno incluido lo reemplaza.

La validación es estricta, y eso es bueno: una errata como "sortby" detiene npkill con la lista de propiedades válidas, y un nombre de perfil desconocido en defaultProfiles se rechaza indicando cuál es.

¿Cómo eliminar un entorno virtual de Python con npkill?

Ejecuta npkill -p python: lista cada .venv, venv o env que contenga pyvenv.cfg, junto con __pycache__, .pytest_cache, .mypy_cache y .ruff_cache. Una carpeta llamada .venv o env sin ese archivo no aparece; en nuestra prueba, un env/ con un archivo de secretos quedó fuera de la lista.

¿npkill o cargo clean?

Depende del alcance. cargo clean limpia el proyecto de Rust en el que estás; npkill -p rust recorre todos tus proyectos a la vez y te muestra cuánto ocupa cada target y hace cuánto no lo tocas, con --older-than para quedarte solo con los abandonados.

¿npkill borra la caché de npm?

No. La caché global de npm vive en tu directorio personal y no es lo que busca el perfil node de la versión 1.0, que se centra en las carpetas dentro de tus proyectos. Para la caché, npm tiene su propio comando, npm cache clean. Son dos limpiezas distintas que se complementan.

¿npkill 1.0 rompe mis scripts?

Puede que sí. Si llamas a npkill desde CI o desde tus dotfiles, revisa estos cambios de las notas de la versión:

  • --target ahora es --targets.
  • --sort last-mod ahora es --sort age.
  • -gb ahora es --size-unit gb.
  • --bg-color desaparece.
  • --delete-all ahora requiere --targets.
  • Las opciones desconocidas ahora dan error en vez de ignorarse.

Ese último cambio nos sorprendió. Al momento de publicar esta nota, el README de la rama main todavía listaba -x, --exclude-sensitive y -nu, --no-check-update, y npkill 1.0.0 rechaza las dos con Unknown options. Consulta npkill --help en la versión que tengas instalada: en la 1.0.0, los resultados sensibles se ocultan por defecto y --include-sensitive los muestra.


¿Y tú? ¿Cuántos gigas recuperaste en tu primera pasada de npkill?

¿Qué carpeta te ocupa más disco?
  • node_modules
  • .venv y cachés de Python
  • target de Rust o Java
  • Prefiero otra opción (cuéntanos cuál)
0 votantes

Comenta abajo o, si este artículo te llegó por correo, responde directamente al email: tu respuesta se publica aquí.

Relacionado: Mastering npx: A Cheatsheet for npm and Node.js Power Users