v1.2.2

What's new in 1.2.2

• Correct storage figures on Windows and Linux: sizes now follow each platform's own convention — 1024-based GB on Windows (matching File Explorer and Settings → Storage) and GiB on Linux (matching df and du) — instead of the decimal units that only line up with macOS. Free-space readouts and item sizes no longer read slightly high next to the numbers the OS reports itself. macOS is unchanged (decimal, matching Finder).
• Simpler Linux install: a one-line installer now does the work — curl -fsSL https://ms-teja.github.io/clean-mind/install.sh | sh detects your CPU and installs the .deb on Debian/Ubuntu/Kali/Mint, or a per-user build on other distros. The manual .deb and tarball options remain.

The scanning engine and everything else are unchanged since 1.2.1.

Install

macOS (universal — Apple silicon + Intel)

Easiest via Homebrew (no Gatekeeper hoops):

brew install --cask MS-Teja/clean-mind/clean-mind

Or download the DMG, open it, drag Clean Mind to Applications. One DMG covers both Apple silicon and Intel Macs.

This free app is not notarized (there is no paid Apple Developer account behind it), so the first launch needs one extra step:

• macOS 15 (Sequoia) and later: open the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll down to "Clean Mind" was blocked, and click Open Anyway.
• macOS 14 and earlier: right-click the app in Applications and choose Open, then Open again.
• Terminal alternative: xattr -d com.apple.quarantine "/Applications/Clean Mind.app"

Linux

Easiest via the one-line installer — it detects your CPU and installs the latest release:

curl -fsSL https://ms-teja.github.io/clean-mind/install.sh | sh

On Debian/Ubuntu/Kali/Pop!_OS/Mint that installs the .deb (launcher entry + a clean-mind command; GTK 3 pulled in automatically). On other distros it does a per-user tarball install (launcher entry + icon, no root needed).

Prefer manual? Download the .deb for your CPU from the assets below — amd64 (Intel/AMD) or arm64 (Raspberry Pi 5, Ampere, VMs on Apple-silicon Macs; not sure, run dpkg --print-architecture) — then, from the folder you downloaded it to (keep the ./):

sudo apt install ./clean-mind_1.2.2_arm64.deb   # or _amd64.deb

Or grab the linux-x64/linux-arm64 tarball, extract it, and either run ./clean-mind/clean_mind directly or ./clean-mind/install.sh for a per-user install.

Windows

Easiest via Scoop:

scoop bucket add clean-mind https://github.com/MS-Teja/scoop-clean-mind
scoop install clean-mind

Or download the zip for your CPU from the assets below — windows-x64 (Intel/AMD) or windows-arm64 (Snapdragon X and other Arm PCs) — extract it, and run clean_mind.exe. If SmartScreen warns, click More info → Run anyway.

Issue reports for Linux and Windows are very welcome.

What's Changed

• Bump the winget manifest to 1.2.1 by @MS-Teja in #22
• Clarify the Linux install instructions by @MS-Teja in #23
• Run integration tests in CI and add Dependabot by @MS-Teja in #24
• Shard the hardlink-dedup set so scan workers stop serializing on one lock by @MS-Teja in #25
• Cover the providers and delete-flow gates with unit tests by @MS-Teja in #26
• Bump keyring from 4.1.2 to 4.1.4 in /rust in the cargo-minor-patch group by @dependabot[bot] in #31
• Bump windows-sys from 0.60.2 to 0.61.2 in /rust by @dependabot[bot] in #32
• Bump actions/checkout from 4 to 7 by @dependabot[bot] in #30
• Bump actions/upload-artifact from 4 to 7 by @dependabot[bot] in #28
• Bump actions/download-artifact from 4 to 8 by @dependabot[bot] in #27
• Bump softprops/action-gh-release from 2 to 3 by @dependabot[bot] in #29

New Contributors

• @dependabot[bot] made their first contribution in #31

