Terminal cleanup for development workspaces

Clean generated files from your projects.

Zapper scans your workspace for folders and files like node_modules, .next, dist, caches, and debug logs. Review the list, select what you want to remove, and delete it from the terminal.

$ curl -fsSL https://raw.githubusercontent.com/fdorantesm/zapper/main/install.sh | bash
NAVIGATE Path selection
Path: /Users/nano/workspace
/ Filter/Jump: komuni_
..
komuni-app/
komuni-api/
komuni-admin/
<up/down> Move <enter> Enter/Jump <space> Select Root <esc> Close
░█████████  ░██████   ░████████  ░████████   ░███████  ░██░████ 
     ░███        ░██  ░██    ░██ ░██    ░██ ░██    ░██ ░███     
   ░███     ░███████  ░██    ░██ ░██    ░██ ░█████████ ░██      
 ░███      ░██   ░██  ░███   ░██ ░███   ░██ ░██        ░██      
░█████████  ░█████░██ ░██░█████  ░██░█████   ░███████  ░██      
                      ░██        ░██                            
                      ░██        ░██
*/komuni-app/*dist

mode DRY RUN

Releasable space: 10.63 GB

Selected space: 0.00 GB

Space saved: 0.00 GB

Search completed 34.14s

version f49b31e-dirty

# PATH LAST MOD SIZE ↓
1/Users/nano/workspace/.DS_Store1d28.0 KB
2/Users/nano/workspace/komuni/komuni-app/.DS_Store9d8.0 KB
3/Users/nano/workspace/komuni/komuni-app/.next6d463 MB
4/Users/nano/workspace/komuni/komuni-app/node_modules8d947 MB
5/Users/nano/workspace/komuni/komuni-app/dist2d38 MB
6/Users/nano/workspace/komuni/komuni-api/node_modules3d812 MB
7/Users/nano/workspace/komuni/komuni-api/build3d24 MB
8/Users/nano/workspace/komuni/komuni-api/coverage22h18 MB
9/Users/nano/workspace/komuni/komuni-admin/node_modules5d690 MB
10/Users/nano/workspace/komuni/komuni-admin/.next5d214 MB
<j/k> Move + <c> Change Dir <:> regex filter <s> Sort Size <space> Select <a> All <d> Preview Delete <q> Quit

Scan, review, delete.

Run zap --dry-run to inspect matches first. Select rows in the TUI, then press d or enter to remove them.

01 / Inspect

Check what will be removed

Start with zap --dry-run. It shows every match, its path, age, and size without deleting anything.

02 / Select

Select the rows

Move with j/k, select with space, or press a to select all matches.

03 / Delete

Delete and see the total

Press d or enter. When it finishes, zap prints how much space was saved.

Quickstart

Run Zapper from source while developing locally.

go run src/main.go --dry-run

Commands

Use zap when installed as a binary.

zap --dry-run
zap --root ~/workspace --dirs node_modules,dist,.next
zap --yes --dirs node_modules,venv

Default targets

These names are scanned by default and can be replaced with --dirs.

node_modules venv .venv __pycache__ dist build coverage .next .nuxt .turbo .cache target .gradle .terraform debug logs

TUI keys

Navigate and clean without leaving the keyboard.

up/down j/k + c change dir space select : regex filter esc hide filter s sort size a select all d delete enter delete q quit