MacOS Cleaner 2.2.0

Major Update: Deep Forensic Uninstaller with Residual Verification, Project Build Artifacts Manager with Age Filters, Overhauled Disk Space Analyzer with APFS Allocated Sizing, and Massive Knowledge Base Expansion for 2026 Developer & AI Ecosystems.

---

🌟 What's New in 2.2.0

🔍 Forensic Residuals & Orphan Cleaning

• Post-Uninstall Verification Sheet: Inspect and review remnants immediately after removing an application, with granular checkbox control and evidence trails.
• Dedicated Orphan Scanner: Detect orphaned files left behind by previously uninstalled apps, organized into three confidence tiers (Guaranteed, Very Likely, Possible) with detailed evidence cards.
• Expanded Application Knowledge Base: Detection engine now catalogs over 275+ macOS applications and 1,880+ artifact locations (including Ghostty, Zen Browser, Dia, Ice, BetterDisplay, Dropover, AeroSpace, Yabai, Affinity Suite v2, OBS Studio, and HandBrake).

🛠️ Developer & AI Ecosystem Support

• Modern AI Toolchains & Agent Artifacts: Safe discovery and maintenance for Claude Code CLI, Goose AI, Continue.dev, Superwhisper, WhisperKit, Ollama, Apple MLX, and Hugging Face.
• Next-Gen Package Managers & Runtimes: Out-of-the-box support for uv, mise, proto, Tuist, CocoaPods, Zig/ZLS, vcpkg, Conan, Gradle, and Maven.
• Project Build Artifacts Isolation: Project-local caches (target, build, node_modules, .venv) are separated into a dedicated review category with configurable mtime age filtering (30, 60, 90, 180 days in Settings).

📊 Re-Engineered Disk Space Analyzer

• Interactive Directory Tree & Breadcrumbs: Navigate subfolders with instant drill-down and clickable breadcrumb navigation.
• Accurate APFS Block Sizing: Uses totalFileAllocatedSize to report actual physical disk usage without distortion from APFS copy-on-write clones or sparse files.
• Native Quick Look Integration: Preview any file directly with Space or the eye icon.
• iCloud Dataless Item Protection: Automatically skips dataless / cloud-only items to prevent accidental background downloads.

🛡️ System Hygiene & Safety Refinements

• Smart Time Machine Thinning: Replaced full snapshot deletion with graceful thinlocalsnapshots optimization based on reclaimable space.
• Privileged DNS Flush: Robust cache flushing using native PrivilegedTaskRunner.
• macOS 27 Interface Polish: Refined Liquid Glass materials, improved content contrast, and full keyboard navigation support (⌘,, ⌘C, ⌘F, ⌘R, ⌘⌫).
• Complete 10-Language Localization: Updated strings across English, Russian, Ukrainian, German, French, Spanish, Italian, Japanese, Portuguese (BR), and Simplified Chinese.

---

📦 Download & Verification

Asset	Description
MacOSCleaner.dmg	Universal Release DMG for Apple Silicon (macOS 26.0+)

# First launch Gatekeeper clearance (for self-built or direct DMG downloads):
sudo xattr -r -c /Applications/MacOSCleaner.app

MacOS Cleaner v2.1.1 - Privileged App Uninstallation Fix & System Maintenance

🚀 MacOS Cleaner v2.1.1_FIX

We are pleased to announce MacOS Cleaner v2.1.1! This release brings major stability fixes for root-protected app uninstallation, introduces a new System Maintenance suite in Settings (including Touch ID for sudo configuration and Spotlight index rebuilding), adds a startup update sheet with direct DMG download from GitHub Releases, and establishes a clean single source of truth for app versioning.

---

🌟 What's New & Key Highlights

🗑️ App Uninstaller: Privileged Root-Owned App Deletion & Batching

• Single Password Prompt for Root Apps: Fixed an issue where apps located in /Applications with root/admin ownership failed to delete or repeatedly prompted for credentials. All privileged filesystem operations are now batched into a single elevated command execution via PrivilegedTaskRunner.

