Npkill is a CLI tool that allows you to list all the heavy node_modules that you have scattered around your computer and allows you to delete those you don't need in a very simple and elegant way.
You might be surprised how much space node_modules from old projects are silly taking up.
Npkill looks for node_modules or any other directory at low level and in a distributed way, so it will make almost full use of disk and CPU capacities.
A, B and C. No weird stories. Intuitive to use.
npx npkill on your terminal.
Some applications installed on the system (like spotify or discord) need their node_modules directory to work and deleting them may break them. Npkill will highlight them by displaying a ⚠️ to be careful.
| Arg | Description | Default |
|---|---|---|
| -c, --bg-color | Change row highlight color. Available: blue, cyan, magenta, white, red and yellow | blue |
| -d, --directory | Set the directory from which to begin searching | . |
| -D, --delete-all | CURRENTLY DISABLED. Automatically delete all node_modules folders that are found. | -- |
| -e, --show-errors | Show error messages if any | false |
| -E, --exclude | Exclude directories from search (directory name list must be inside double quotes "", each directory separated by ',' ) Example: "ignore1, ignore2" | -- |
| -f, --full | Start searching from the home of the user (example: "/home/user" in linux) | false |
| -gb | Show folders size in Gigabytes instead of Megabytes | false |
| -h, --help, ? | Show help | false |
| -nu, --no-check-update | Dont check for updates on startup | false |
| -s, --sort | Sort results by: size, path or last-mod | none |
| -t, --target | Specify the name of the directories you want to search | node_modules |
| -x, --exclude-hidden-directories | Exclude hidden directories ("dot" directories) from search. | false |
| -v, --version | Show npkill version | false |
Many thanks to all those who have also supported the project financially!
