spring-cleaning

Spring Cleaning — Mac Disk Space Cleanup

A skill for generating a safe, prioritized, step-by-step runbook to free up local disk space on a Mac. Before recommending offloading or deletion, confirm the user's backup, cloud-sync, and external-storage setup. Useful optional tools include DaisyDisk, ncdu, dust, fdupes, and brew.

---

Step 1 — Get a Storage Snapshot

Before generating the runbook, the agent needs a storage report. Accept any of the following (in order of detail/usefulness):

Report Type	How to Get It	Detail Level
dust output	dust -d 4 /Users/<name> 2>/dev/null	✅ Good
DaisyDisk screenshot	Scan Macintosh HD, share screenshot	✅ Good
ncdu filtered output	See command below	✅✅ Best
System Settings > Storage screenshot	Built-in macOS storage view	⚠️ Low (ask for more)

ncdu filtered command (recommend this if user hasn't run anything yet):

ncdu / -o /tmp/ncdu_out.json 2>/dev/null && python3 << 'EOF'
import json
with open('/tmp/ncdu_out.json') as f:
    data = json.load(f)
def walk(node, path='', threshold=200*1024*1024):
    if isinstance(node, list):
        info = node[0]
        name = info.get('name', '')
        full = f"{path}/{name}".replace('//', '/')
        size = info.get('asize', 0)
        if size > threshold:
            print(f"{size // 1024 // 1024}MB\t{full}")
        for child in node[1:]:
            walk(child, full, threshold)
    elif isinstance(node, dict):
        name = node.get('name', '')
        full = f"{path}/{name}".replace('//', '/')
        size = node.get('asize', 0)
        if size > threshold:
            print(f"{size // 1024 // 1024}MB\t{full}")
root = data[2]
walk(root, threshold=200*1024*1024)
EOF

If the user only provides a high-level screenshot (e.g. macOS Storage view showing category totals), ask for a DaisyDisk scan or dust output before generating the runbook — the category-level view isn't granular enough to write safe, targeted commands.