Changelog

All notable changes to Cluttered are documented here.

1.2.0February 25, 2026

Global Caches & Monorepo Support

Cluttered 1.2.0 introduces global cache scanning, a redesigned scan experience, and monorepo support.

New: Global Cache Scanning & Cleaning

  • 22+ cache types detected: npm, pnpm, Yarn, Bun, Gradle, pip, Homebrew, CocoaPods, Docker, Playwright, Electron, node-gyp, Xcode DerivedData, iOS DeviceSupport, iOS Simulator runtimes, Android SDK (AVDs, NDK, system images, build-tools), and more
  • Integrated into ecosystem grid: Global Caches card appears alongside ecosystem cards, sorted by size
  • Dedicated detail page: Caches grouped by category (Package Managers, Dev Tools, Mobile Dev) with individual selection
  • Caution tooltips: Non-safe items show an info tooltip explaining what happens if deleted
  • Select and clean from action bar: Same workflow as project cleaning

Redesigned Scan Progress

  • Radar sweep animation: Satisfying sonar-style centerpiece while scanning
  • Live counters: Watch projects found and recoverable space update in real-time
  • Ecosystem pills: Discovered ecosystems pop in as they're found
  • Shimmer progress bar: Smooth, seamless gradient animation
  • Path display: Currently scanned path with mid-truncation

Monorepo Support

  • Scanner now discovers nested projects inside monorepos and workspaces
  • Properly detects sub-projects within pnpm workspaces, Turborepo, Nx, and similar setups

Ecosystem Detail Improvements

  • Sort options: Sort projects by size, name, or last modified date
  • Status filters: Filter by project status (active, recent, stale, dormant)

Security & Reliability

  • Fixed command injection: Global cache cleaning now resolves commands server-side from trusted database instead of accepting them from the renderer
  • Concurrency guard: Prevents duplicate cleaning operations
  • Safer database migrations: Explicit column existence checks instead of silent error swallowing

UI Polish

  • Reduced card border radius for a tighter look
  • Fixed tooltip arrow rendering
  • Fixed ActionBar z-index overlap with content
  • Bottom padding so global caches content is accessible above the action bar
1.1.0December 30, 2025

Pro Features & Weekly Cleanup Limit

Cluttered 1.1.0 introduces Pro features with unlimited cleanup and automation capabilities.

New: Cluttered Pro

  • Unlimited Cleanup: Free users can now clean up to 20 GB per week. Pro removes this limit entirely
  • One-Time Purchase: Pro is a single $29 payment—no subscriptions, no recurring fees
  • License Activation: Simple in-app license key activation

Automation (Pro)

  • Scheduled Scans: Set Cluttered to scan automatically on your schedule
  • Auto-Clean Rules: Automatically clean dormant projects based on your criteria
  • Smart Notifications: Get notified when there's significant space to recover

Improvements

  • Faster Scanning: Optimized filesystem traversal for quicker scan results
  • Better Docker Detection: Improved detection of Docker images and build cache
  • Refined Activity Detection: More accurate project activity indicators

Bug Fixes

  • Fixed an issue where some Xcode DerivedData folders weren't detected
  • Fixed scan progress not updating in certain edge cases
  • Improved handling of symlinked directories

Notes

The 20 GB weekly limit for free users resets every 7 days. This allows casual users to keep their disk clean while Pro users get unlimited access for heavy development workflows.

1.0.1December 29, 2025

UI Polish & Analytics

This release focuses on improving the user experience with refined UI components and better feedback mechanisms.

UI Improvements

  • Redesigned Status Bar: Moved to the top of the screen with centered status info and integrated Settings button
  • Enhanced Action Bar: "Clean All" is now the default action, with "Clean Selected" appearing when you manually select projects
  • Consistent Button Styling: All buttons now follow a unified design system with the new btn-subtle style
  • Fixed Tooltip Colors: Tooltips now properly use the design system colors

New Features

  • Analytics Integration: Optional usage analytics to help improve Cluttered (using PostHog)
  • Database Reset: New pnpm reset-db command for troubleshooting

Build & Distribution

  • Mac App Store: Added build scripts for MAS distribution
  • DMG Installer: Improved DMG packaging for direct downloads
  • Migrated to pnpm: Faster and more reliable dependency management

Bug Fixes

  • Fixed infinite render loop in EcosystemCard component
  • Fixed environment variable loading for analytics
  • Improved scan progress display during active scans
1.0.0December 27, 2025

Initial Release

We're excited to announce the first public release of Cluttered!

Features

  • Multi-ecosystem scanning: Support for Node.js, Rust, Xcode, Docker, Python, Go, Android, Ruby, PHP, Java, Elixir, and .NET
  • Smart project detection: Identifies active vs dormant projects using git history and file modification times
  • Safe-by-default deletion: All deletions go to Trash first, with git-aware protection for uncommitted changes
  • Beautiful UI: A satisfying, dark-themed interface that makes disk cleaning enjoyable

What's Included

  • Parallel filesystem scanning for fast results
  • Project activity indicators (green/yellow/red)
  • Detailed artifact breakdown per project
  • Protected paths configuration
  • Deletion history and logs

Thank you for trying Cluttered! We'd love to hear your feedback.