Free, native, privacy-first cleaner and application uninstaller for macOS.
Built with Swift 6 and SwiftUI. Review everything before cleaning. Uninstalls and duplicates go to Trash.
Requirements: macOS 26.0 or later. Apple Silicon only (Intel Macs are not supported).
✨ Features • 🎬 Demo • 🛠️ Build from Source • 📖 Documentation
| Principle | Technical Implementation |
|---|---|
| No Telemetry | No background daemons, analytics SDKs, or remote loggers. All scanning runs locally without network access. |
| Safe Deletion | Cleanup, App Uninstaller, Disk Space Analyzer, Duplicate Finder, and Startup Services move files to macOS Trash via trashItem(at:) by default for recoverable deletion. Permanent removal (removeItem(at:)) is strictly opt-in. |
| Protected Paths | Hardcoded blocklists protect SIP paths, /System, /Library, /usr, ~/.ssh, user documents, credential files (.env, .npmrc, .yarnrc, .pypirc), IDE settings (.vscode, .idea, .zed), and Finder sidebar favorites (FavoriteItems.sfl3 / .sfl4). |
| Non-Destructive Scanning | Scanning never terminates running applications or modifies files. Cleanup and uninstallation enforce a 3-second soft quit timeout before forced termination. |
| Open Core | Swift 6 codebase with strict concurrency, actors, and structured task groups. Core engine and heuristics are inspectable. |
| On-Device AI | Checksums, hashes, and FoundationModels file explanations execute strictly on-device without cloud relays (no Private Cloud Compute or third-party APIs). |
| Native Runtime | Built in Swift 6 and SwiftUI with Liquid Glass materials. No Electron or WebKit container overhead. |
View high-resolution screenshots
- Direct Download: Grab the latest
.dmgfrom GitHub Releases. - Mount & Drag: Open the
.dmgand dragMacOSCleaner.appinto/Applications. - If macOS says it can't verify MacOSCleaner: On macOS 26, Gatekeeper can block the first open (“Apple could not verify “MacOSCleaner” is free of malware”, or a dialog that it cannot verify the app is free of malware) because the app is ad-hoc signed. Only do this with the DMG from the official GitHub Releases page.
-
Move
MacOSCleaner.appto/Applications(step 2). -
Try to open it once. Then go to System Settings → Privacy & Security, scroll down, click Open Anyway, and confirm.
-
Or, in Terminal:
xattr -dr com.apple.quarantine /Applications/MacOSCleaner.app
This clears the quarantine flag macOS sets on that download. It does not change the app or system security.
-
- Smart Cleanup: scans 55+ categories across system caches, user logs, browser data, 305 applications, and 105 developer toolchains (Xcode, Docker,
uv,mise, Rust, Gomodcache, Python, Node, CocoaPods), aged project-local build artifacts (verified by sibling project markers), forgotten installer images (.dmg,.pkg,.iso, and.zipcentral-directory inspection without mounting), local AI models (Claude Code, Ollama, MLX, Hugging Face, WhisperKit), and safe Time Machine snapshot thinning (thinlocalsnapshots). Includes review-only categories deselected by default, guarded Font Cache reset with confirmation, APFS reclaimable space delta, adaptive debug log panel, and a dedicated History window (⌘Y). - Forensic Uninstaller: inspects 30 evidence types (Bundle ID, Team ID, Spotlight metadata, Launch Services) across 2,427 cataloged remnant paths. Features a 3-stage uninstallation pipeline (soft quit →
launchdhelper bootout → file trashing), automatic Dock icon cleanup (com.apple.dock) with multi-version protection, inline TCC privacy permission chips on app cards, word-boundary matching to prevent false positives, Intel-only app badges (executableArchitectures), and standalone orphaned residuals cleanup with privilege escalation fallback. - Duplicate Finder: Master-Detail split interface (
HSplitView) with side-by-side group and file inspection. 3-stage detection pipeline (file size matching, 4 KB header checksum, full SHA-256 verification), native Quick Look previews (Space), high-resolution photo previews, middle-truncation path formatting, and Smart Selection actions (Select All Duplicates,Deselect All). - Disk Space Analyzer: hierarchical folder drill-down with breadcrumb navigation, honest APFS allocated block sizing (
totalFileAllocatedSizeKey), symlink skipping and hardlink inode deduplication, Quick Look previews (Space), recursive category filters (Videos, Audio, Photos, Apps, Documents, Archives — excluding.framework/.dSYM/document bundles from Apps), and dataless iCloud item skip protection. - Process and Service Manager: monitors live CPU and RAM usage with termination safeguards for critical system processes (
kernel_task,launchd), chunked lazy loading (LazyVStack), and configurable refresh/sort settings. Startup Services manager categorizes LaunchAgents, LaunchDaemons, and BTM Login Items (sfltool dumpbtm), verifiesSecStaticCodesignatures and notarization (Needs Attentionfilter), supports disabling/enabling user agents and background monitors (launchctl disable/bootout+ process termination), and offers direct "Show in Finder" and safe service removal. - Privacy Inspector: inspects user and system TCC permissions (read-only SQLite URI
?mode=ro&immutable=1) with verified user-permission reset viatccutil reset, captures on-demand active socket snapshots vialibproc(proc_pidfdinfo) for current-UID processes alongside staticInfo.plistnetwork indicators, and lists Safari, Chrome, Edge, Brave, Arc, and Firefox extensions with localized name resolution, permission risk classification, and direct extension-page navigation (via Automation script for Chromium browsers, with clipboard fallback). - Native System Integrations & Apple Intelligence: on-device
FoundationModelsstructured classification (@Generableverdicts: safe, caution, danger) with streaming explanations, Apple Intelligence storage overview in Settings, Siri and App Intents automation (CleanCategoryIntent,CleanDeveloperCachesIntent,EmptyTrashIntent,RunScheduledCleanupIntent) with.requiresAuthentication, compact48ptLiquid Glass navigation rail (GlassEffectContainer,glassEffectUnion), full keyboard shortcuts (⌘1–⌘9,⌘Y,⌘,,⌘C,⌘F,⌘R,⌘⌫), and 14 language localizations (English, Russian, Ukrainian, German, French, Spanish, Italian, Japanese, Simplified & Traditional Chinese, Korean, Polish, Brazilian Portuguese, and Arabic with native RTL layout).
Complete feature breakdowns and path specifications are documented in the MacOSCleaner Wiki.
Prerequisites: macOS 26.0+, Xcode 26+, XcodeGen.
git clone https://github.com/AlexTkDev/MacOSCleaner.git
cd MacOSCleaner/MacOSCleaner
xcodegen
open MacOSCleaner.xcodeprojBuild and run with ⌘R, or run tests with ⌘U.
Compare the downloaded .dmg checksum against the SHA-256 value published on GitHub Releases:
shasum -a 256 MacOSCleaner-*.dmg
codesign -dv --verbose=4 /Applications/MacOSCleaner.app- Not an Antivirus: Startup Services checks inspect code signatures, binary presence, and launch paths — they do not use malware signatures and cannot guarantee software is safe.
- TCC Permissions: Without Full Disk Access, user
TCC.dbshows "no data"; systemTCC.dbis protected by SIP and read-only. Resetting a permission viatccutil resetclears the decision so the app prompts again on next use (it does not permanently block future prompts). - Network Snapshot (
EPERM): Non-root inspection viaproc_pidfdinfoonly sees sockets of processes owned by the current user (UID). System/root daemons are explicitly marked as restricted (EPERM). - Browser Extensions: Read-only inspection only. Clicking an extension opens the corresponding browser's management page (Chromium browsers use an Automation script to open the specific extension tab and fall back to copying the URL if Automation permission is denied) so you can disable or remove it using the browser's built-in controls.
- On-Demand Only: No background daemon, continuous network monitor, or packet capture runs in the background.
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).
|
Aleksandr (AlexTkDev) |
Citation reference:
CITATION.cff
Dual-licensed:
- GNU GPLv3 + Commons Clause v1.0 for personal, non-commercial use, testing, and source-available 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.




