node-modulator

CLI tool that recursively finds and deletes all node_modules directories under the current directory.

Usage

npx node-modulator

Or run directly after building:

npm run build
node dist/index.js

What it does

1. Displays the current directory and scans for node_modules directories
2. Lists all found directories and asks for confirmation before deleting
3. Deletes each directory, showing progress and size
4. Prints a summary report with total count and space freed

Nested node_modules inside a parent node_modules are automatically skipped since deleting the parent covers them.

Example

node-modulator
==============

Current directory: /Users/you/projects

Scanning for node_modules directories...

Found 3 node_modules directories:

  my-app
  libs/utils
  libs/components

Delete all 3 node_modules directories? (y/N) y

[1/3] Deleting my-app/node_modules... done (245.3 MB)
[2/3] Deleting libs/utils/node_modules... done (112.7 MB)
[3/3] Deleting libs/components/node_modules... done (89.1 MB)

========================================
Report
========================================

Deleted directories:

  my-app/node_modules  (245.3 MB)
  libs/utils/node_modules  (112.7 MB)
  libs/components/node_modules  (89.1 MB)

Total: 3 directories deleted, 447.1 MB freed.

Building from source

npm install
npm run build

Requirements

• Node.js 18+
• Works on macOS and Windows

License

MIT