Mole/README.md

Mole

🦡 Dig deep like a mole to clean your Mac.

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:

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

Features

🧹 Deep System Cleanup

$ mole clean

▶ System essentials
  ✓ User app cache (45.2GB)        # Caches, logs, trash (20-50GB)
  ✓ User app logs (2.1GB)
  ✓ Trash (12.3GB)

▶ Browser cleanup                   # Chrome, Safari, Arc (5-15GB)
  ✓ Chrome cache (8.4GB)
  ✓ Safari cache (2.1GB)

▶ Developer tools                   # npm, Docker, Xcode (15-40GB)
  ✓ Xcode derived data (9.1GB)
  ✓ Node.js cache (14.2GB)

▶ Others                            # Cloud, Office, Media (10-40GB)
  ✓ Dropbox cache (5.2GB)
  ✓ Spotify cache (3.1GB)

====================================================================
🎉 CLEANUP COMPLETE!
💾 Space freed: 95.50GB | Free space now: 223.5GB
====================================================================

Protect important files:

# View whitelist
mole clean --whitelist

# Add protection
echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist

🗑️ Smart App Uninstaller

$ 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/ (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 (sudo)            # /Library/, Launch daemons

====================================================================
🎉 UNINSTALLATION COMPLETE!
Space freed: 12.8GB
====================================================================

📊 Disk Space Analyzer

$ 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. Will Mole delete important files? - No. Mole has built-in protection and skips system-critical files.
2. Can I undo cleanup operations? - Cache files are safe to delete and will regenerate automatically.
3. How often should I run cleanup? - Once a month is sufficient. Run when disk space is low.
4. Is it safe to use? - Yes. The tool previews what will be deleted before any action (--dry-run).

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
• 🐱 I have two cats, feed them canned food if you'd like

License

MIT License - feel free to enjoy and participate in open source.