How jpferreria/cleanup-mac works
The repository provides two macOS cleanup experiences: a native SwiftUI app and a Python command-line utility. Both let users inspect categorized reclaimable storage and remove selected data; the app also offers Apple Intelligence advice and a Siri/Shortcuts health check. The CLI’s scan and clean flows are visible in its source. Swift excerpts show UI actions, cleanup behavior, model evaluation, and the intent, but omit parts of the scan orchestration, so those internal links are not inferred.
Main entry points: CleanupApp.swift Cleanup view model · cleanup.py CLI commands
Components 15
Native macOS app
- Cleanup interface
CleanupApp.swift - Cleanup view model
CleanupApp.swift - Cleanup categories
CleanupApp.swift - Selected cleanup
CleanupApp.swift - Storage health intent
CleanupApp.swift
Python CLI
- CLI commands
cleanup.py - CLI categories
cleanup.py - Size scanner
cleanup.py - Category deletion
cleanup.py
Storage advice
- On-device assessment
CleanupApp.swift - Fallback advisor
CleanupApp.swift
Other components
- Mac user
- Siri / Shortcuts
- CLI user
- macOS filesystem
Connections 15
- Mac user → Cleanup interface: uses
README.md - Cleanup interface → Cleanup view model: requests scan
CleanupApp.swift - Cleanup interface → Cleanup view model: requests cleanup
CleanupApp.swift - Cleanup view model → Selected cleanup: cleans selected
CleanupApp.swift - Siri / Shortcuts → Storage health intent: checks health
README.md - Storage health intent → On-device assessment: requests assessment
CleanupApp.swift - Cleanup view model → On-device assessment: evaluates storage
CleanupApp.swift - Cleanup view model → Fallback advisor: falls back
CleanupApp.swift - CLI user → CLI commands: runs command
README.md - CLI commands → Size scanner: runs scan
cleanup.py - CLI commands → Category deletion: runs clean
cleanup.py - Size scanner → CLI categories: reads paths
cleanup.py - Size scanner → macOS filesystem: measures files
cleanup.py - Category deletion → CLI categories: reads paths
cleanup.py - Category deletion → macOS filesystem: deletes contents
cleanup.py