Releases: bysiber/cleardisk
Release list
ClearDisk v1.8.1
Fixed
- No menu bar icon; the app appears to do nothing (#22, #16).
NSApplication.delegateis a weak reference, and nothing else in the app retainedAppDelegate— every other reference to it capturedselfweakly. Held only by a local inmain(), ARC was free to release it after its last use, before or duringapp.run(), taking the status item and the popover with it. The process kept running (some users still saw notification banners) but there was no menu bar icon and clicks went nowhere. Whether it happened at all depended on the optimiser, which is why it reproduced on some Macs and not others. The delegate is now held for the life of the process.
Install
brew tap bysiber/cleardisk
brew trust bysiber/cleardisk
brew install --cask cleardiskOr download the DMG below and drag ClearDisk to Applications. The app is ad-hoc signed and not
notarized, so macOS blocks it on first launch. To open it:
- System Settings → Privacy & Security, scroll down, click Open Anyway, or
xattr -cr /Applications/ClearDisk.appin Terminal.
(Homebrew does this for you.)
ClearDisk v1.8.0
Added
- Project scanner expanded from 11 to 23 project types — Python, CocoaPods, Carthage, Xcode, .NET/C#, Godot, Unity, Unreal, Haskell, Elixir, Zig, Crystal, plus the modern JS caches (
.next,.nuxt,.svelte-kit,.angular,.turbo,.vite,.yarn/cache). A project now lists each of its caches as a separate row. - Cleanup history — every cleaned project cache is logged (what, where, how big, when) and can be reviewed or cleared from the Projects tab.
- Failed cleans are now reported. If a directory cannot be moved to the Trash, the app says so — and offers to open Full Disk Access settings when the cause is permissions.
Fixed
- Phantom savings: a clean whose
trashItemfailed still reported "Recovered X!", credited the savings and wrote a history entry, while the files were untouched on disk. Only bytes that actually reach the Trash are counted now, measured from disk rather than assumed. - Unclickable UI after reopening the popover: presenting a
.sheetfrom inside a.transientNSPopover strands SwiftUI's presentation state when the popover auto-closes on focus loss. The project sheets are drawn inside the popover now, and every modal is torn down when the popover closes. - Duplicate artifact rows: a directory matching two project types (a Unity project is also a .NET project; a JS+Python monorepo shares
dist/,build/,coverage/) was listed once per type, double-counting its size and failing the second clean. Each directory is surfaced once. - Data-loss guards:
env/,venv/,.venv/are only ever offered when a real virtualenv is proven (pyvenv.cfg/bin/activate), and Crystal'slib/only when ashard.lockprovesshards installran. UnityBuilds/and UnrealSaved/are no longer touched — those are user output, not caches. - The large-file scanner no longer looks inside media library packages (
.photoslibrary,.fcpbundle,.imovielibrary, …), where deleting a single file corrupts the whole library.
Changed
- The version is declared once, in
scripts/build_app.sh, and read back from the bundle at runtime. - Project cache actions use the same trash icon as the Developer tab — they perform the same destructive action.
Install
brew tap bysiber/cleardisk
brew trust bysiber/cleardisk
brew install --cask cleardiskOr download the DMG below and drag ClearDisk to Applications. The app is ad-hoc signed and not
notarized, so macOS blocks it on first launch. To open it:
- System Settings → Privacy & Security, scroll down, click Open Anyway, or
xattr -cr /Applications/ClearDisk.appin Terminal.
(Homebrew does this for you.)
v1.7.1
What's New
- Large Files tab redesign — folder-grouped cards (Downloads, Documents, Desktop, Movies, Music, Pictures)
- Tap any folder card to expand and see large files inside, sorted by size
- Added Music and Pictures folders to Large Files scan
- Full row is tappable (previously only icon/text area triggered expand)
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
ℹ️ First launch: macOS will block it because it is not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy and Security, scroll down and click Open Anyway
- Terminal (if GUI does not work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source — you can verify every line of code.
v1.7.0
What's New
- Game Engines: Unity Cache, Unity Hub Cache, UnityHub Templates, Unity Logs, Godot Export Templates, Godot Cache
- Version Managers: nvm Node Versions, pyenv Versions, mise Installs
- Python: Poetry Cache, pipenv Virtualenvs (community contribution by @IT-HONGREAT)
- Build Tools: SBT/Ivy Cache, Gradle Wrapper, Bazel Cache
- Cloud: AWS CLI Cache
- Total developer cache paths: 63 (was 50)
- Fixed: Deno cache path, JetBrains macOS path, Unity Hub path
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
ℹ️ First launch: macOS will block it because it is not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy and Security, scroll down and click Open Anyway
- Terminal (if GUI does not work):
xattr -cr /Applications/ClearDisk.app\> - **Terminal** (if GUI does not work):xattr -cr /Applications/ClearDisk.app> - Terminal ul> - Terminal (if GUI dove> - **Terminale of code.
v1.6.9
What's New
- Check for Updates -- New button in Settings to quickly check for the latest version (opens GitHub releases page in browser, zero network requests from the app)
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
ℹ️ First launch: macOS will block it because it is not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy and Security, scroll down and click Open Anyway
- Terminal (if GUI does not work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source -- you can verify every line of code.
v1.6.8
What's New
- Check for Updates -- New button in Settings to quickly check for the latest version (opens GitHub releases page in browser, zero network requests from the app)
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
⚠️ First launch: macOS will block it because it is not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy and Security, scroll down and click Open Anyway
- Terminal (if GUI does not work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source -- you can verify every line of code.
v1.6.7
What's New in v1.6.7
Added
- 6 new cache paths (44 -> 50 developer caches):
- Deno Cache - cached Deno modules and compiled scripts
- UV Cache - cached Python packages from uv (fast pip alternative)
- Playwright Browsers - downloaded browser binaries for testing
- Puppeteer Browsers - downloaded Chromium binaries
- Prisma Engines - Prisma ORM query engine binaries
- HuggingFace Cache - downloaded AI/ML models, tokenizers, datasets
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
⚠️ First launch: macOS will block it because it is not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy and Security, scroll down and click Open Anyway
- Terminal (if GUI does not work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source -- you can verify every line of code.
ClearDisk v1.6.6
What's New in v1.6.6
Added
- Settings screen -- Gear icon in header opens dedicated settings with notification management
- Notification controls -- Enable/disable notifications, permission status indicator, direct link to System Settings
- About section -- Version info and GitHub link in settings
Changed
- Notification permission banner removed from main view (moved to settings)
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
⚠️ First launch: macOS will block it because it's not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy & Security, scroll down and click "Open Anyway"
- Terminal (if GUI doesn't work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source -- you can verify every line of code.
ClearDisk v1.6.4
What's New in v1.6.4
Added
- Terraform/OpenTofu cache support -- Monitor
~/.terraform.dplugin cache and per-project.terraformartifact directories - Terraform added as project type for artifact scanning
- 3-tier cache filter -- Safe, Moderate, Everything with color-matched buttons
- Install and uninstall scripts (
scripts/install.sh,scripts/uninstall.sh) - Total cache paths: 43 -> 44
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
⚠️ First launch: macOS will block it because it's not notarized. Choose one:
- GUI: Open the app once (it will be blocked), then go to System Settings > Privacy & Security, scroll down and click "Open Anyway"
- Terminal (if GUI doesn't work):
xattr -cr /Applications/ClearDisk.appThis is needed because ClearDisk is not notarized ($99/yr Apple Developer fee). The app is fully open-source -- you can verify every line of code.
ClearDisk v1.6.3
What's New in v1.6.3
Added
- AI Tools cache support -- Claude Desktop, Claude Code, Ollama Models, ChatGPT Desktop, Cursor, Windsurf
- VS Code cache support -- Cache, CachedData, CachedExtensionVSIXs, Chromium Cache, Logs
- Collapsible groups -- Xcode, VS Code, AI Tools, Ruby caches grouped with expand/collapse UI
- Group actions -- clean entire group or reveal in Finder from group header
- Total cache paths: 32 -> 43
Changed
- Refactored cache path definitions into single source of truth (no more duplication)
Fixed
- Menu bar icon visibility on macOS Tahoe (always use template mode)
- Tray shows free space instead of cleanable amount
- Stale tray values fixed with Combine observer
- Expand view title centered properly
Download
Download the DMG below, open it, drag ClearDisk to Applications, then:
⚠️ IMPORTANT -- You MUST run this command in Terminal before opening the app:xattr -cr /Applications/ClearDisk.appWithout this, macOS will block the app from opening. This removes the Gatekeeper quarantine flag (the app is not code-signed). You can verify every line of source code -- it's fully open.