Stars Version License Commits Twitter Telegram
- Unified toolkit: Consolidated features of CleanMyMac, AppCleaner, DaisyDisk, and iStat into a single binary
- Deep cleaning: Scans and removes caches, logs, and browser leftovers to reclaim gigabytes of space
- Smart uninstaller: Thoroughly removes apps along with launch agents, preferences, and hidden remnants
- Disk insights: Visualizes usage, manages large files, rebuilds caches, and refreshes system services
- Live monitoring: Real-time stats for CPU, GPU, memory, disk, and network to diagnose performance issues
Installation:
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bashOr via Homebrew:
brew install mole
Run:
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 the cleanup plan mo clean --whitelist # Manage protected caches mo optimize --dry-run # Preview optimization actions mo optimize --whitelist # Manage protected optimization rules mo purge --paths # Configure project scan directories
- 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 Quit
Real-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.
Clean old build artifacts (node_modules, target, build, dist, etc.) from your projects to free up disk space.
mo purge Select Categories to Clean - 18.5GB (8 selected) โค โใใใพใ my-react-app 3.2GB | node_modules โใใใพใ old-project 2.8GB | node_modules โใใใพใ rust-app 4.1GB | target โใใใพใ next-blog 1.9GB | node_modules โใใใพใ current-work 856MB | node_modules | Recent โใใใพใ django-api 2.3GB | venv โใใใพใ vue-dashboard 1.7GB | node_modules โใใใพใ backend-service 2.5GB | node_modules
Use with caution: This will permanently delete selected artifacts. Review carefully before confirming. Recent projects (< 7 days) are marked and unselected by default.
Custom Scan Paths
Run mo purge --paths to configure which directories to scan, or edit ~/.config/mole/purge_paths directly:
~/Documents/MyProjects ~/Work/ClientA ~/Work/ClientB
When custom paths are configured, only those directories are scanned. Otherwise, defaults to ~/Projects, ~/GitHub, ~/dev, etc.
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. Mole automatically detects your terminal, or you can set MO_LAUNCHER_APP=<name> to override. For Raycast, if this is your first script directory, add it in Raycast Extensions (Add Script Directory) and then run "Reload Script Directories" to load the new commands.
Users from around the world are loving Mole! Join the community and share your experience.
- 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.