mac-cleaner

# Mac Cleaner

Safely analyze and reclaim disk space on macOS. Designed for everyday Mac users — no technical knowledge required.

## When to use

- "My Mac says System Data is taking too much space"
- "How do I free up disk space?"
- "Why is my disk full?"
- "Clean up my Mac storage"
- "What's taking up space on my Mac?"

## What this skill covers

| Category | Safe to Clean | Notes |
|----------|---------------|-------|
| User Caches | ✅ Yes | App temporary files |
| iOS Simulators | ✅ Yes | Unused simulator devices |
| Xcode Derived Data | ✅ Yes | Build artifacts (rebuildable) |
| Browser Caches | ✅ Yes | Chrome, Safari, Firefox |
| System Logs | ✅ Old only | 7+ days old, requires sudo |
| Trash | ✅ Yes | Empty trash |
| iOS Backups | ⚠️ Review | Check if backups are needed |
| Parallels VMs | ⚠️ Review | Only if Windows not needed |
| Time Machine Snapshots | ⚠️ Review | Can delete old snapshots |

## NEVER delete

- `/System` folder contents
- `/Library/Extensions` or kernel extensions
- `/private/var/db` (system databases)
- Active iOS backups you need
- Parallels VMs you use

## Quick start

### Analyze (safe, read-only)

```bash
bash scripts/mac-cleanup.sh analyze
```

Shows disk usage and identifies large items without making changes.

### Clean (with confirmation)

```bash
bash scripts/mac-cleanup.sh clean
```

Performs safe cleanup after user confirmation.

## What gets cleaned

1. **User Caches** (`~/Library/Caches/*`)
   - App temporary files, thumbnails, downloaded content
   - Safe: apps rebuild these automatically

2. **Xcode Derived Data** (`~/Library/Developer/Xcode/DerivedData/*`)
   - Build artifacts and intermediate files
   - Safe: rebuilds on next compile

3. **iOS Simulators** (unavailable devices only)
   - Old iOS simulator images
   - Safe: easily re-downloaded via Xcode

4. **Browser Caches**
   - Chrome, Safari, Firefox cache files
   - Safe: websites reload, login sessions preserved

5. **Old System Logs** (7+ days)
   - Requires...