Skip to content

Cleanup Categories

Oleksandr Tk edited this page Aug 2, 2026 · 2 revisions

Cleanup categories group files of the same kind. Every category is scanned in parallel; scan results are grouped by category and shown with a risk badge.

Default Categories

Category Description
App Caches Per-app regenerable caches
System Caches System-level temporary data
User Logs Logs under ~/Library/Logs
System Logs Logs under /Library/Logs and /var/log
Browser Caches Safari, Chrome, Firefox, Edge caches
Developer Caches Xcode DerivedData, iOS DeviceSupport, simulators
Trash Recoverable trash contents
Xcode Derived Data Build artifacts
iOS Device Support iOS symbol data
Swift Playgrounds Playground caches
Simulator Data iOS simulator runtime data
Photos Trash Recently deleted photos
Mail Downloads Mail attachments
Font Cache Font rendering caches
DNS Cache System DNS cache
Docker Docker images, containers, volumes, build cache
Homebrew Cleanup logs, downloads cache
.DS_Store Desktop metadata files
Maven ~/.m2 repository
Go Module cache and build cache
Rust Cargo registry and target dirs
Flutter/Dart .dart_tool, build artifacts
NPM/Node npm cache, node_modules
Pip pip cache
Android Gradle and Android caches
Xamarin Xamarin build data
iCloud Documents Desktop & Documents sync cache
Voice Memos Voice Memo recordings
GarageBand/Logic Audio plugin caches and patches
iMovie/Final Cut Video library caches
Sleep Image Hibernation file
Time Machine Snapshots Local snapshots

Personal & Opt-In Categories

These categories hold personal content and are never selected automatically:

  • Orphaned Remnants — leftover files from deleted apps
  • Old Backups — backup copies of the user's own files
  • AI/LLM Model Stores — downloaded model weights for Ollama, Hugging Face, LM Studio, Jan, mlx, torch, whisper, vLLM, stable-diffusion and similar tools
  • Installer Packages.pkg/.dmg files downloaded by the user
  • Messages Attachments — attachments stored in Messages

The user must explicitly select these categories (and confirm) for them to be included in cleanup.

Path Purposes

Every registered path is classified into a purpose that determines how the app may treat it:

Purpose Meaning
cache Regenerable, cleaned by default
app_data Uninstall-only, never touched by cleanup
shared Shared with other apps, never automatic
user_content Personal content, opt-in only

The registry database (1,770 paths, 251 apps, 66 toolchains) is described in Architecture.

Clone this wiki locally