TL;DR
I got tired of "disk full" warnings and $90 cleaning apps, so I built MacCleanCLI - a free, open-source terminal tool that safely cleans your Mac.
The Problem ๐ค
My 256GB MacBook: "Your disk is almost full"
Me: Checks CleanMyMac price... $89.95
Also me: "I can build this"
The Solution ๐
# Install
brew in future
git clone https://github.com/qdenka/MacCleanCLI.git
cd MacCleanCLI
pip install -e .
python main.py
# Run
mclean
What It Cleans ๐งน
- System & browser caches
- Temp files & old logs
- Downloads folder cruft
- Duplicate files
- App leftovers
- Much more!
Key Features โจ
# Safe by design
PROTECTED_PATHS = ['/System', '/Library/Extensions', '/usr']
# Beautiful UI with Rich
from rich.console import Console
from rich.progress import Progress
# Multi-threaded for speed
with ThreadPoolExecutor(max_workers=4) as executor:
# Scan all the things!
Results ๐
- Before: 12GB free space ๐ฑ
- After: 47GB free space ๐
- Time: 2 minutes
- Cost: $0
Why It's Different ๐
| Feature | MacCleanCLI | CleanMyMac |
|---|---|---|
| Price | Free | $89.95 |
| Open Source | โ | โ |
| Privacy | 100% Local | Cloud Features |
| Terminal-Native | โ | โ |
| Customizable | โ | Limited |
Try It Now! ๐
# See it in action
git clone https://github.com/QDenka/MacCleanCLI
cd MacCleanCLI
python main.py --scan-only
Like it? Star it on GitHub โญ
Questions? Open an issue!
Want to help? PRs welcome!
What tools have you built to solve your own problems? Share in the comments! ๐

Top comments (1)
Nice posting! Can we have a conversation asap?
Some comments may only be visible to logged-in visitors. Sign in to view all comments.