Repository navigation
FAQ
Scans the system for caches, logs, and other removable content, lets you review everything before deleting, and provides an uninstaller, duplicate file finder, disk space analyzer, privacy inspector, process manager, and startup services manager.
Everything is reviewed manually. Cleanup, App Uninstaller, Disk Space Analyzer, Duplicate Finder, and Startup Services move files to macOS Trash (trashItem(at:)) by default for recoverable deletion; permanent removal is strictly opt-in. Critical system paths are blocked, and risky categories are pre-unselected. See Privacy and Safety.
Yes. Full Disk Access is required to scan system cache directories and read the user TCC database in Privacy Inspector. The app requests it on first launch. Without it, scanning is limited to user-accessible paths, and guidance is shown if access is later revoked.
No telemetry. The only network access is the update check against GitHub Releases. Apple Intelligence explanations run on-device. See Privacy and Safety.
macOS 26.0 or later, Apple Silicon only.
The app relies on Swift 6 concurrency features and, for AI explanations, the FoundationModels framework, which requires macOS 26.0. Older macOS versions are not supported.
No. AI explanations are optional and can be disabled in Settings. All other features work without it.
Yes. See Siri & Automation for commands, and enable or disable each command in Settings → Automation.
Yes, by default. Items removed by Cleanup, App Uninstaller, Disk Space Analyzer, Duplicate Finder, and Startup Services are moved to macOS Trash and can be restored from there. If "Bypass Trash on Uninstall" or "Empty Trash During Cleanup" is enabled in Settings → Cleanup, files are permanently deleted and cannot be restored.
- Safe — temporary data
- Moderate — may affect app startup speed
- Dangerous — may reset preferences or require re-login
- Protected — system-protected, cannot be deleted
By default the "Keep Oldest" strategy keeps the file with the oldest modification date. You can switch to Keep Newest, select all, or override the selection per file. Only files with identical SHA-256 hashes are considered duplicates.
When an app is deleted, it often leaves behind preferences, caches, and support files. The orphan scanner finds these remnants, scores them by evidence (bundle ID, plist, containers, file patterns), and assigns a confidence tier. Only items scoring "Very Likely" are shown in results.
Build output directories (e.g., Xcode DerivedData project folders, Swift Package Manager .build, CocoaPods Pods/) that accumulate over time. The cleanup category is opt-in and age-based: artifacts older than a configurable threshold (default 60 days) are eligible for removal. Configure the age in Settings → Cleanup.
The Settings → General panel detects whether Touch ID for sudo is available and enabled, and provides the command to set it up. You run it in Terminal yourself — macOS 26 SIP blocks apps from writing /private/etc/pam.d/sudo_local directly, even as root.
System services (owned by macOS) are protected. Third-party services can be loaded or unloaded after confirmation.
Whitelisted processes can never be terminated. Blacklisted processes are marked for quick termination, optionally with auto-kill.
Model weights downloaded by tools like Ollama or LM Studio are your personal data. The category is opt-in: it must be explicitly selected, and individual files confirmed, before anything is removed.
From a bundled catalog (2,427 path definitions for 305 apps and 105 toolchains) plus live filesystem evidence. See Architecture.
Non-root inspection via proc_pidfdinfo only sees sockets of processes owned by your current user (UID). System and root daemons are marked restricted (EPERM).
No. Browser extension inspection is read-only. Clicking an extension opens the browser's extension management page so you can disable or remove it there.
No. Some apps have known difficult-to-remove components. The uninstaller shows a difficulty rating (Critical/High/Medium/Low) per app so you can decide whether manual review is needed.
The UI is localized into 14 languages: English, Русский, Українська, Deutsch, Français, Español, Italiano, 日本語, 简体中文, 繁體中文, 한국어, Polski, Português (Brasil), العربية. Pull requests adding or fixing translations are welcome. See Contributing.
Every cleanup is recorded. Recent operations are shown on the Dashboard; press ⌘Y to open the full cleanup history with search and sorting.
Open an issue at github.com/AlexTkDev/MacOSCleaner/issues.
No. The app is open source under the GPL-3.0 + Commons Clause license. See the LICENSE.
Home · GitHub · Issues · Releases · Discussions
MacOSCleaner
Tools
System
Reference
Project