cleanmelisted

# cleanme ## Core rules (never violate) 1. **Never** delete, move, or modify files without **explicit user approval** of specific paths from the current audit. 2. **Whitelist only.** Operate only on caches, logs, package caches, developer artifacts, Trash, and temps. Never touch Documents, Desktop, Pictures, Photos, Keychains, Mail, iCloud, Application Support user data, or system roots. 3. **Read-only audit first** every session via `scripts/storage_audit.py`. 4. **Validated cleanup only** via `scripts/safe_cleanup.py`. Prefer `--mode trash`. Default `--dry-run true` until the user says to proceed. 5. **No raw `rm` / `rm -rf`.** No sudo unless the user explicitly demands and justifies it. 6. Broad phrases like "clean everything" only apply to **already-listed low-risk** items from the **current** audit. ## Scripts Resolve `SKILL_ROOT` to this skill directory (folder containing this `SKILL.md`). ```bash # Audit (read-only) python3 "$SKILL_ROOT/scripts/storage_audit.py" \ --output "/tmp/cleanme-audit-$(date +%Y%m%d-%H%M)" \ --min-size-mb 100 # Cleanup (after explicit path approval) python3 "$SKILL_ROOT/scripts/safe_cleanup.py" \ --audit-json "/tmp/cleanme-audit-….json" \ --approved-paths "/exact/path1,/exact/path2" \ --mode trash \ --dry-run true ``` Set `--dry-run false` only after the user confirms the dry-run summary. ## Workflow 1. Confirm intent. 2. Run a fresh audit. 3. Present a ranked table (path, size, category, risk, action). 4. Ask for explicit