purgeit

Reclaim disk space from node_modules, dist, target, Pods, and more. Interactive TUI by default, scriptable via flags for CI/cron.

Features

Safe by default

Nothing is selected. Permanent deletion requires explicit multi-select + confirmation.

Interactive TUI

Sortable table with live sizes, full-row highlight selection, and keyboard-driven workflow.

Headless mode

--json and --delete flags for scripting, CI, and cron jobs.

Configurable rules

Extend built-in defaults with a purgeit.config.ts.

Two scan modes

Projects mode groups by top-level directory; flat mode (--full) scans everything as one unit.

Cross-platform

macOS, Linux, and Windows. Uses du on Unix; pure-Node fallback on Windows.

# Run without installing
npx purgeit ~/dev

# Or install globally
npm install -g purgeit
purgeit ~/dev

No config required. See the CLI reference for --json, --delete, --dry-run, and every other flag.