Mole

Dig deep like a mole to clean your Mac.

Stars Version License Commits Twitter Telegram

Mole - 95.50GB freed

## Features - All-in-one toolkit that roughly equals CleanMyMac + AppCleaner + DaisyDisk + Sensei + iStat in a single open-source binary. - `mo clean` digs through caches, temporary files, orphaned leftovers, and browser cruft to reclaim tens of gigabytes on first run. - `mo uninstall` wipes an app plus its launch agents, preference panes, caches, and registration files so nothing lingers in 20+ locations. - `mo optimize` refreshes services, rebuilds caches, trims swap, and checks login items for a one-tap performance tune-up. - `mo analyze` visualizes disk usage so you can drill down into folders and spot giant files that pair nicely with the cleanup flow. - `mo status` surfaces 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:** ```bash curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash ``` Or via Homebrew: ```bash brew install tw93/tap/mole ``` **Run:** ```bash 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-run` and reviewing the generated list. - Use `mo clean --whitelist` to manage protected caches. - Use `mo touchid` to approve sudo with Touch ID instead of typing your password. ## Features in Detail ### Deep System Cleanup ```bash $ 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 ```bash $ 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 ```bash $ 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 ```bash $ 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. ```bash $ 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: ```bash 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=` 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.