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-subtlestyle - 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-dbcommand 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.