A TUI tool with two modes:
- Prune -- find and delete heavy cache/dependency directories (
node_modules,Pods,.gradle,target/, etc.) - Ports -- list and kill processes by port (dev servers, stale listeners, etc.)
Switch between modes with Tab, 1, or 2. Vim-style keybindings throughout.
cargo install lazypruneOr build from source:
git clone https://github.com/ThibaultJRD/lazyprune.git
cd lazyprune
cargo install --path .lazyprune # Start in prune mode (default)
lazyprune -p / --ports # Start in ports mode
lazyprune ~/Develop # Scan a specific directory
lazyprune -t / --target node_modules # Only look for node_modules
lazyprune -d / --dry-run # Print results to stdout, no TUI
lazyprune --dry-run --ports # Print open ports to stdout
lazyprune -H / --hidden # Also scan hidden directories (e.g. ~/.cache)
lazyprune -D / --dir vendor # Scan for arbitrary directory names (ad-hoc)
lazyprune --init-config # Generate config at ~/.config/lazyprune/config.toml| Key | Action |
|---|---|
Tab |
Toggle between Prune and Ports |
1 / 2 |
Switch to Prune / Ports |
j/k ↑/↓ |
Navigate |
g/G |
Jump top/bottom |
Space |
Toggle selection |
v |
Invert selection |
Ctrl+a |
Select all |
/ |
Filter |
s |
Cycle sort |
l/→/Enter |
Open details panel |
h/←/Esc |
Back to list |
? |
Help |
q |
Quit |
| Key | Action |
|---|---|
d |
Delete selected directories |
t |
Filter by target type |
p |
Toggle project grouping |
y |
Copy path (in details) |
| Key | Action |
|---|---|
d |
Kill selected ports |
t |
Filter by protocol (TCP/UDP) |
a |
Toggle dev port filter |
r |
Refresh port list |
Override defaults with ~/.config/lazyprune/config.toml:
root = "~"
skip = [".Trash", "Library", "Applications"]
[[targets]]
name = "node_modules"
dirs = ["node_modules"]
indicator = "package.json"
# --- Ports mode ---
[ports]
# Only show ports matching these ranges on startup (toggle with 'a' in TUI)
dev_filter_enabled = true
# Port ranges to show when dev filter is active (supports "PORT" and "START-END")
dev_filter = ["3000-3009", "4000-4009", "5173-5174", "8080-8090"]Targets have:
dirs-- directory names to look forindicator(optional) -- a file that must exist in the parent to confirm it's a real target
Default targets: node_modules, Pods, .gradle/build, .pnpm-store, .yarn/cache, .next, .nuxt, target (Rust), dist.
Ports config:
dev_filter_enabled-- only show ports in the configured ranges on startupdev_filter-- list of port ranges ("3000-3009") and individual ports ("5173")
Prune mode:
- Walks the filesystem, computes directory sizes in parallel with rayon
- Skips hidden directories unless they match a target
- Never follows symlinks
- Deletion requires explicit confirmation
Ports mode:
- Lists open ports via
lsof, deduplicates by port/protocol - Dev filter hides system ports, showing only your dev servers
- Kill sends SIGTERM, then SIGKILL after 500ms if the process survives
- Kill requires explicit confirmation
MIT