This tool allows you to list, rename, remove, delete any files and folders based on anything you want.
-
Clear space: Get rid of old and dusty files cluttering up your machine.
-
Super customizable: Choose your preferred language and theme, save any rules you want.
-
Easy to use: Say goodbye to manual actions or rusty UI from another decades
Simply use the following command:
$ npm run installOr if for some reason you really want to install it:
$ yarn$ npx npkill
# or just npkill if installed globallyBy default, npkill will scan for node_modules starting at the path where npkill command is executed.
Move between the listed folders with ↓ ↑, and use Space to delete the selected folder. You can also use j and k to move between the results
To exit, Q or Ctrl + c if you're brave.
| ARGUMENT | DESCRIPTION |
|---|---|
| -c, --bg-color | Change row highlight color. (Available: blue, cyan, magenta, white, red and yellow) |
| -d, --directory | Set the directory from which to begin searching. By default, starting-point is . |
| -D, --delete-all | CURRENTLY DISABLED. Automatically delete all node_modules folders that are found |
| -e, --show-errors | Show error messages related to the search if any |
| -f, --full | Start searching from the home of the user (example: "/home/user" in linux) |
| -gb | Show folders in Gigabytes instead of Megabytes. |
| -h, --help, ? | Show this help page and exit |
| -nu, --no-check-update | Dont check for updates on startup |
| -s, --sort | Sort results by: size or path [ beta ] |
| -t, --target | Specify the name of the directories you want to search (by default, is node_modules) |
| -v, --version | Show npkill version |
Warning: In future versions some commands may change
- Search node_modules directories in your projects directory:
npkill -d ~/projects
# other alternative:
cd ~/projects
npkill- List directories called "dist" and and show errors if any occur:
npkill --target dist -e- Displays the magenta color cursor... because I like magenta!
npkill --color magenta- List vendor directories in your projects directory, sort by size, and show that in gb:
npkill -d '~/more projects' -gb --sort size --target vendor- Automatically delete all node_modules that have sneaked into your backups:
# Disabled for security reasons (you can use it in version 0.2.4 at your risk)
npkill -d ~/backups/ --delete-all# -- First, clone the repository
git clone https://github.com/voidcosmos/npkill.git
# -- Navigate to the dir
cd npkill
# -- Install dependencies
npm install
# -- And run!
npm run start
# -- If you want to run it with some parameter, you will have to add "--" as in the following example:
npm run start -- -f -e- Release 0.1.0 !
- Improve code
- Improve performance
- Improve performance even more!
- Sort results by size and path
- Allow the search for other types of directories (targets)
- Reduce dependencies to be a more minimalist module
- Allow to filter by directories that have not been used in a period of time
- Create option for displaying directories in tree format
- Add some menus
- Periodic and automatic cleaning (?)
- Sometimes, CLI is blocked while folder is deleting.
- Some terminals that do not use TTY (like git bash in windows) do not work.
- Sorting, especially by routes, can slow down the terminal when there are many results at the same time.
- (SOLVED) Performance issues when searching from high level directories (like / in linux).
- (SOLVED) Sometimes text collapses when updating the cli.
- (SOLVED) Analyzing the size of the directories takes longer than it should.
If you find any bugs, don't hesitate and open an issue :)
If you want to contribute check the CONTRIBUTING.md
I will continue to do things anyway, but donations are one of the many ways to support what I do.
- btc: 14KXSryVBLMiJ6dseib4LUgZjkB2pRpTkh
MIT © Antoine Mesnil
🐱🐤