• Safe Trash & Permanent Deletion Support: Correctly handles moving root-owned bundles to the user's ~/.Trash (with ownership normalization) or permanently removing them (rm -rf) if bypass-trash is enabled.

• Real-Time Progress Indicators:

  • Full-surface detail loading overlay with spinner during deletion.

  • Interactive button state changing to "Deleting..." with re-click prevention.

  • Active deletion spinner directly in the app list row for visual feedback.

---

🛠️ System Maintenance (New in Settings → General)

• Touch ID for sudo Command Helper:

  • Automatically detects biometric hardware support via LAContext.

  • Due to SIP (System Integrity Protection) constraints on macOS 26+ Tahoe blocking direct /etc/pam.d/ writes from non-interactive apps, we've introduced a convenient one-click Terminal command copy helper.

  • Added an instant "Check Status" verification button that dynamically checks /etc/pam.d/sudo_local and reflects active configuration with a green StatusPill.

• One-Click Spotlight Index Rebuilding (mdutil -E):

  • Added a direct tool to force reindex your startup disk (sudo mdutil -E -i on /).

  • Resolves broken macOS Spotlight search queries and inaccurate storage/disk calculation glitches.

  • Includes live progress spinner and instant execution status reporting.

---

🔄 Smart Updates (Startup Check)

• On launch the app performs a one-shot check against the public GitHub Releases API — no daemons, no background polling, no auto-install.
• If a newer version is available, an FDA-style sheet shows the current vs latest version with:
  • Download DMG — opens the release asset URL (MacOSCleaner.dmg)
  • View Releases — opens the GitHub Releases page
• Snooze options: Later (this session) or Don't remind for this version.
• Manual check remains available from Settings → General and the app menu. About / Settings prefer the DMG link when the asset is present.

---

⚙️ Version Architecture & Single Source of Truth (SoT)

• Unified the application versioning directly inside project.yml (MARKETING_VERSION: 2.1.1).

• Removed hardcoded fallback versions across SwiftUI views (AboutView, SettingsGeneralView, SettingsView).

• Version is now dynamically retrieved at runtime directly from Bundle.main.infoDictionary.

---

🌍 100% Localization Parity Across 10 Languages

Every newly added feature, prompt, button, tooltip, and status indicator has been translated and validated with 100% key parity across all 10 supported languages:

• 🇺🇸 English (en)
• 🇩🇪 Deutsch (de)
• 🇯🇵 日本語 (ja)
• 🇫🇷 Français (fr)
• 🇨🇳 简体中文 (zh-Hans)
• 🇮🇹 Italiano (it)
• 🇧🇷 Português (Brasil) (pt-BR)
• 🇪🇸 Español (es)
• 🇷🇺 Русский (ru)
• 🇺🇦 Українська (uk)

---

📋 Full Changelog

• Uninstaller: Batched privileged operations in UninstallerService and CandidateCollector.
• Uninstaller UI: Added isDeleting overlay, button activity spinners, and row-level progress.
• Domains: Created SystemMaintenanceService for hardware checks, PAM status inspection, and mdutil calls.
• Settings: Added System Maintenance card with Touch ID command copy + status check and Spotlight reindex button.
• Updates: Extended UpdateChecker with AvailableUpdate (version + DMG asset URL); added FDA-style UpdateAvailableView shown after FDA guidance when a newer release exists.
• Updates: Settings, About, and menu “Check for Updates” open the DMG when available, otherwise the Releases page.
• Search: Registered maintenance actions in SettingsSearchRegistry for global settings search.
• Docs: Updated README.md (Smart Updates + networking note).

---

💬 Feedback & Community

Ran into an edge case or have a suggestion?

• 💬 Join our GitHub Discussions
• 🐛 Report bugs or submit logs in GitHub Issues
• ⭐ If you like MacOS Cleaner, please consider giving us a star!

MacOS Cleaner v2.1.0

