V1.4.0 Turbine 🪓

✨ Clean Up v1.4.0 — Deep clean and optimize your Mac.

---

What's New

Performance Overhaul

• ~200× fewer subprocesses — batched mdls calls replace hundreds of individual spawns for app detection and unused app scanning
• Parallel size calculations — all scanners now compute directory sizes concurrently via spawn_blocking instead of sequentially
• Instant icon loading — replaced sips image conversion subprocess with direct .icns binary PNG extraction (zero temp files, zero shell calls)
• Two-phase scanner architecture — fast synchronous BFS walk to find paths, then parallel size computation
• Parallel ~/Library scanning — app leftover detection runs across all Library subdirectories simultaneously

UI

• Removed window title text from native macOS title bar for a cleaner look

---

Full Changelog: v1.3.0...v1.4.0

V1.3.0 Glacier 🪓

✨ Clean Up v1.3.0 — Deep clean and optimize your Mac.

---

What's new

• DMG distribution — download and install directly from GitHub Releases, no build tools needed
• Download instructions — README now includes step-by-step install guide with Gatekeeper bypass steps
• Build script — automatically copies DMG to dist/ alongside the .app bundle

Install

1. Download Clean.Up.dmg below
2. Open the DMG, drag Clean Up to Applications
3. First launch: System Settings → Privacy & Security → Open Anyway
4. Grant Full Disk Access for full scanner coverage

Requires macOS 13.0+ (Ventura or later).

V1.2.1 Spark 🪓

✨ Clean Up v1.2.1 — Deep clean and optimize your Mac.

---

Bug Fix

• Fixed: All click events (scanner card toggling, navigation tabs, Scan Selected, permissions) were non-functional in the Tauri WebView
  • Removed body::before grain overlay (z-index:9999) that blocked clicks in WKWebView despite pointer-events:none
  • Removed dangerousDisableAssetCspModification to let Tauri handle CSP nonces properly
  • Added safe bindEvent() helper for resilient event listener registration
  • Added window.onerror for visible JS error reporting

Docs

• Updated README for Tauri v2 architecture (removed outdated Terminal TUI and Swift launcher references)

Install

See INSTALL.md for full setup instructions.

V1.2.0 Burrow 🪓

✨ Clean Up

V1.2.0

Deep clean and optimize your Mac.

---

What's new

• Pre-flight warning for large trash operations — amber banner when trashing >5GB reminds you that Trash doesn't free space immediately
• TCC permission help hints — non-granted permissions now show what's affected and how to fix it
• Gatekeeper first-launch tip — collapsible "First time?" guidance on the scanner selection screen
• Open Trash in Finder — success toast includes a quick link to open Trash after moving items
• Stale server cleanup — relaunching the app now kills any orphaned server from a previous session (e.g. if you closed the browser tab)

v1.1.1

Version bump.

v1.1.0 — Scanner Filter Chips

What's New

• Scanner filter chips in the results view — pill-shaped buttons above results let you show/hide entire scanner groups
• Click a chip to toggle that group; click "All" to show everything
• Item count, reclaimable size, and Select All update to reflect only visible groups
• Filter state resets when navigating back to scan selection

v1.1.0 — Permissions Tab

What's New

• Permissions tab — new tab in the web UI showing macOS privacy permissions (Full Disk Access, Automation, App Management) with granted/missing status
• Open Settings button deep-links directly to the correct System Settings pane
• Auto-refresh — permissions re-check automatically when returning from System Settings
• No-cache HTML — browser always loads the latest UI, no more stale versions
• Shorter tab labels — Clean, Uninstall, Spotlight, Permissions

Clean Up v1.0.1

Clean Up v1.0.1

Bug fixes for Spotlight reindex, duplicate Spotlight entries, and CLI.

Fixes

• Spotlight status race condition — after triggering a reindex, the status now correctly shows "Indexing in progress" instead of immediately flipping back to "Up to date". Server tracks reindex timing with a 5-minute grace period while Spotlight starts up.
• Password dialog interference — background status polling is now paused while the admin password dialog is open, preventing the dialog from losing focus or resetting.
• Duplicate Spotlight entries — the build output in dist/ is now deleted after installing to ~/Applications, so only one "Clean Up" appears in Spotlight.
• CLI --version not working — the CLI symlink was pointing to the Swift GUI launcher instead of the server binary. Now clean-up --version works correctly.
• Workflow rules updated — enforces local build + install + version verification before every push.

Clean Up v1.0.0

Clean Up v1.0.0

Interactive macOS cleanup tool — zero dependencies, one standalone binary.

Scanners

• Dev Artifacts — finds node_modules, .next, dist, .venv, target, and other build caches across your home directory
• System Caches — browser caches (Chrome, Firefox, Safari, Arc, Brave, Edge, Opera), Xcode DerivedData, Homebrew, pip, yarn, npm, and Bun caches
• App Leftovers — detects orphaned preferences, caches, and containers from apps you've already uninstalled
• Large & Old Files — files over 100 MB or untouched for more than a year (smart git detection avoids flagging active project files)
• Unused Apps — apps not opened in 6+ months, detected via Spotlight metadata
• Homebrew Cleanup — old formula versions and stale cached downloads

Web UI

• Visual scanner selection with card-based interface
• Results grouped by category with size and age for every item
• Batch selection and one-click Trash

App Uninstaller

• Browse all installed apps with icons
• Search by app name
• Shows all associated data: Application Support, Caches, Containers, Logs, Preferences, Saved State
• Remove an app and all its data in one action

Spotlight Maintenance

• Check Spotlight indexing status
• Trigger a full reindex from the UI

Terminal TUI

• Fully interactive terminal mode with arrow-key navigation
• Multiselect with space/enter, toggle-all with a
• Works over SSH and in any terminal

Other

• Dry-run mode (--dry-run) — preview everything without touching files
• Native .app bundle — launch from Spotlight, no Terminal window
• Zero runtime dependencies — single compiled Bun binary
• Safe by design — path blocklist, all deletions go to macOS Trash (recoverable), localhost-only web server
• macOS 13.0+ (Ventura or later), Apple Silicon and Intel