- All-in-one toolkit combining the power of CleanMyMac, AppCleaner, DaisyDisk, Sensei, and iStat in one trusted binary
- Deep cleanup scans and removes caches, logs, browser leftovers, and junk to reclaim tens of gigabytes
- Smart uninstall completely removes apps including launch agents, preferences, caches, and hidden leftovers
- Disk insight + optimization visualizes usage, handles large files, rebuilds caches, cleans swap, and refreshes services
- Live status monitors CPU, GPU, memory, disk, network, battery, and proxy stats to diagnose issues
Installation:
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bashOr via Homebrew:
brew install tw93/tap/moleRun:
mo # Interactive menu
mo clean # Deep cleanup
mo uninstall # Remove apps + leftovers
mo optimize # Refresh caches & services
mo analyze # Visual disk explorer
mo status # Live system health dashboard
mo purge # Clean project build artifacts
mo touchid # Configure Touch ID for sudo
mo update # Update Mole
mo remove # Remove Mole from system
mo --help # Show help
mo --version # Show installed version
mo clean --dry-run # Preview cleanup plan
mo clean --whitelist # Adjust protected caches
mo uninstall --force-rescan # Rescan apps and refresh cache
mo optimize --whitelist # Adjust protected optimization items
- Terminal: iTerm2 has known compatibility issues; we recommend Alacritty, kitty, WezTerm, Ghostty, or Warp.
- Safety: Built with strict protections. See our Security Audit. Preview changes with
mo clean --dry-run. - Whitelist: Manage protected paths with
mo clean --whitelist. - Touch ID: Enable Touch ID for sudo commands by running
mo touchid. - Navigation: Supports standard arrow keys and Vim bindings (
h/j/k/l). - Debug: View detailed logs by appending the
--debugflag (e.g.,mo clean --debug).
$ mo clean
Scanning cache directories...
✓ User app cache 45.2GB
✓ Browser cache (Chrome, Safari, Firefox) 10.5GB
✓ Developer tools (Xcode, Node.js, npm) 23.3GB
✓ System logs and temp files 3.8GB
✓ App-specific cache (Spotify, Dropbox, Slack) 8.4GB
✓ Trash 12.3GB
====================================================================
Space freed: 95.5GB | Free space now: 223.5GB
====================================================================$ mo uninstall
Select Apps to Remove
═══════════════════════════
▶ ☑ Adobe Creative Cloud (9.4G) | Old
☐ WeChat (2.1G) | Recent
☐ Final Cut Pro (3.8G) | Recent
Uninstalling: Adobe Creative Cloud
✓ Removed application
✓ Cleaned 52 related files across 12 locations
- Application Support, Caches, Preferences
- Logs, WebKit storage, Cookies
- Extensions, Plugins, Launch daemons
====================================================================
Space freed: 12.8GB
====================================================================$ mo optimize
System: 5/32 GB RAM | 333/460 GB Disk (72%) | Uptime 6d
✓ Rebuild system databases and clear caches
✓ Reset network services
✓ Refresh Finder and Dock
✓ Clean diagnostic and crash logs
✓ Remove swap files and restart dynamic pager
✓ Rebuild launch services and spotlight index
====================================================================
System optimization completed
====================================================================
Use `mo optimize --whitelist` to protect specific optimization items from being run.$ mo analyze
Analyze Disk ~/Documents | Total: 156.8GB
▶ 1. ███████████████████ 48.2% | 📁 Library 75.4GB >6mo
2. ██████████░░░░░░░░░ 22.1% | 📁 Downloads 34.6GB
3. ████░░░░░░░░░░░░░░░ 14.3% | 📁 Movies 22.4GB
4. ███░░░░░░░░░░░░░░░░ 10.8% | 📁 Documents 16.9GB
5. ██░░░░░░░░░░░░░░░░░ 5.2% | 📄 backup_2023.zip 8.2GB
↑↓←→ Navigate | O Open | F Show | ⌫ Delete | L Large(24) | Q QuitReal-time dashboard with system health score, hardware info, and performance metrics.
$ mo status
Mole Status Health ● 92 MacBook Pro · M4 Pro · 32GB · macOS 14.5
⚙ CPU ▦ Memory
Total ████████████░░░░░░░ 45.2% Used ███████████░░░░░░░ 58.4%
Load 0.82 / 1.05 / 1.23 (8 cores) Total 14.2 / 24.0 GB
Core 1 ███████████████░░░░ 78.3% Free ████████░░░░░░░░░░ 41.6%
Core 2 ████████████░░░░░░░ 62.1% Avail 9.8 GB
▤ Disk ⚡ Power
Used █████████████░░░░░░ 67.2% Level ██████████████████ 100%
Free 156.3 GB Status Charged
Read ▮▯▯▯▯ 2.1 MB/s Health Normal · 423 cycles
Write ▮▮▮▯▯ 18.3 MB/s Temp 58°C · 1200 RPM
⇅ Network ▶ Processes
Down ▮▮▯▯▯ 3.2 MB/s Code ▮▮▮▮▯ 42.1%
Up ▮▯▯▯▯ 0.8 MB/s Chrome ▮▮▮▯▯ 28.3%
Proxy HTTP · 192.168.1.100 Terminal ▮▯▯▯▯ 12.5%Health score based on CPU, memory, disk, temperature, and I/O load. Color-coded by range.
Remove build artifacts from old projects to reclaim disk space. Fast parallel scanning targets node_modules, target, build, dist, .next, .gradle, venv, and similar directories.
mo purge --dry-run # Preview cleanup (recommended)
mo purge # Clean old project artifactsSafety: Only scans common project directories, skips recently modified projects (7 days), and requires artifacts at least 2 levels deep to avoid system files.
Performance: Uses macOS Spotlight index (mdfind) for lightning-fast scanning, with parallel search across multiple directories.
Launch Mole commands instantly from Raycast or Alfred:
curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh | bashAdds 5 commands: clean, uninstall, optimize, analyze, status. Finds your terminal automatically or set MO_LAUNCHER_APP=<name> to override. For Raycast, search "Reload Script Directories" to load new commands.
-
If Mole saved you space, consider starring the repo or sharing it with friends who need a cleaner Mac.
-
Have ideas or fixes? Open an issue or PR to help shape Mole's future with the community.
-
Love cats? Treat Tangyuan and Cola to canned food via this link to keep our mascots purring.
MIT License - feel free to enjoy and participate in open source.