Features

• Scan — Recursively find all node_modules under your home directory
• Interactive — Multi-select with space bar, confirm with enter
• Safe — Moves to macOS Trash (recoverable via Finder), never rm -rf
• Smart — Skips system dirs (.Trash, Library, .cache, etc.)
• Flexible — Custom scan path, global mode, dry-run supported

Install

# Clone and build
git clone https://github.com/ArtLjn/clean-node-modules.git
cd clean-node-modules
npm install && npm run build

# Copy to PATH
cp dist/index.cjs ~/.local/bin/cnm && chmod +x ~/.local/bin/cnm

Usage

cnm                          # Scan home directory, select to clean
cnm --dry-run                # Preview only, no changes
cnm -g                       # Include global node_modules
cnm --path ~/projects        # Scan a specific directory
cnm -h                       # Help

How It Works

1. Recursively walks your directory tree (max depth 20)
2. Skips .Trash, Library, .cache, and other system directories
3. Calculates each node_modules size via du -sk
4. Displays sorted list with interactive checkbox selection
5. Moves selected directories to ~/.Trash/ (with conflict handling)
6. Falls back to osascript Finder move if cross-volume rename fails

Recovery

Cleaned directories go to macOS Trash. A .node_modules-trashed marker file is left in the original project directory with the restore command:

# Example restore
mv ~/.Trash/node_modules "/path/to/project/node_modules"

License

MIT