- π¦ Deep System Cleanup - Remove hidden caches, logs, and temp files in one sweep
- π¦ Smart Uninstall - Complete app removal with all related files and folders
- β‘οΈ Fast Interactive UI - Arrow-key navigation with pagination for large lists
- π§Ή Massive Space Recovery - Reclaim 100GB+ of wasted disk space
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bashπ δΈδΌη¨η»η«―οΌ ζ₯η ε°η½δ½Ώη¨ζε δΊθ§£θ―¦η»ηζη¨
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 Mole to the latest version
mole --help # Show helpNavigation: Use arrow keys (β/β), Space to select, Enter to confirm, Q to quit or Ctrl+C to force exit.
$ 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 |
- If Mole helps you recover disk space, star this repository and share with fellow Mac users.
- Report issues via GitHub Issues.
- I have two cats, you can feed them canned food if you'd like.
MIT License - feel free to enjoy and participate in open source.