mirror of
https://github.com/tw93/Mole.git
synced 2026-02-04 13:16:47 +00:00
8.6 KiB
8.6 KiB
Mole
Dig deep like a mole to clean your Mac.
Features
- All-in-one toolkit that roughly equals CleanMyMac + AppCleaner + DaisyDisk + Sensei + iStat in a single open-source binary.
mo cleandigs through caches, temporary files, orphaned leftovers, and browser cruft to reclaim tens of gigabytes on first run.mo uninstallwipes an app plus its launch agents, preference panes, caches, and registration files so nothing lingers in 20+ locations.mo optimizerefreshes services, rebuilds caches, trims swap, and checks login items for a one-tap performance tune-up.mo analyzevisualizes disk usage so you can drill down into folders and spot giant files that pair nicely with the cleanup flow.mo statussurfaces live disk, battery, network, process, and proxy data so you know how healthy your Mac is before and after maintenance.- Fast & Lightweight - Terminal-based with arrow-key navigation, pagination, and Touch ID support.
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 # System cleanup
mo clean --dry-run # Preview mode
mo clean --whitelist # Manage protected caches
mo uninstall # Uninstall apps
mo optimize # System optimization
mo analyze # Disk analyzer
mo status # Live system status 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.