mirror of
https://github.com/tw93/Mole.git
synced 2026-02-04 15:04:42 +00:00
8.3 KiB
8.3 KiB
Mole
Dig deep like a mole to optimize your Mac.
Features
- All-in-one toolkit equal to CleanMyMac + AppCleaner + DaisyDisk + Sensei + iStat in one trusted binary.
- Deep cleanup digs through caches, temp files, browser leftovers, and junk to reclaim tens of gigabytes quickly.
- Smart uninstall hunts down app bundles plus launch agents, preference panes, caches, logs, and debris.
- Disk insight + optimization reveal storage hogs, visualize folders, rebuild caches, trim swap, refresh services.
- Live status surfaces CPU, GPU, memory, disk, network, battery, and proxy telemetry so you always know health.
Quick Start
Install:
curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash
Or via Homebrew:
brew install tw93/tap/mole
Run:
mo # Interactive menu
mo clean # Deep cleanup
mo clean --dry-run # Preview cleanup plan
mo clean --whitelist # Adjust protected caches
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
Tips
- Safety first, if your Mac is mission-critical, wait for Mole to mature before full cleanups.
- Preview the cleanup by running
mo clean --dry-runand reviewing the generated list. - Use
mo clean --whitelistto manage protected caches. - Use
mo touchidto approve sudo with Touch ID instead of typing your password.
Features in Detail
Deep System Cleanup
$ 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
====================================================================
Smart App Uninstaller
$ mo 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
✓ Cleaned 52 related files across 12 locations
- Application Support, Caches, Preferences
- Logs, WebKit storage, Cookies
- Extensions, Plugins, Launch daemons
====================================================================
Space freed: 12.8GB
====================================================================
System Optimization
$ mo optimize
System: 5/32 GB RAM | 333/460 GB Disk (72%) | Uptime 6d
✓ Rebuild system databases and flush caches
✓ Reset network services
✓ Refresh Finder and Dock
✓ Clean diagnostic and crash logs
✓ Purge swap files and restart dynamic pager
✓ Rebuild launch services and spotlight index
====================================================================
System optimization completed
====================================================================
Disk Space Analyzer
$ 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 Reveal | ⌫ Delete | L Large(24) | Q Quit
Live System Status
Real-time dashboard with system health score, hardware info, and performance metrics.
$ mo status
Mole Status Health ● 92 MacBook Pro · Apple M4 Pro · 32.0 GB · 460.4 GB · macOS 14.5
⚙ CPU ────────────────────── ▦ Memory ─────────────────────
Total ████████████░░░░░░ 45.2% Used ███████████░░░░░░ 58.4%
0.82 / 1.05 / 1.23 (8 cores) 14.2 GB / 24.0 GB total
Core1 ███████████████░░░ 78.3% Free ████████░░░░░░░░░ 41.6%
Core2 ████████████░░░░░░ 62.1% 9.8 GB available
▤ Disk ────────────────────── ▮ Power ──────────────────────
Used █████████████░░░░░ 67.2% 100% ██████████████████ 100%
156.3 GB free Charged ⚡
Read ▮▯▯▯▯ 2.1 MB/s Normal · 423 cycles
Write ▮▮▮▯▯ 18.3 MB/s 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 is calculated from CPU usage, memory pressure, disk space, temperature, and I/O load. Color-coded: 90-100 green, 75-89 light green, 60-74 yellow, 40-59 orange, 0-39 red.
Quick Launchers
Launch Mole commands instantly from Raycast or Alfred:
curl -fsSL https://raw.githubusercontent.com/tw93/Mole/main/scripts/setup-quick-launchers.sh | bash
Adds 5 commands: clean, uninstall, optimize, analyze, status. Auto-detects your terminal or set MO_LAUNCHER_APP=<name> to override.
Reload Raycast by running Reload Script Directories, or simply restarting Raycast.
Support
- If Mole reclaimed 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 roadmap together with the community.
- Love cats? Treat Tangyuan and Cola to canned food via this link and keep the mascots purring.
License
MIT License - feel free to enjoy and participate in open source.