How do I install the Mole Mac Cleanup skill?

Run npx skillmds@latest add modbender/mole-mac-cleanup in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Mole Mac Cleanup safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Mole Mac Cleanup?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Mole Mac Cleanup free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Mole Mac Cleanup?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Mole Mac Cleanup by modbender — Agent Skill

Name: Mole Mac Cleanup
Rating: 4.666666666666667 (3 reviews)
Author: modbender

File contents

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

Check what would be cleaned:
```
mo clean --dry-run --debug
```
If looks good, run cleanup:
```
mo clean
```
Optimize system (after cleanup):
```
mo optimize --dry-run
mo optimize
```
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.

---name: mole-mac-cleanupdescription: Mac cleanup & optimization tool combining CleanMyMac, AppCleaner, DaisyDisk features. Deep cleaning, smart uninstaller, disk insights, and project artifact purge.--- # 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) ```bash 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 ```bash mo clean # Run deep cleanup (caches, logs, browser data, trash) mo clean --debug # Cleanup with detailed logs ``` ### System Optimization ```bash 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 ```bash mo clean --whitelist # Manage protected cache paths mo optimize --whitelist # Manage protected optimization rules ``` ### Project Artifact Purge ```bash 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 ```bash mo installer # Find/remove .dmg, .pkg, .zip installers ``` Scans: Downloads, Desktop, Homebrew caches, iCloud, Mail attachments ### Setup & Maintenance ```bash 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:** ```bash mo clean --dry-run --debug ``` 2. **If looks good, run cleanup:** ```bash mo clean ``` 3. **Optimize system (after cleanup):** ```bash mo optimize --dry-run mo optimize ``` 4. **Clean dev project artifacts:** ```bash 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.

Frequently asked questions

Mole Mac Cleanup