██╗    ██╗██╗██████╗ ███████╗███╗   ██╗██╗   ██╗
██║    ██║██║██╔══██╗██╔════╝████╗  ██║██║   ██║
██║ █╗ ██║██║██████╔╝█████╗  ██╔██╗ ██║██║   ██║
██║███╗██║██║██╔═══╝ ██╔══╝  ██║╚██╗██║╚██╗ ██╔╝
╚███╔███╔╝██║██║     ███████╗██║ ╚████║ ╚████╔╝
 ╚══╝╚══╝ ╚═╝╚═╝     ╚══════╝╚═╝  ╚═══╝  ╚═══╝

A fast CLI tool to find and delete node_modules and .venv directories to free up disk space. Written in Go, distributed via npm/bun.

Similar to npkill but faster and also cleans Python virtual environments.

wipenv.mp4

Features

• Fast - Written in Go for maximum performance
• node_modules - Find and delete npm package directories
• .venv - Find and delete Python virtual environments
• Real-time stats - See total disk space used and freed
• Keyboard navigation - Easy navigation with arrow keys
• Beautiful TUI - Interactive terminal user interface

Installation

npm

npm install -g wipenv

bun

bun add -g wipenv

From source (requires Go 1.21+)

git clone https://github.com/raghav3615/wipenv.git
cd wipenv
go build -o wipenv ./cmd/wipenv

Usage

Simply run wipenv or WIPENV in your terminal:

wipenv

Or specify a directory to scan:

wipenv ~/projects
wipenv /path/to/directory

Options

-h, --help      Show help message
-v, --version   Show version information

Controls

Key	Action
↑/k	Move cursor up
↓/j	Move cursor down
Space	Delete selected folder
Enter	Confirm selection (menu)
Esc	Go back to menu
q	Quit

How it works

1. Select what to clean - Choose between node_modules, .venv, or both
2. Scan - WIPENV recursively scans the selected directory
3. Review - See all found folders with their sizes
4. Delete - Press Space to delete unwanted folders
5. Track - Watch the freed space counter go up!

Screenshots

Menu Screen

██╗    ██╗██╗██████╗ ███████╗███╗   ██╗██╗   ██╗
██║    ██║██║██╔══██╗██╔════╝████╗  ██║██║   ██║
██║ █╗ ██║██║██████╔╝█████╗  ██╔██╗ ██║██║   ██║
██║███╗██║██║██╔═══╝ ██╔══╝  ██║╚██╗██║╚██╗ ██╔╝
╚███╔███╔╝██║██║     ███████╗██║ ╚████║ ╚████╔╝
 ╚══╝╚══╝ ╚═╝╚═╝     ╚══════╝╚═╝  ╚═══╝  ╚═══╝

Select what to clean:

▶ node_modules (npm packages)
  .venv (Python virtual environments)
  Both (node_modules + .venv)

↑/↓: Navigate • Enter: Select • q: Quit

Scan Screen

✓ Scan complete  │  Total: 5.23 GB  │  Free: 1.02 GB  │  Folders: 15

▶ [npm]    512.34 MB  ~/projects/app1/node_modules
  [npm]    256.12 MB  ~/projects/app2/node_modules
  [venv]   128.45 MB  ~/projects/ml-project/.venv ✓ DELETED
  [npm]    891.23 MB  ~/projects/website/node_modules

↑/↓: Navigate • Space: Delete • Esc: Back • q: Quit

Session Summary

When you quit with q, WIPENV shows a summary of space freed:

Session complete! Free space: 1.02 GB

Why "WIPENV"?

"Wipenv" combines "wipe" and "env" - it wipes your environment folders (node_modules and .venv) to free up disk space.

License

MIT License - see LICENSE file for details.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request