projclean

Interactive TUI to reclaim disk space by finding and cleaning build/ (Gradle) and target/ (Maven) folders across all your JVM projects. Scans up to 8 directory levels deep from your home directory.

Features

• Fast parallel scanning — uses fast-glob with up to 8 levels deep from ~/, skipping irrelevant folders (node_modules, .git, build, target).
• Safety validation — verifies standard JVM build artifacts before marking a folder for deletion, preventing accidental removal of non-JVM build/ directories.
• Multi-module aware — consolidates multi-module Gradle/Maven projects (JAR, WAR, EAR, etc.) into a single entry showing accurate module count and combined size.
• Concurrent size calculation — folder sizes are computed in parallel with up to 16 concurrent I/O workers while the TUI is already interactive.
• Clean interactive TUI — keyboard-driven list with selection, bulk operations, and a confirmation dialog before any deletion.

Requirements

• Node.js >= 24

Usage

npx projclean

Or install globally:

npm install -g projclean
projclean

Key Bindings

| Key | Action | |-----|--------| | ↑ / k | Move cursor up | | ↓ / j | Move cursor down | | g / G | Jump to top / bottom of list | | SPACE | Select / deselect (advances cursor) | | ENTER | Select / deselect (stays on row) | | a | Select / deselect all projects | | D | Delete selected projects | | Q / ESC | Quit |

Running Locally

git clone https://github.com/alexjcm/projclean.git
cd projclean
npm install
npm run dev

Building

npm run build

Compiles TypeScript to dist/ and marks the output as executable. Test locally with:

npm link
projclean

Future Enhancements

• [ ] Support for other ecosystems (Node.js node_modules, Python __pycache__, etc.)
• [ ] iOS project cleanup (DerivedData)
• [ ] Filter / search by project name