How do I install the Mole Mac Cleanup skill?

Run npx skillmds@latest add bjesuiter/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. 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?

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

Mole Mac Cleanup by bjesuiter — Agent Skill

Name: Mole Mac Cleanup
Author: bjesuiter

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: Use when the user asks to clean, optimize, uninstall, inspect disk usage, or purge project artifacts on macOS.---# 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 DoesAll-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)```bashmo clean --dry-run # Preview cleanup planmo clean --dry-run --debug # Detailed preview with risk levels & file infomo optimize --dry-run # Preview optimization actionsmo optimize --dry-run --debug # Detailed optimization preview```### Execute Cleanup```bashmo clean # Run deep cleanup (caches, logs, browser data, trash)mo clean --debug # Cleanup with detailed logs```### System Optimization```bashmo optimize # Rebuild caches, reset services, refresh Finder/Dockmo 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```bashmo clean --whitelist # Manage protected cache pathsmo optimize --whitelist # Manage protected optimization rules```### Project Artifact Purge```bashmo 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```bashmo installer # Find/remove .dmg, .pkg, .zip installers```Scans: Downloads, Desktop, Homebrew caches, iCloud, Mail attachments### Setup & Maintenance```bashmo touchid # Configure Touch ID for sudomo completion # Set up shell tab completionmo update # Update Mole itselfmo remove # Uninstall Mole from systemmo --version # Show installed versionmo --help # Show help```---## Typical Workflow1. **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