---

🛡️ Safety and Architecture

---

📸 Screenshots

View high-resolution screenshots

---

🚀 Quick Download & Install

1. Direct Download: Grab the latest .dmg from GitHub Releases.
2. Mount & Drag: Open the .dmg and drag MacOSCleaner.app into /Applications.
3. First Launch (Gatekeeper): If macOS shows a Gatekeeper warning on locally built/unnotarized apps:

   sudo xattr -r -c /Applications/MacOSCleaner.app
   

   Note: This removes the quarantine attribute set by macOS. It does not modify app files, system security, or grant persistent permissions.

---

✨ Features

• Smart Cleanup: scans 55+ categories across system caches, 275+ applications, 85+ developer toolchains & package managers (Xcode, Docker, uv, mise, Rust, Go, Python, Node), local AI models & coding assistants (Claude Code, Ollama, MLX, Hugging Face, WhisperKit), and safe Time Machine snapshot thinning (thinlocalsnapshots).
• Forensic Uninstaller: inspects 30 evidence types (Bundle ID, Team ID, Spotlight metadata, Launch Services) to trace remnants across 1,800+ known application paths and heuristics, with standalone orphaned residuals discovery, confidence score tiers, post-uninstall review sheets, and root-level helper removal.
• Duplicate Finder: identifies duplicate files through a 3-stage pipeline (file size matching, 4 KB header checksum, full SHA-256 verification).
• Disk Space Analyzer: hierarchical folder drill-down with breadcrumb navigation, honest APFS allocated block sizing (totalFileAllocatedSize), Quick Look previews (Space), recursive category filters (Videos, Audio, Photos, Documents, Archives), and dataless iCloud item skip protection.
• Process and Service Manager: monitors live CPU and RAM usage with termination safeguards for critical processes (kernel_task, launchd), plus LaunchAgents and LaunchDaemons toggling.
• Native System Integrations: on-device FoundationModels explanations for unknown caches, Siri and App Intents automation, Liquid Glass materials with keyboard navigation (⌘,, ⌘C, ⌘F, ⌘R, ⌘⌫), and 10 language localizations.

Complete feature breakdowns and path specifications are documented in the MacOSCleaner Wiki.

---

🛠️ Build from Source

Prerequisites: macOS 26.0+, Xcode 18+, XcodeGen.

git clone https://github.com/AlexTkDev/MacOSCleaner.git
cd MacOSCleaner/MacOSCleaner
xcodegen
open MacOSCleaner.xcodeproj

Build and run with ⌘R, or run tests with ⌘U.

Note: Public source builds use the public fallback cleanup catalog.

---

⭐️ Support & Community

If you find MacOS Cleaner useful, please consider giving it a ⭐️ on GitHub. It helps more users discover the project and directly supports ongoing development.

• — Star the repository and watch releases for update notifications.
• — Ask questions, propose features, and share feedback.
• — Report bugs or suggest rule improvements.
• — Architecture overview and developer guides.
• — Explore repository online and open in Cursor.

Note: Contributions are subject to the project's Contributor License Agreement (CLA).

---

👨‍💻 Author

Citation reference: CITATION.cff

---

📄 License

Dual-licensed:

• GNU GPLv3 + Commons Clause v1.0 for personal, non-commercial use, testing, and open-source contributions. Commercial resale and commercial re-licensing are prohibited.
• Commercial License for enterprise, commercial, or proprietary distribution. Contact the author for licensing inquiries.

Trademark Notice: The license does not grant permission to use the project name ("MacOSCleaner"), logos, or branding in derivative works.