Mole

Dig deep like a mole to optimize your Mac.

Features

1. Mole bundles the power of CleanMyMac + AppCleaner + DaisyDisk + Sensei + iStat into one trusted open-source binary.
2. Fast terminal UI with arrow keys, pagination, and Touch ID approvals keeps every workflow lightweight and safe.
3. mo clean digs into caches, temp files, orphaned leftovers, and browser cruft to free tens of gigabytes.
4. mo uninstall removes apps plus launch agents, preference panes, and config debris spread across 20+ locations.
5. mo optimize rebuilds caches, trims swap, refreshes services, and tidies login items for instant stability.
6. mo analyze visualizes disk usage so you can drill into folders and pinpoint the giant files worth deleting.
7. mo status streams live disk, battery, network, process, and proxy stats to show your Mac’s real-time 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                # 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

$ 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.