free-my-disklisted

# Free My Disk ## Core Rule Prefer a read-only audit before deleting anything. Classify findings into safety tiers, explain likely impact, and only delete after the user clearly asks to clean. Never delete personal documents, project archives, photos, mail, source repositories, Docker volumes, databases, app containers, or production data unless the user explicitly names them. ## Quick Audit Detect the platform first: ```bash uname -a df -h / ``` For macOS, run the bundled read-only script first when possible: ```bash bash scripts/audit_macos_disk.sh ``` Use `PROJECT_SCAN=1 bash scripts/audit_macos_disk.sh` to include common project roots such as `~/Workshop` and `~/qb`. Use `FULL_SCAN=1 bash scripts/audit_macos_disk.sh` only when the user wants a deeper scan and the disk has enough free space for a slower traversal. For Ubuntu/Linux, run the bundled read-only script first when possible: ```bash bash scripts/audit_linux_disk.sh ``` Use `PROJECT_SCAN=1 bash scripts/audit_linux_disk.sh` to include common user and project roots such as `~/workshop`, `~/Workshop`, `~/projects`, and `/opt`. Use `FULL_SCAN=1 bash scripts/audit_linux_disk.sh` only when the user wants a deeper scan. For a remote host, replace `my-server` with the actual hostname or SSH config alias, then copy or stream the script over SSH: ```bash ssh my-server 'bash -s' < scripts/audit_linux_disk.sh ssh my-server 'PROJECT_SCAN=1 bash -s' < scripts/audit_linux_disk.sh ``` If the script is not suitable,