- π¦ Deep System Cleanup - Remove hidden caches, logs, and temp files in one sweep
- π¦ Thorough Uninstall - Removes more app leftovers than CleanMyMac/Lemon, completely free
- β‘οΈ 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 45 related files
====================================================================
π UNINSTALLATION COMPLETE!
ποΈ Apps uninstalled: 1 | Space freed: 12.4GB
====================================================================| Category | Targets | Typical Recovery |
|---|---|---|
| System | App caches, logs, trash, crash reports | 20-50GB |
| Browsers | Safari, Chrome, Edge, Arc, Firefox cache | 5-15GB |
| Developer | npm, pip, Docker, Homebrew, Xcode | 15-40GB |
| Apps | Slack, Discord, Teams, Notion cache | 3-10GB |
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| Component | Files Removed | Examples |
|---|---|---|
| App Bundle | Main .app executable | /Applications/App.app |
| Support Data | App-specific user data | ~/Library/Application Support/AppName |
| Cache Files | Temporary & cache data | ~/Library/Caches/com.company.app |
| Preferences | Settings & config files | ~/Library/Preferences/com.app.plist |
| Logs & Reports | Crash reports & logs | ~/Library/Logs/AppName |
| Containers | Sandboxed app data | ~/Library/Containers/com.app.id |
- 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.