mole-mac-cleanup

Mac cleanup & optimization tool combining CleanMyMac, AppCleaner, DaisyDisk features. Deep cleaning, smart uninstaller, disk insights, and project artifact purge.

⭐3stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026

When & Why to Use This Skill

Mole is a comprehensive Mac cleanup and optimization skill for Claude, integrating the core functionalities of premium tools like CleanMyMac, AppCleaner, and DaisyDisk into a single agent-friendly interface. It empowers users to perform deep system maintenance, including cache removal, log cleaning, and smart application uninstallation. Specifically optimized for developers, it features specialized commands to purge heavy project artifacts like node_modules and build directories, ensuring peak system performance and efficient disk space management.

Use Cases

  • Automated System Maintenance: Efficiently clearing system caches, logs, and browser data to reclaim storage and improve macOS responsiveness.
  • Developer Workspace Cleanup: Reclaiming significant disk space by identifying and purging redundant project artifacts such as node_modules, target folders, and venv directories across multiple repositories.
  • Smart Application Uninstallation: Ensuring a clean system by removing applications along with all their hidden remnants and configuration files that standard deletion misses.
  • System Performance Optimization: Resolving minor OS issues by rebuilding system databases, resetting network services, and refreshing the Finder and Dock.
  • Storage Audit and Purge: Scanning for and removing forgotten large installer files (.dmg, .pkg) and managing large files to prevent disk saturation.
namemole-mac-cleanup
descriptionMac cleanup & optimization tool combining CleanMyMac, AppCleaner, DaisyDisk features. Deep cleaning, smart uninstaller, disk insights, and project artifact purge.
authorBenjamin Jesuiter <bjesuiter@gmail.com>
emoji"🧹"
os["darwin"]
bins["mo"]
- idbrew
kindbrew
formulamole
labelInstall Mole via Homebrew

Mole - Mac Cleanup & Optimization Tool

Repo: https://github.com/tw93/Mole Command: mo (not mole!) Install: brew install mole

Note for humans: mo without params opens an interactive TUI mode. Not useful for agents, but you might wanna try it manually! 😉

What It Does

All-in-one toolkit combining CleanMyMac, AppCleaner, DaisyDisk, and iStat Menus:

  • Deep cleaning — removes caches, logs, browser leftovers
  • Smart uninstaller — removes apps + hidden remnants
  • Disk insights — visualizes usage, manages large files
  • Live monitoring — real-time system stats
  • Project artifact purge — cleans node_modules, target, build, etc.

Non-Interactive Commands (Clawd-friendly)

Preview / Dry Run (ALWAYS USE FIRST)

mo clean --dry-run              # Preview cleanup plan
mo clean --dry-run --debug      # Detailed preview with risk levels & file info
mo optimize --dry-run           # Preview optimization actions
mo optimize --dry-run --debug   # Detailed optimization preview

Execute Cleanup

mo clean                        # Run deep cleanup (caches, logs, browser data, trash)
mo clean --debug                # Cleanup with detailed logs

System Optimization

mo optimize                     # Rebuild caches, reset services, refresh Finder/Dock
mo optimize --debug             # With detailed operation logs

What mo optimize does:

  • 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

Whitelist Management

mo clean --whitelist            # Manage protected cache paths
mo optimize --whitelist         # Manage protected optimization rules

Project Artifact Purge

mo purge                        # Clean old build artifacts (node_modules, target, venv, etc.)
mo purge --paths                # Configure which directories to scan

Config file: ~/.config/mole/purge_paths

Installer Cleanup

mo installer                    # Find/remove .dmg, .pkg, .zip installers

Scans: Downloads, Desktop, Homebrew caches, iCloud, Mail attachments

Setup & Maintenance

mo touchid                      # Configure Touch ID for sudo
mo completion                   # Set up shell tab completion
mo update                       # Update Mole itself
mo remove                       # Uninstall Mole from system
mo --version                    # Show installed version
mo --help                       # Show help

Typical Workflow

  1. Check what would be cleaned:

    mo clean --dry-run --debug
    
  2. If looks good, run cleanup:

    mo clean
    
  3. Optimize system (after cleanup):

    mo optimize --dry-run
    mo optimize
    
  4. Clean dev project artifacts:

    mo purge
    

What Gets Cleaned (mo clean)

  • User app cache
  • Browser cache (Chrome, Safari, Firefox)
  • Developer tools (Xcode, Node.js, npm)
  • System logs and temp files
  • App-specific cache (Spotify, Dropbox, Slack)
  • Trash

Notes

  • Terminal: Best with Ghostty, Alacritty, kitty, WezTerm. iTerm2 has issues.
  • Safety: Use --dry-run first. Built with strict protections.
  • Debug: Add --debug for detailed logs.