Mole

Deep clean and optimize your Mac.

Mole - 95.50GB freed

## Features - **All-in-one toolkit** combining the power of CleanMyMac, AppCleaner, DaisyDisk, Sensei, and iStat in one **trusted binary** - **Deep cleanup** scans and removes caches, logs, browser leftovers, and junk to **reclaim tens of gigabytes** - **Smart uninstall** completely removes apps including launch agents, preferences, caches, and **hidden leftovers** - **Disk insight + optimization** visualizes usage, handles large files, **rebuilds caches**, cleans swap, and refreshes services - **Live status** monitors CPU, GPU, memory, disk, network, battery, and proxy stats to **diagnose issues** ## Quick Start **Installation:** ```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 # 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 cleanup plan mo clean --whitelist # Adjust protected caches mo uninstall --force-rescan # Rescan apps and refresh cache mo optimize --whitelist # Adjust protected optimization items ``` ## Tips - **Terminal**: iTerm2 has known compatibility issues; we recommend Alacritty, kitty, WezTerm, Ghostty, or Warp. - **Safety**: Built with strict protections. See our [Security Audit](SECURITY_AUDIT.md). 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 `--debug` flag (e.g., `mo clean --debug`). ## 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 (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 ==================================================================== ``` ### System Optimization ```bash $ 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. ``` ### 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 Show | ⌫ 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 · 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. ### Project Artifact Purge Remove build artifacts from old projects to reclaim disk space. Fast parallel scanning targets `node_modules`, `target`, `build`, `dist`, `.next`, `.gradle`, `venv`, and similar directories. ```bash mo purge --dry-run # Preview cleanup (recommended) mo purge # Clean old project artifacts ``` **Safety:** Only scans common project directories, skips recently modified projects (7 days), and requires artifacts at least 2 levels deep to avoid system files. **Performance:** Uses macOS Spotlight index (mdfind) for lightning-fast scanning, with parallel search across multiple directories. ## 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`. Finds your terminal automatically or set `MO_LAUNCHER_APP=` to override. For Raycast, search "Reload Script Directories" to load new commands. ## Support

- 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. ## License MIT License - feel free to enjoy and participate in open source.