Full Changelog: v1.2.1...v1.2.2

v1.2.1

What's new in 1.2.1

• Windows fix: the zips now bundle the Visual C++ runtime DLLs (msvcp140, vcruntime140, vcruntime140_1), so Clean Mind launches on machines that don't already have the redistributable installed. Previously, a fresh Windows install failed with "VCRUNTIME140.dll was not found".

Nothing else changed since 1.2.0 — macOS and Linux builds are identical apart from the version number.

Install

macOS (universal — Apple silicon + Intel)

Easiest via Homebrew (no Gatekeeper hoops):

brew install --cask MS-Teja/clean-mind/clean-mind

Or download the DMG, open it, drag Clean Mind to Applications. One DMG covers both Apple silicon and Intel Macs.

This free app is not notarized (there is no paid Apple Developer account behind it), so the first launch needs one extra step:

• macOS 15 (Sequoia) and later: open the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll down to "Clean Mind" was blocked, and click Open Anyway.
• macOS 14 and earlier: right-click the app in Applications and choose Open, then Open again.
• Terminal alternative: xattr -d com.apple.quarantine "/Applications/Clean Mind.app"

Linux

On Debian/Ubuntu/Kali/Pop!_OS/Mint: first download the .deb for your CPU from the assets below — amd64 (Intel/AMD) or arm64 (Raspberry Pi 5, Ampere, VMs on Apple-silicon Macs; not sure, run dpkg --print-architecture). Then install it from the folder you downloaded it to (keep the ./ — it tells apt this is a local file):

sudo apt install ./clean-mind_1.2.1_arm64.deb   # or _amd64.deb

This adds a launcher entry and a clean-mind command. Requires GTK 3 (pulled in automatically).

No root, or not on a Debian-based distro? Download the linux-x64/linux-arm64 tarball instead, extract it, then either run ./clean-mind/clean_mind directly or run ./clean-mind/install.sh to install it for your user (launcher entry + icon, no root needed).

Windows

Easiest via Scoop:

scoop bucket add clean-mind https://github.com/MS-Teja/scoop-clean-mind
scoop install clean-mind

Or download the zip for your CPU from the assets below — windows-x64 (Intel/AMD) or windows-arm64 (Snapdragon X and other Arm PCs) — extract it, and run clean_mind.exe. If SmartScreen warns, click More info → Run anyway.

Issue reports for Linux and Windows are very welcome.

What's Changed

• Refresh README screenshots and demo for the 1.2 landing screen by @MS-Teja in #17
• Tighten the README install section by @MS-Teja in #16
• Bump the winget manifest to 1.2.0 by @MS-Teja in #18
• Bundle the VC++ runtime in Windows zips (v1.2.1) by @MS-Teja in #19
• Add a security policy, issue templates, and a PR template by @MS-Teja in #20
• Bump tokio past the broadcast-channel advisory by @MS-Teja in #21

Full Changelog: v1.2.0...v1.2.1

v1.2.0

What's new in 1.2.0

Windows and Linux, first-class