Update 2.1.0 expands the application's capabilities with new system integrations, architectural optimizations, and smart cleanup tools, strictly following our safe-to-use philosophy.

🎙 Siri & App Shortcuts Integration

• Voice Control: Full support for Siri commands (e.g., "Hey Siri, clean DerivedData").
• App Shortcuts: System intents for automation via Shortcuts.app and Automator, including CleanDeveloperCachesIntent, GetStorageStatusIntent, CleanCategoryIntent, and RunScheduledCleanupIntent.
• Management: Detailed Siri and automation settings built directly into the app.

🔍 Duplicate File Finder

• Multi-stage Comparison: Fast and precise search without external dependencies (Size filter ➔ 4KB Header hash ➔ Full SHA-256).
• Data Safety: Smart auto-selection for outdated copies and strict thread isolation (Swift 6 strict concurrency) to prevent data races.

🎨 Design & UI (macOS 27 Liquid Glass)

• Interactive Dashboard: New Apple Watch-style activity rings chart (DiskRingsChartView) with exact used-space proportion calculations.
• Native Aesthetics: Global adoption of Liquid Glass components (glass cards, GlassPillPicker toggles, ProcessSplitButton dropdowns).
• Window Optimization: Redesigned SettingsView, adaptive scaling in the Uninstaller, unified paddings, and support for fixed minimum window sizes.

⚙️ High-Performance Scan Engine

• Hybrid Database: Covers 250+ apps and 1770+ paths. The architecture now uses an O(1) registry with build-time path compilation (no runtime JSON parsing).
• Offline Catalog: Internal offline catalog for uninstaller and cleanup paths, ensuring functionality without network access.
• App Residuals Engine: Dynamic discovery of leftover files from apps deleted before macOS Cleaner was installed (finds "orphaned" files based on 2+ evidence points).
• Developer Artifacts: Safe cleanup of multi-platform local build artifacts (Xcode/DerivedData, Node.js, Python, Gradle, CMake, Rust, Go, and Dart/Flutter).
• AI & Local LLM: Detection and opt-in manual cleanup of local AI models (Ollama, HuggingFace, LM Studio, whisper, etc.).
• APFS & Time Machine: Tracking and clearing of APFS Purgeable Space and Time Machine local snapshots.
• Hidden Caches: Dynamic discovery of Electron app caches (VS Code, Notion, Figma, Cursor, etc.) and stale app updates (Sparkle/Squirrel).

🌍 New Languages

The app is now localized into 10 languages. Added in version 2.1.0:

• German
• French
• Italian
• Japanese
• Chinese (Simplified)
• Portuguese (Brazil)

macOS Cleaner v2.0.0

🧠 On-Device Apple Intelligence

• Native Foundation Models Integration: Fully offline analysis of running processes, startup agents, files, and application leftovers.
• Smart Explanations: Click the ✨ (sparkles) icon in any section (Uninstaller, Startup Services, Processes, Smart Cleanup, Disk Analyzer) to get local AI explanations in your preferred language (English, Русский, Українська, Español).

🌌 Liquid Glass Redesign (macOS 27+)

• Adaptive Glass Interface: Transitioned to GlassEffectContainer, .glassEffect(), and .glassButtonStyle() with native blur rendering and responsiveness to the system "Reduce Transparency" setting.
• Micro-animations: Smooth card morphing using matchedGeometryEffect and interactive hover highlights.

📁 New Disk Space Analyzer

• File & Folder Breakdown: Scan custom folders to browse subdirectories and files sorted by size with interactive categories (Video, Audio, Photos, Apps, Documents, Archives).
• Quick Actions: Reveal any item in Finder or move it to the Trash immediately using the safe trashItem(at:) API.
• Background Scanning: Keeps scanning without interruption when the window is minimized or inactive.

📊 Redesigned Dashboard

• Interactive Radar Chart: High-level visual distribution of disk usage (Caches, Logs, Development, Applications, Media, Other).
• Hover Tooltips: Instantly check size allocations with hover stats.

