Mole

🦡 Dig deep like a mole to clean your Mac.

Mole - 95.50GB freed

## Features at a Glance - 🐦 **Deep System Cleanup** - Remove hidden caches, logs, and temp files in one sweep - 📦 **Thorough Uninstall** - 22+ locations cleaned vs 1 standard, beats CleanMyMac/Lemon - 📊 **Interactive Disk Analyzer** - Navigate folders like a file manager, find and delete large files instantly - ⚡️ **Fast & Lightweight** - Terminal-based, zero bloat, arrow-key navigation with pagination - 🧹 **Massive Space Recovery** - Reclaim 100GB+ of wasted disk space ## Quick Start **Install:** ```bash curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash ``` Or via Homebrew: ```bash brew install tw93/tap/mole ``` **Run:** ```bash mole # Interactive menu mole clean # System cleanup mole clean --dry-run # Preview mode mole clean --whitelist # Manage protected caches mole uninstall # Uninstall apps mole analyze # Disk analyzer mole update # Update Mole mole remove # Remove Mole from system mole --help # Show help ``` > 💡 New to terminal? Check [小白使用指南](./GUIDE.md) · Homebrew users: `brew upgrade mole` to update > > 💡 **Tip:** Run `mole clean --dry-run` to preview, or `mole clean --whitelist` to protect important caches before cleanup ## Features ### Deep System Cleanup ```bash $ mole clean ▶ System essentials ✓ User app cache (45.2GB) # Caches, logs, trash 20-50GB typical ✓ User app logs (2.1GB) ✓ Trash (12.3GB) ▶ Browser cleanup # Chrome, Safari, Arc 5-15GB typical ✓ Chrome cache (8.4GB) ✓ Safari cache (2.1GB) ▶ Developer tools # npm, Docker, Xcode 15-40GB typical ✓ Xcode derived data (9.1GB) ✓ Node.js cache (14.2GB) ▶ Others # Cloud, Office, Media 10-40GB typical ✓ Dropbox cache (5.2GB) ✓ Spotify cache (3.1GB) ==================================================================== 🎉 CLEANUP COMPLETE! 💾 Space freed: 95.50GB | Free space now: 223.5GB ==================================================================== ``` **Whitelist Protection:** ```bash mole clean --whitelist # Interactive - select caches to protect # Default: Playwright browsers, HuggingFace models (always protected) # Or edit: ~/.config/mole/whitelist ``` ### 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 # /Applications/ ✓ Cleaned 52 related files # ~/Library/ across 12 locations - Support files & caches # Application Support, Caches - Preferences & logs # Preferences, Logs - WebKit storage & cookies # WebKit, HTTPStorages - Extensions & plugins # Internet Plug-Ins, Services - System files with sudo # /Library/, Launch daemons ==================================================================== 🎉 UNINSTALLATION COMPLETE! Space freed: 12.8GB ==================================================================== ``` ### Disk Space Analyzer ```bash $ mole analyze 📊 Analyzing: /Users/tw93 ═══════════════════════════════════════════════════════ Total: 156.8GB ├─ 📁 Library 45.2GB │ ├─ 📁 Caches 28.4GB │ └─ 📁 Application Support 16.8GB ├─ 📁 Downloads 32.6GB │ ├─ 📄 Xcode-14.3.1.dmg 12.3GB │ ├─ 📄 backup_2023.zip 8.6GB │ └─ 📦 old_projects.tar.gz 5.2GB ├─ 📁 Movies 28.9GB │ ├─ 📄 vacation_2023.mov 15.4GB │ └─ 📄 screencast_raw.mp4 8.8GB ├─ 📁 Documents 18.4GB └─ 📁 Desktop 12.7GB 💡 Navigate folders to find large files, press Delete key to remove ``` ## FAQ 1. **Is Mole safe?** – Mole focuses on cleaning caches and logs, without touching app settings, user documents, or system files. You can run `mole clean --dry-run` to preview what will be removed before actually cleaning. 2. **How often should I clean?** – About once a month, or whenever you notice disk space running low. 3. **Can I protect specific caches?** – Yes. Run `mole clean --whitelist` to interactively choose which caches to keep. Some common ones like Playwright browsers and HuggingFace models are already protected by default. ## Support - ⭐️ **Star this repo** if Mole helped you recover disk space - 💬 **Share with friends** who need to clean their Macs - 🐛 **Report issues** via [GitHub Issues](https://github.com/tw93/mole/issues) - 🐱 I have two cats, feed them canned food if you'd like ## License MIT License - feel free to enjoy and participate in open source.