Mole – Dig deep like a mole to clean your Mac

1 month ago 7

🦡 Dig deep like a mole to clean your Mac.

🐦 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

Install:

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

Or via Homebrew:

brew install tw93/tap/mole

Run:

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 --help # Show help

💡 New to terminal? Check 小白使用指南 · 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

$ 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:

mole clean --whitelist # Interactive - select caches to protect # Default: Playwright browsers, HuggingFace models (always protected) # Or edit: ~/.config/mole/whitelist

$ 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 ====================================================================

$ 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

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.
How often should I clean? – About once a month, or whenever you notice disk space running low.
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.