Free Up Space wizard

Free Up Space is a three-step recovery flow. Every step previews what will happen before a single byte moves.

Step 1 — Cache cleanup

Scans the well-known cache locations on macOS:

• Xcode DerivedData and ModuleCache
• Homebrew Cellar/Caches
• npm, pip, cargo, yarn caches
• Browser disk caches (Safari, Chrome, Firefox, Brave, Edge)
• Docker layer cache and Podman build cache

You see a checklist with size estimates. Uncheck anything you'd rather keep, then confirm. The deletion is staged so a crash mid-step doesn't half-delete a directory.

Step 2 — Oversize-file relocation

Finds files above your configured size floor (default 1 GB) in common workspaces. For each one you can:

• Move to NVMe (preserves filename and relative path)
• Relocate (move + symlink)
• Skip

Step 2 obeys your pair boundaries. It never touches files outside an active pair.

Step 3 — Cloud eviction (optional)

If you have iCloud Drive, Dropbox, Google Drive, or OneDrive installed, Step 3 can evict their dehydrated cached local copies back to "online only" state. You opt in per-provider in Preferences. The files remain in the cloud; only the local cached bytes are released.

Cancel any time

Each step's confirm button is the only thing that actually causes filesystem writes. You can cancel before that button without any side effects.