Skip to content

This tool allows you to list any node_modules directories in your system, as well as the space they take up. You can then select which ones you want to erase to free up space. Yay!

License

Notifications You must be signed in to change notification settings

shaunstanislauslau/npkill

 
 

Repository files navigation

npkill logo npkill logo scope

npm npm version NPM

Easily find and remove old and heavy node_modules folders ✨

npkill demo gif

This tool allows you to list any node_modules directories in your system, as well as the space they take up. You can then select which ones you want to erase to free up space. Yay!

Table of Contents

Features

  • Clear space: Get rid of old and dusty node_modules cluttering up your machine.

  • Very fast: NPKILL is written in TypeScript, but searches are performed at a low level, improving performance greatly.

  • Easy to use: Say goodbye to lengthy commands. Using npkill is as simple as reading a list of your node_modules, and pressing Del to get rid of them. Could it be any easier? ;)

  • Minified: It barely has any dependencies.

Installation

$ npm i -g npkill

Unix users may need to run the command with sudo

Usage

$ npkill

By 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 (v0.2.2 and below the key was Del).

To exit, Q or Ctrl + c if you're brave.

Options

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)
-h, --help, ? Show this help page and exit
-v, --version Show npkill version

Warning: In future versions some commands may change

Examples

  • Search node_modules directories in your projects directory:
npkill -d ~/projects

# other alternative:
cd ~/projects
npkill
  • Delete all node_modules that have sneaked into your backups, and show errors if any occur:
npkill -d ~/backups/ -e

Roadmap

  • Release 0.1.0 !
  • Improve code
    • Improve performance
    • Improve performance even more!
  • Reduce dependencies to be a more minimalist module
  • Allow the search for other types of directories (targets)
  • 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 (?)

Known-bugs

  • Sometimes, CLI is blocked while folder is deleting.
  • (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.
  • (SOLVED) State "searching..." does not change even if search has been completed

If you find any bugs, don't hesitate and open an issue :)

Contributing

Available soon


About

This tool allows you to list any node_modules directories in your system, as well as the space they take up. You can then select which ones you want to erase to free up space. Yay!

Resources

License

Code of conduct

Stars

Watchers

Forks

Packages

No packages published

Languages

  • TypeScript 93.3%
  • JavaScript 5.0%
  • Go 1.7%