- All-in-one toolkit equal to CleanMyMac + AppCleaner + DaisyDisk + Sensei + iStat in one trusted binary
- Deep cleanup finds and removes caches, temp files, browser leftovers, and junk to free up tens of gigabytes
- Smart uninstall finds app bundles plus launch agents, settings, caches, logs, and leftover files
- Disk insight + optimization show large files, display folders, rebuild caches, clean swap, refresh services
- Live status shows CPU, GPU, memory, disk, network, battery, and proxy data so you can find problems
Install:
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 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, use Alacritty, kitty, WezTerm, Ghostty, or Warp instead
- Safety: Built with strict protections. See our Security Audit. Preview with
mo clean --dry-run - Whitelist: Use
mo clean --whitelistto manage protected caches - Touch ID: Run
mo touchidto approve sudo with Touch ID instead of password - Navigation: All menus support Vim keys
h/j/k/lin addition to arrow keys - Debug: Use
--debugflag to see detailed logs: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.
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 freed storage for you, consider starring the repo or sharing it with friends needing a cleaner Mac.
- Have ideas or fixes? Open an issue or PR and help shape Mole's future together with the community.
- Report bugs by running commands with
--debugflag and sharing the output:mo clean --debug - Love cats? Treat Tangyuan and Cola to canned food via this link and keep the mascots purring.
MIT License - feel free to enjoy and participate in open source.