Mole Logo

Mole

๐Ÿฆก Dig deep like a mole to clean your Mac.

Stars Version License

## Highlights - ๐Ÿฆ **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 ## Installation ```bash curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash ``` Or via Homebrew: ```bash brew install tw93/tap/mole ``` > Pick one method to avoid conflicts, new users check [ๅฐ็™ฝไฝฟ็”จๆŒ‡ๅ—](./GUIDE.md) ## Usage ```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 to latest version mole --help # Show help ``` > Installed via Homebrew? Use `brew upgrade mole` to update ## Examples ### Deep System Cleanup ```bash $ 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 ==================================================================== ``` ### Smart App Uninstaller ```bash $ 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 ==================================================================== ``` ## What Mole Cleans | 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: ```bash # View current whitelist mole clean --whitelist # Example: Protect Playwright browsers and build tools echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist ``` ## What Mole Uninstalls | 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` | ## FAQ **Q: Will Mole delete important files?** A: No. Mole has built-in protection and skips system-critical files. **Q: Can I undo cleanup operations?** A: Cache files regenerate automatically. For uninstalled apps, use Time Machine backup beforehand. **Q: How often should I run cleanup?** A: Once a month is sufficient. Run when disk space is low. **Q: Is it safe to use?** A: Yes. The tool previews what will be deleted before any action (`--dry-run`). ## Support - โญ๏ธ **Star this repo** if Mole helped you recover disk space - ๐Ÿ› **Report issues** via [GitHub Issues](https://github.com/tw93/mole/issues) - ๐Ÿ’ฌ **Share with friends** who need to clean their Macs - ๐Ÿฑ I have two cats, feed them canned food if you'd like ## License MIT License - feel free to enjoy and participate in open source.