• 22 new cleanup rules close the platform gap: NuGet, Poetry, node-gyp, Electron, ccache, Composer, and vcpkg caches, plus Windows locations for Yarn, pnpm, uv, Go, and JetBrains caches. Docker's disk images are recognized too — flagged review-only, with docker system prune guidance instead of a delete button.
• The safety denylist now also protects Videos, Contacts, Windows credential stores (DPAPI), and GNOME keyrings — nothing, including the AI, can suggest deleting them.
• Easier installs: Windows via Scoop (scoop bucket add clean-mind https://github.com/MS-Teja/scoop-clean-mind, then scoop install clean-mind), and .deb packages for Debian/Ubuntu/Kali/Mint alongside the tarballs.

A clearer landing screen

• The scan-target card was rebuilt: a friendly target name over the path, a free-space meter for the target's disk, and four tidy quick picks (Home, Downloads, Applications, Entire disk). Anything else is one Change click — or a drag-and-drop — away.

Faster and lighter

• Whole-scan search is indexed and debounced — it no longer rescans every name on every keystroke.
• The scanner sheds millions of avoidable allocations per scan, and progress reporting no longer serializes worker threads — the biggest wins land on modest 4-core machines.
• The app is ~18% smaller on disk and uses ~40% less memory after a large scan (link-time optimization, stripped symbols, and the UI now releases per-folder caches it no longer needs).

Install

macOS (universal — Apple silicon + Intel)

Easiest via Homebrew (no Gatekeeper hoops):

brew install --cask MS-Teja/clean-mind/clean-mind

Or download the DMG, open it, drag Clean Mind to Applications. One DMG covers both Apple silicon and Intel Macs.

This free app is not notarized (there is no paid Apple Developer account behind it), so the first launch needs one extra step:

• macOS 15 (Sequoia) and later: open the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll down to "Clean Mind" was blocked, and click Open Anyway.
• macOS 14 and earlier: right-click the app in Applications and choose Open, then Open again.
• Terminal alternative: xattr -d com.apple.quarantine "/Applications/Clean Mind.app"

Linux

On Debian/Ubuntu/Kali/Pop!_OS/Mint, grab the .deb for your CPU — amd64 (Intel/AMD) or arm64 (Raspberry Pi 5, Ampere, Apple-silicon VMs) — and install it system-wide:

sudo apt install ./clean-mind_<version>_amd64.deb

This adds a launcher entry and a clean-mind command. Requires GTK 3 (pulled in automatically).

No root, or not on a Debian-based distro? Download the linux-x64/linux-arm64 tarball instead, extract it, then either run ./clean-mind/clean_mind directly or run ./clean-mind/install.sh to install it for your user (launcher entry + icon, no root needed).

Windows

Easiest via Scoop:

scoop bucket add clean-mind https://github.com/MS-Teja/scoop-clean-mind
scoop install clean-mind

Or pick the zip for your CPU — windows-x64 (Intel/AMD) or windows-arm64 (Snapdragon X and other Arm PCs) — extract it, and run clean_mind.exe. If SmartScreen warns, click More info → Run anyway.

Issue reports for Linux and Windows are very welcome.

What's Changed

• Tune the release profile for size and speed by @MS-Teja in #5
• Make the results UI cheaper: debounced search, isolated selection, autoDispose, reclaimable index by @MS-Teja in #6
• Refresh the demo GIF and screenshots for the 1.1.0 UI by @MS-Teja in #7
• Rust hot-path quick wins: search index, static strings, lock hygiene, clone cleanup by @MS-Teja in #8
• Collect sibling names lazily and without copies in the scan loop by @MS-Teja in #9
• Windows/Linux rules and safety denylist parity by @MS-Teja in #10
• Ship Debian packages and prep winget; point installs at Scoop by @MS-Teja in #11
• Redesign the README around privacy, trust, and cross-platform by @MS-Teja in #12
• Show the target volume's free space on the landing card by @MS-Teja in #13
• Restructure the scan-target card by @MS-Teja in #14
• Bump version to 1.2.0 by @MS-Teja in #15

Full Changelog: v1.1.0...v1.2.0

v1.1.0

What's new in 1.1.0

Navigate and search your scan

• Back / forward navigation through the folders you visit (Cmd+[ / Cmd+], or Ctrl on Linux/Windows), with a breadcrumb trail.
• Whole-scan search — find any file or folder by name and jump straight to it in the treemap.
• List view as an alternative to the treemap: sortable by name, items, or size; double-click to drill in. Your view and sort choices are remembered.
• Right-click context menu on treemap tiles: open, reveal, copy path, focus.

Easier scanning

• Drag & drop a folder anywhere on the window to scan it.
• One calm scan card on the landing screen: quick picks (Home, Desktop, Documents, Downloads, Applications, mounted volumes, entire disk), a recent-scans menu, and the current target in one place.
• The scanner now survives extremely deep trees, reports folders it couldn't read (instead of silently under-counting), and shows both on-disk and apparent sizes.

A friendlier settings screen

• Redesigned two-pane settings (AI assistant / Privacy / About) — open it from anywhere with Cmd+, (Ctrl+, on Linux/Windows).
• Opening settings no longer triggers a macOS keychain password prompt. The key is only read when you actually run a connection test or analysis.
• Settings now say clearly whether an API key is saved, and let you remove it.
• Your model and base URL are remembered per provider — switching providers never wipes them. Fields are saved however you close the dialog.
• Check for updates is one click away in the settings sidebar.

Cross-platform

• The macOS DMG is a universal binary (Apple silicon + Intel), enforced in CI.
• New Linux arm64 and Windows arm64 builds (Raspberry Pi 5, Ampere, Snapdragon X, …).
• Windows: opening files from the app now uses your default handler correctly.

Polish

• Seamless macOS title bar and themed menus and popups throughout.

Install

macOS (universal — Apple silicon + Intel)

Easiest via Homebrew (no Gatekeeper hoops):

brew install --cask MS-Teja/clean-mind/clean-mind

Or download the DMG, open it, drag Clean Mind to Applications. One DMG covers both Apple silicon and Intel Macs.

This free app is not notarized (there is no paid Apple Developer account behind it), so the first launch needs one extra step:

• macOS 15 (Sequoia) and later: open the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll down to "Clean Mind" was blocked, and click Open Anyway.
• macOS 14 and earlier: right-click the app in Applications and choose Open, then Open again.
• Terminal alternative: xattr -d com.apple.quarantine "/Applications/Clean Mind.app"

Linux (experimental)

Pick the tarball for your CPU — linux-x64 (Intel/AMD) or linux-arm64 (Raspberry Pi 5, Ampere, Apple-silicon VMs). Extract it, then either run ./clean-mind/clean_mind directly or run ./clean-mind/install.sh to install it for your user (launcher entry + icon, no root needed). Requires GTK 3.

Windows (experimental)

Pick the zip for your CPU — windows-x64 (Intel/AMD) or windows-arm64 (Snapdragon X and other Arm PCs). Extract it and run clean_mind.exe. If SmartScreen warns, click More info → Run anyway.

Linux and Windows builds compile and pass tests in CI but have had less real-world testing than macOS — issue reports are very welcome.

What's Changed

• Improve scan navigation, search, and robustness by @MS-Teja in #2
• Calm landing screen, pseudonymization docs, curated release notes by @MS-Teja in #3
• Install Flutter from git on arm64 release runners by @MS-Teja in #4

New Contributors

• @MS-Teja made their first contribution in #2

Full Changelog: v1.0.0...v1.1.0

v1.0.0

Install

macOS

Download the DMG, open it, drag Clean Mind to Applications.

This free app is not notarized (there is no paid Apple Developer account behind it), so the first launch needs one extra step:

• macOS 15 (Sequoia) and later: open the app once (it will be blocked), then go to System Settings → Privacy & Security, scroll down to "Clean Mind" was blocked, and click Open Anyway.
• macOS 14 and earlier: right-click the app in Applications and choose Open, then Open again.
• Terminal alternative: xattr -d com.apple.quarantine "/Applications/Clean Mind.app"

Linux (experimental)

Extract the tarball and run ./clean-mind/clean_mind. Requires GTK 3.

Windows (experimental)

Extract the zip and run clean_mind.exe. If SmartScreen warns, click More info → Run anyway.

Linux and Windows builds compile and pass tests in CI but have had less real-world testing than macOS — issue reports are very welcome.

Full Changelog: https://github.com/MS-Teja/clean-mind/commits/v1.0.0