Folder Weight Watcher
Finds what's actually eating your disk, and offers to take out the bins.
What you're making
Your drive is full and you have no idea why. This scans a folder and shows you the biggest offenders as a visual bar chart right in the terminal, then spots the obvious junk — old node_modules, build folders, caches you forgot about — and offers to delete them. It always asks first, and always tells you exactly how much you'd get back.
A disk usage explorer that walks a directory tree, ranks what's taking space, and recognises common reclaimable folders. The interesting work is scanning a huge tree quickly and never deleting anything without an explicit, informed confirmation.
Hosting · Free forever
Deploys free on npm, PyPI or GitHub Releases.
Nothing to host. Publishing to a package registry is free and permanent, and anyone can run it with a single command.
Publish to npm — one command and anyone can run it.
Core features · 7
- Walks a directory tree and totals size per folder
- Ranks the biggest folders with a bar chart in the terminal
- Recognises reclaimable folders like node_modules and build caches
- Shows exactly how much each deletion would free before you agree
- Never deletes without an explicit confirmation naming the target
- Stays responsive on trees with hundreds of thousands of files
- Skips symlinks so it can't wander outside the folder you chose
The interesting part
- Walking a very large tree without exhausting memory or file handles
- Symlink loops, which will hang a naive recursive walk forever
- Designing a destructive confirmation that's genuinely hard to fat-finger
Once it works
- Add an interactive mode you can arrow through
- Remember previous scans and show what grew
- Add a dry-run flag that only reports