⚙️ Process Manager

• View Modes: Toggle between Flat and Grouped application hierarchies.
• Flexible Sorting: Sort by CPU, Memory, Name, or Threads.
• Whitelists & Blacklists: Add resource-heavy apps to the Blacklist for quick termination, or guard crucial ones with the Whitelist to prevent accidental termination.

🚀 Startup Services

• Deep Scanning: Scan LaunchAgents and LaunchDaemons from both user-level (~/Library) and system-level (/Library) directories.
• Smart Categorization: Group services automatically into My Services (User), Third-party, and System categories.
• Safe Management: Load, unload, or stop active services (requesting administrator privileges via AppleScript when necessary), and customize protected System Vendors.

🗑️ Advanced App Uninstaller

• Evidence-Based Forensics: Scans up to 5 levels deep using 30 evidence types (Bundle ID, Team ID, Spotlight metadata, Plist contents, Launch Services database, etc.).
• Drag & Drop: Easily drop any .app bundle into the window to initiate an instant deep scan.
• Confidence Tiers: Evaluates leftover files to distinguish critical components from optional files (.guaranteed, .veryLikely, .possible, .ignore).

🧹 Safer & More Precise Cleaning

• Precise Deletion: Refined the Smart Cleanup logic to remove caches and temp files without touching user data.
• SafetyManager Policies: Hardened path restrictions protecting system directories (/System, /usr, /bin, ~/.ssh, etc.) and system-critical processes.
• Developer Toggles: Added explicit cleanup options for Maven local repositories (~/.m2), Go package caches (GOMODCACHE), and Flutter/Dart .dart_tool build data.
• Clutter-free Sizes: Sizes below 1MB are formatted in KB instead of rounding down to "0 MB" for absolute transparency.

macOS Cleaner v1.1.1

This release brings two highly requested features: more control over the Uninstaller's aggressiveness and an automatic in-app update checker.

🌟 What's New
🛡️ Uninstaller Scan Modes
You can now choose how aggressive the Uninstaller should be when finding leftover files.

Safe Mode: Only finds high-confidence files (matching by Bundle ID, exact app name, or receipts). It completely disables Spotlight (mdfind) and fuzzy matching, minimizing the risk of accidentally affecting shared files.
Balanced Mode (Default): Performs a full deep scan, including Spotlight and extended paths, to find all possible leftovers. Recommended for thorough cleanups. Switch between modes anytime in Settings → Uninstaller.

🔄 Smart Update Checker
macOS Cleaner will now automatically check for new versions on startup directly via GitHub Releases.
Get a gentle, native notification in the About window and Settings when an update is available.
Privacy First: No background daemons, no persistent tracking, and no extra dependencies.
You can also manually check for updates in the Settings → General tab.

🛠️ Enhancements & Fixes
Added clear badges in the Uninstaller view to indicate the active scan mode.
Fully localized new features.

MacOSCleaner v1.1

MacOSCleaner v1.1 Release Notes

We're excited to announce the release of MacOSCleaner v1.1! This major update brings a completely overhauled uninstaller engine, comprehensive localization, a native macOS UI redesign, and dozens of new cleaning categories.

🌍 Complete Localization & Internationalization

MacOSCleaner is now fully localized and supports multiple languages to provide a native experience for users worldwide:

• Supported Languages: English, Russian, Ukrainian, and Spanish.
• Dynamic Formatting: Dates and byte counts (e.g., GB, MB, KB) now dynamically format according to your selected application language.
• Full Coverage: All UI elements, error messages, cleanup logs, and system information screens have been fully translated.

🗑️ Advanced Uninstaller Engine

The Uninstaller has been rewritten from the ground up for maximum safety and thoroughness:

