Changelog

All notable changes to Cluttered are documented here.

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.