- π¦ Deep System Cleanup - Remove hidden caches, logs, and temp files in one sweep
- π¦ Thorough Uninstall - 22+ locations cleaned vs 1 standard, beats CleanMyMac/Lemon
- β‘οΈ Fast & Lightweight - Terminal-based, zero bloat, arrow-key navigation with pagination
- π§Ή Massive Space Recovery - Reclaim 100GB+ of wasted disk space
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bashOr via Homebrew:
brew install tw93/tap/molePick one method to avoid conflicts, new users check ε°η½δ½Ώη¨ζε
mole # Interactive main menu
mole clean # Deep system cleanup
mole clean --dry-run # Preview cleanup (no deletions)
mole uninstall # Interactive app uninstaller
mole update # Update to latest version
mole --help # Show helpInstalled via Homebrew? Use
brew upgrade moleto update
$ mole clean
Starting user-level cleanup...
βΆ System essentials
β User app cache (28 items) (45.2GB)
β User app logs (15 items) (2.1GB)
β Trash (12.3GB)
βΆ Browser cleanup
β Chrome cache (8 items) (8.4GB)
β Safari cache (2.1GB)
β Arc cache (3.2GB)
βΆ Extended developer caches
β Xcode derived data (9.1GB)
β Node.js cache (4 items) (14.2GB)
β VS Code cache (1.4GB)
βΆ Applications
β JetBrains cache (3.8GB)
β Slack cache (2.2GB)
β Discord cache (1.8GB)
====================================================================
π CLEANUP COMPLETE!
πΎ Space freed: 95.50GB | Free space now: 223.5GB
π Files cleaned: 6420 | Categories processed: 6
====================================================================$ mole uninstall
Select Apps to Remove
βΆ β Adobe Creative Cloud (12.4G) | Old
β WeChat (2.1G) | Recent
β Final Cut Pro (3.8G) | Recent
ποΈ Uninstalling: Adobe Creative Cloud
β Removed application
β Cleaned 52 related files
====================================================================
π UNINSTALLATION COMPLETE!
ποΈ Apps uninstalled: 1 | Space freed: 12.8GB
====================================================================| Category | Targets | Typical Recovery |
|---|---|---|
| System | App caches, logs, trash, crash reports, Spotlight cache | 20-50GB |
| Browsers | Safari, Chrome, Edge, Arc, Firefox, Brave cache | 5-15GB |
| Developer | npm, pip, Docker, Homebrew, Xcode, Android Studio | 15-40GB |
| Cloud Storage | Dropbox, Google Drive, OneDrive, Baidu Netdisk cache | 5-20GB |
| Office Apps | Microsoft Office, iWork, WPS Office cache | 2-8GB |
| Media Apps | Spotify, Music, VLC, IINA, video players cache | 3-12GB |
| Communication | Slack, Discord, Teams, WeChat, Zoom cache | 3-10GB |
| Virtualization | VMware, Parallels, VirtualBox, Vagrant cache | 5-15GB |
Protect Important Files: Create ~/.config/mole/whitelist to preserve critical caches:
# View current whitelist
mole clean --whitelist
# Example: Protect Playwright browsers and build tools
echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist| Category | What Gets Removed | Locations |
|---|---|---|
| App Bundle | Main application executable | /Applications/ |
| User Data | Support files, caches, preferences, logs, containers, saved states | ~/Library/ (12 locations) |
| Web Data | WebKit storage, HTTP storage, cookies | ~/Library/WebKit/, ~/Library/HTTPStorages/ |
| Extensions | Plugins, scripts, services, frameworks, QuickLook generators | ~/Library/Internet Plug-Ins/, ~/Library/Services/ |
| System | Launch daemons, helper tools, system preferences, install receipts | /Library/, /var/db/receipts/ (requires sudo) |
- Will Mole delete important files? - No. Mole has built-in protection and skips system-critical files.
- Can I undo cleanup operations? - Cache files are safe to delete and will regenerate automatically.
- How often should I run cleanup? - Once a month is sufficient. Run when disk space is low.
- Is it safe to use? - Yes. The tool previews what will be deleted before any action (
--dry-run).
- βοΈ Star this repo if Mole helped you recover disk space
- π Report issues via GitHub Issues
- π¬ Share with friends who need to clean their Macs
- π± I have two cats, feed them canned food if you'd like
MIT License - feel free to enjoy and participate in open source.