• Evidence-Based Scanning: A new 5-level deep scanning engine automatically tracks down hidden related files using 14 types of evidence (Bundle ID, Team ID, Spotlight, Plist contents, etc.).
• Background Deep Scanning: Apps are now thoroughly scanned in the background. The UI displays real-time progress and instantly updates the app's total size once deep scanning is complete.
• Developer Components: The uninstaller now detects and allows you to safely remove leftover developer components alongside the application.
• Reveal in Finder: A new quick action allows you to instantly reveal any related file or folder in Finder before deciding to delete it.

🎨 Native macOS UI Redesign

The interface has been modernized to align perfectly with Apple's Human Interface Guidelines:

• Settings Redesign: Completely rebuilt using native macOS Form styles to match System Settings perfectly.
• Modernized Dashboards: The Dashboard, Processes, and Startup Services views now feature a refined Apple Design aesthetic with controlBackgroundColor, rounded cards, and SF Symbols.
• Optimized Layout: The minimum window width has been adjusted to 800px for a more compact and flexible workspace.

🧹 Expanded Cleanup Capabilities

The cleanup engine is faster, safer, and knows about more apps than ever before:

• 54 Cleanup Categories: Including 18 brand new categories like Launch Agents/Daemons, Privileged Helper Tools, Package Receipts, and unused applications.
• 298 Built-in Cleaning Paths: Safely clears caches for popular browsers, IDEs (VSCode, JetBrains, Cursor, Xcode), and language environments (Node, Python, Ruby, Swift, Go, etc.).
• Parallel Execution: Cleanup tasks now run concurrently for significantly faster performance.
• 29 New App-Specific Rules: Tailored uninstallation rules for over 95 popular apps, including Docker, Parallels, Adobe CC, MS Office, Discord, Figma, and more.

🐛 Bug Fixes & Safety Improvements

• Full Disk Access (FDA): Fixed an issue where the FDA guidance window wouldn't appear on startup, and resolved false positives in FDA permission checks by validating restricted directories.
• OrbStack Safety: Safely removed OrbStack paths from IDE caches to prevent accidental deletion of VM and Docker infrastructure.
• Duplicate Files: Fixed a bug causing the duplicate files scanner to report inflated disk usage numbers.
• Xcode Previews: Resolved a compilation issue preventing Xcode Canvas previews from rendering in Debug mode.

MacOS Cleaner v1.0.1

Fixed

• Fixed Android Studio size calculation. Removed .img, .raw, and .qcow2 from global exclusions so Android SDK system images and AVDs are counted correctly.
• Added a three-layer sparse file detection system (extension/name/directory checks, parent-chain validation, and automatic sparse ratio detection) to avoid false positives from Docker and OrbStack virtual disks.
• Fixed duplicate developer components section in Expert Mode.

Changed

• Refactored App Uninstaller and removed the legacy SharedComponent system.

• Uninstaller now removes only application-owned data:

  • Application bundle (.app)
  • Preferences
  • Caches
  • Logs
  • Application Support
  • Containers
  • LaunchAgents

• Developer infrastructure is no longer treated as removable application data.

Added

• Added a dedicated Related Developer Data section in App Uninstaller.

• Added an Open Smart Cleanup action for managing shared developer resources such as:

  • Android SDK
  • Gradle
  • Homebrew
  • Docker
  • Xcode DerivedData
  • iOS Simulators

MacOS Cleaner v1.0 - First Stable Release

🚀 Key Features:
• Smart Cleanup: 35+ cleanup categories including system caches, browsers, messengers, Xcode, Docker, package managers, and IDEs.
• App Uninstaller: Deep application removal with support for leftover files and duplicate version detection.
• Process Manager: Process management with protection for critical system daemons.
• Startup Services: Enable or disable user LaunchAgents without modifying system settings.
• Multilingual Support: English, Russian, and Ukrainian with instant language switching.

⚡ Under the Hood:
• Native SwiftUI interface with zero third-party UI dependencies.
• Optimized for Apple Silicon with parallel scanning, actors, and strict data isolation.
• Safety First: Trash-based deletion by default (with optional permanent removal) and SIP-protected system directory safeguards.

Ready for everyday use.

Main script

The main script used as a basis for building the application.