mole-mac-cleanup

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