Mole Updates & Release Notes

Mole

Deep clean and optimize your Mac.

Changelog

Clean leaves Homebrew downloads that are still transferring alone: a running brew fetch used to lose its in-flight cask downloads and its own lock files, and Homebrew's lock directory is no longer swept at all.

A slow check no longer cancels the rest of the run: a Spotlight probe, a Large files sizing pass, or a simulator runtime review that times out now skips that item and carries on, and routine timeout notes stay out of the summary.

Clean reaches Notion's workspace cache: only the cache storage is swept, the script cache and databases are left alone, and the whole family is skipped while Notion is running.

Uninstall names what it could not verify: an incomplete scan, a failed cask lookup, and undetermined ownership each arrive with the check to run, and selector rows stay on one line in an 80-column terminal.

mo works when it is invoked through a symlink: the launcher resolves the real directory behind the link, so it still finds its own libraries.

更新日志

Clean 不再删除正在下载的 Homebrew 文件：之前正在跑的 brew fetch 会丢掉在途的 cask 下载和它自己持有的锁，Homebrew 的锁目录现在完全不再清理。

某一步检查超时不再中断整轮清理：Spotlight 探测、大文件体积统计和模拟器运行时检查超时后只跳过这一项继续往下走，常规超时说明也不再进入结果汇总。

Clean 支持 Notion 工作区缓存：只清缓存存储，保留脚本缓存和数据库，Notion 运行期间整体跳过。

Uninstall 会说明哪些没能确认：预检没扫完、cask 查询失败、归属无法判定，都会连同该跑的检查命令一起给出，选择列表在 80 列终端里也不再折行。

通过软链调用 mo 时能正常工作：启动器会解析出软链背后的真实目录，因此仍能找到自己的依赖库。

Thanks

Issue reporters and PR contributors this cycle: @ishaanko · @xtnntn · @huangy7 · @idhyt · @jiji262 · @iammike2 · @TarGz · @TyceHerrman.

Mole Mac App

Prefer a GUI? Mole Mac App brings cleaning, app management, maintenance, disk analysis, and live system status into one native app, with review before deletion and a customizable menu bar HUD. It is $19 once, with lifetime updates and a 14-day refund. Download and try it. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Optimize explains more causes of a slow Mac: performance diagnosis now shows swap pressure and memory-heavy processes, virtual machine memory use, and sustained CPU usage, while failed probes are reported without treating missing data as a healthy result.

Smoother loading animations: scan indicators share a consistent dot animation, and Clean updates progress text in place between stages to reduce flicker and make waiting easier to follow.

Clean reaches more app caches: adds Feishu/Lark webview caches, WeChat and WeCom container caches and logs, and stale Codex crash reports, with active apps and chat data protected.

Developer cleanup covers abandoned browser sessions and test devices: reclaims orphaned Playwright browsers and stale profiles while preserving active sessions, handles Xcode test clones individually, and lists unused simulator runtimes with a manual removal command.

Purge is easier to review and safer to automate: improves project search, paging, and selection responsiveness, preserves artifacts containing deployment keys, Git-tracked files, or nested repositories, names candidates it could not inspect, and requires --yes for unattended cleanup.

Clean preserves more state and reports partial results clearly: leaves Calendar caches alone, adds a whitelist option for Final Cut Pro proxy media, restores obsolete VS Code extension cleanup on macOS 15, and improves external-volume scans and timeout or Trash failure messages.

Uninstall shows recognizable app names without disrupting other apps: follows preferred system languages and refreshes names after language changes, recognizes mixed-case .app suffixes, and avoids restarting unrelated active extensions such as Shadowrocket's VPN tunnel.

Analyze and Status make their limits visible: Analyze explains that deleting an app bundle leaves its support files behind and offers an uninstall command, while Status marks retained process data and alerts as stale when refreshes fail.

Command output works better in terminals and scripts: Analyze and Status have dedicated help text, errors go to stderr, and redirected output omits color codes.

Installation and updates fail earlier with clearer guidance: checks for macOS 12 or newer and rejects running the installer with sudo before writing files, while Homebrew updates repair launchers that point to removed versions.

更新日志

Optimize 能看出更多 Mac 变慢的线索：性能诊断新增交换空间压力、内存占用较高的进程、虚拟机内存和持续 CPU 占用，检查失败时会明确提示，不把缺少数据当作正常结果。

Loading 动画更流畅：扫描提示统一使用圆点动画，Clean 在阶段切换时原位更新进度文字，减少闪烁，让等待过程更清晰。

Clean 支持更多应用缓存：新增飞书和 Lark 内嵌网页缓存、微信和企业微信容器内的缓存与日志，以及过期 Codex 崩溃报告清理，保留正在使用的应用状态和聊天数据。

开发工具清理覆盖遗留浏览器和测试设备：回收已失去所属进程的 Playwright 浏览器与过期临时配置，保留活跃会话，逐项处理 Xcode 测试克隆，并列出无设备使用的模拟器运行时及手动移除命令。

Purge 更好查找，也更适合脚本使用：改进项目搜索、翻页和勾选响应，保留包含部署密钥、Git 跟踪文件或嵌套仓库的构建目录，明确列出无法检查的候选，非交互清理需要显式传入 --yes。

Clean 保留更多应用状态，清理不完整时说明原因：不再清理日历缓存，新增保留 Final Cut Pro 代理媒体的白名单选项，恢复 macOS 15 上的过期 VS Code 扩展清理，并改善外接卷扫描、超时和废纸篓清理失败提示。

Uninstall 显示熟悉的应用名称，减少对其他应用的影响：按系统语言偏好显示名称并在切换语言后刷新，识别大小写混合的 .app 后缀，卸载时避免重启 Shadowrocket VPN 等无关的活跃扩展。

Analyze 和 Status 的提示更准确：Analyze 删除应用包前会说明支持文件仍会保留，并给出卸载命令，Status 则在刷新失败时把保留的进程数据和告警标记为过期。

命令输出更适合终端和脚本：Analyze 和 Status 提供专门的帮助说明，错误信息写入 stderr，重定向输出不带颜色控制码。

安装和更新更早说明问题：安装器在写入文件前检查 macOS 12 或更新版本，并拒绝通过 sudo 运行，Homebrew 更新后可修复指向已移除版本的启动入口。

Thanks

Issue reporters and PR contributors this cycle: @r266-tech · @UncleCatWu · @M-Hassan-Raza · @dare2live · @madsondeluna · @HAOGRE · @tszaks · @md786-dotcom · @YeJe-cpu · @leslieeilsel · @mehmetcansahin · @Tairraos · @felixwluo · @ganwurrt · @bashu · @Xarius86 · @hansnow · @irl231 · @TheViviana.

Mole Mac App

Prefer a GUI? Mole Mac App brings cleaning, app management, maintenance, disk analysis, and live system status into one native app, with review before deletion and a customizable menu bar HUD. It is $19 once, with lifetime updates and a 14-day refund. Download and try it. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Clean and Purge are faster without widening deletion scope: independent scans now run concurrently, stray home-level artifact folders such as node_modules are no longer mistaken for projects, and live container cache trees stay protected.

Safety probe cancellation now stops the whole cleanup: if a live-cache or SQLite check times out or is interrupted, Mole preserves the current target, stops later cleanup sections, and returns the failure instead of continuing with partial evidence.

Analyze and Status report fresher, clearer system state: Analyze shows the local Time Machine snapshot count and explains why snapshot-only space is excluded from directory totals; Status adds zombie process diagnostics and retains the last process sample as stale when a refresh fails.

Everyday edges are quieter and clearer: CLT-only Macs no longer warn about a missing simctl, compressed menus keep the Space key hint, whitelist guidance accepts any path, and the x/text security update is included.

更新日志

Clean 和 Purge 更快，但不会扩大删除范围：互不依赖的扫描现在可以并发执行；用户目录下误放的 node_modules 等构建产物不会再被当成项目；正在使用的容器缓存目录也会继续受到保护。

安全探测被取消时会停止整次清理：如果活跃缓存或 SQLite 检查超时、被中断，Mole 会保留当前目标，停止后续清理阶段，并返回失败，不会依据不完整证据继续执行。

Analyze 和 Status 展示的系统状态更及时、更清楚：Analyze 会显示本地 Time Machine 快照数量，并说明为何目录统计不包含仅由快照占用的空间；Status 新增僵尸进程诊断，完整刷新失败时会保留上一份进程数据并标记为过期。

日常使用中的细节更安静、更明确：仅安装 Command Line Tools 的 Mac 不再提示缺少 simctl，紧凑菜单会保留 Space 键提示，白名单说明支持任意路径，同时包含 x/text 安全更新。

Thanks

Issue reporters and PR contributors this cycle: @r266-tech · @M-Hassan-Raza · @anupamme · @devcsb · @TyceHerrman · @ilhanpaksoy · @mitchmalone · @grevgeny · @Veritas-7.

Mole Mac App

Prefer a GUI? Mole Mac App brings cleaning, app management, maintenance, disk analysis, and live system status into one native app, with review before deletion and a customizable menu bar HUD. It is $19 once, with lifetime updates and a 14-day refund. Download and try it. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Uninstall keeps shared developer state safe: app names can no longer turn ~/.local, ~/.config, or ~/.cache into leftovers, and the final delete path protects those roots too.

Autodesk Fusion cleanup reclaims old app bundles: mo clean removes only verified older Fusion bundles, keeps the current and newer versions, and pauses when Fusion or its updater may be active.

Orphan service cleanup keeps working helpers online: Mole no longer unloads a registration before a refused removal, and it preserves standalone helper apps and helpers still referenced by a surviving plist.

Stale SQLite sidecars no longer block cleanup: an idle -shm file left after a crash no longer looks like a live database, while live or inconclusive database families stay protected.

Installation and command guidance are clearer: the README now uses real command output, documents the no-admin ~/.local/bin path, and explains that the legacy latest token installs unreleased main code.

更新日志

卸载会保护共享的开发工具数据：应用名称不会再把 /.local、/.config 或 ~/.cache 识别成残留，最终删除入口也会保护这些根目录。

Autodesk Fusion 清理可以释放旧版本空间：mo clean 只会删除经过确认的旧版 Fusion 应用包，当前版本和更新版本都会保留，Fusion 或更新程序可能仍然在运行时也会暂停清理。

孤立服务清理不会再让正常的辅助程序离线：删除被拒绝前不会卸载注册，独立辅助应用和仍被现有 plist 引用的辅助程序也会保留。

残留的 SQLite 边车文件不会再阻止清理：异常退出留下的空闲 -shm 文件不会再被当成正在使用的数据库，确实活跃或无法确认的数据库组仍会受到保护。

安装和命令说明更清楚：README 换成了真实命令输出，补充了无需管理员权限的 ~/.local/bin 安装方式，也说明旧的 latest 参数实际会安装尚未发布的 main 代码。

Thanks

Issue reporters and PR contributors this cycle: @ennioVisco · @andynormancx · @Frankw618 · @buiducnhat · @tommyent · @nathankim0.

Mole Mac App

Prefer a GUI? Mole Mac App brings cleaning, app management, maintenance, disk analysis, and live system status into one native app, with review before deletion and a customizable menu bar HUD. It is $19 once, with lifetime updates and a 14-day refund. Download and try it. The CLI stays free and open source.

Windows System Maintenance Toolkit (Prerelease)

Download: mole-1.30.0-x64.zip (portable) or .exe (launcher)

TUI assets: analyze-windows-x64.exe and status-windows-x64.exe

Install:

Expand-Archive mole-1.30.0-x64.zip -DestinationPath C:\mole
cd C:\mole
.\install.ps1

These assets are prerelease-only and do not affect the macOS stable release channel.

Verify: Check SHA256SUMS.txt for file integrity.

What's Changed

fix(windows): update hardcoded version fallback to 1.29.1 by @pranahonk in #636

Full Changelog: v1.29.1-windows...v1.30.0-windows

Mole

Deep clean and optimize your Mac.

Changelog

mo clean keeps dependency and model state intact: downloaded dependencies, model weights, Poetry virtual environments, Deno state, and sensitive macOS caches stay in place, while large stores remain visible for review.

Developer caches are covered more precisely: GitHub CLI, PyInstaller, Clang, Poetry, Go, and Cargo cleanup now follows each tool's real cache boundary instead of deleting whole stores by name.

Canceled disk scans stay canceled: leaving or refreshing mo analyze stops recursive work and prevents stale results from returning, and the overview now includes uv cache space.

Uninstall sizes are more honest: Mole reports physical disk usage, and Steam launchers show N/A (Steam-managed) instead of presenting a shortcut as the game.

Project cleanup is safer and easier to review: mo purge loads saved whitelist rules before scanning, keeps each project's artifacts together, orders projects by reclaimable size, lets X skip one exact project, and never turns incomplete or replaced scan roots into deletion candidates.

Homebrew Cask uninstall works on macOS Bash 3.2: app listing no longer stops early, so Cask apps continue through Homebrew's own uninstall flow.

mo status understands M5 core layouts: performance and efficiency core counts stay accurate even when Apple uses different performance-level names.

更新日志

mo clean 会保留依赖和模型数据：下载的依赖、模型权重、Poetry 虚拟环境、Deno 状态和敏感的 macOS 缓存都会保留，大目录仍会列出来供你检查。

开发者缓存清得更准确：GitHub CLI、PyInstaller、Clang、Poetry、Go 和 Cargo 现在都按各自工具的真实缓存边界清理，不再因为目录名称像缓存就删除整个存储区。

取消的磁盘扫描不会再回来：离开或刷新 mo analyze 后，递归扫描会真正停止，旧结果不会稍后覆盖当前界面，总览也会显示 uv 缓存空间。

卸载大小更真实：Mole 会按实际磁盘占用计算，Steam 启动器则显示 N/A (Steam-managed)，不再把快捷方式大小当成整个游戏。

项目清理更安全，也更容易确认：mo purge 会在扫描前加载白名单，把同一项目的构建产物放在一起，按可释放空间排列，也可以按 X 跳过当前项目，未完成或被替换的扫描根不会进入删除。

Homebrew Cask 卸载兼容 macOS 自带的 Bash 3.2：应用列表不会中途结束，Cask 应用也会继续交给 Homebrew 自己卸载。

mo status 能识别 M5 的核心布局：即使 Apple 使用不同的性能层级名称，性能核和能效核数量也能正确显示。

Thanks

Issue reporters and PR contributors this cycle: @JayanAXHF · @doroved · @kael-wanderer · @baddate · @tkalpdev · @barkleesanders · @M-Hassan-Raza · @hugovk · @Yuxin-Qiao · @buiducnhat · @jiji262.

Mole Mac App

Mole Mac is the same work in a window: cleaning, uninstall leftovers, a treemap view of the disk, and live system readings in the menu bar. It shows you every file before it deletes anything. The CLI stays free and open source.

想要图形界面可以看看 Mole Mac，清理、卸载残留、磁盘树状图和菜单栏实时监控都在里面，删任何东西之前都会先让你看到具体是哪些文件。命令行版本继续免费开源。

Mole

Deep clean and optimize your Mac.

Changelog

mo clean leaves open apps alone: an app's cache is skipped while that app is still running or still writing to it, so cleaning never touches data something is using.

mo clean no longer stops halfway: a folder too big to measure or delete in time is skipped on its own, the rest of the cleanup still runs, and the summary tells you the freed number came out low.

App leftovers finishes quickly: it used to sit on a scan that could take a minute and then report a row of failures, on a machine where it had never actually been able to remove anything.

mo uninstall picks the right app more often: names like Tor Browser are matched as one app instead of two words, so an unrelated app is no longer caught by a single word.

mo uninstall finishes on busy machines: with a lot of software installed the scan used to run out of time and report that nothing was removed; now it removes the app and leaves the leftovers.

Developer caches are cleaned more thoroughly: several pnpm versions at once, Rust directories moved somewhere custom, Codex update files, and Gradle are all covered now.

mo status shows purgeable space: this is the space Finder already counts as free, and the reason Finder and df never agree on how much you have left.

mo optimize says what it skipped: databases too large to compact are listed by name and size, instead of being counted as already optimized.

Updating asks for your password once: no second prompt halfway through the install.

更新日志

mo clean 不动正在使用的应用：应用还开着或还在写入时，它的缓存会被跳过，清理不会碰到正被使用的数据。

mo clean 不会清到一半就停：某个目录太大、来不及测也来不及删，就单独跳过它，后面的清理照常进行，摘要里也会告诉你这次释放的数字偏小。

App leftovers 很快就能跑完：过去这一步可能卡上一分钟，然后报一串失败，而它在这台机器上其实从来就删不掉任何东西。

mo uninstall 更少认错应用：Tor Browser 这类名字按一个应用匹配，不再拆成两个词，避免某个词命中了别的应用。

mo uninstall 在软件多的机器上也能跑完：以前扫描会超时，然后报告什么都没删；现在会把应用删掉，只留下残留文件。

开发者缓存清得更干净：同时装了多个 pnpm 版本、Rust 目录被挪到别处、Codex 的更新文件和 Gradle，现在都覆盖到了。

mo status 显示可清除空间：这部分空间 Finder 已经算作可用，也是 Finder 和 df 永远对不上的原因。

mo optimize 会说明跳过了什么：太大压不动的数据库会按名字和大小列出来，不再算作已优化。

更新只问一次密码：不会装到一半再弹一次。

Thanks

Issue reporters and PR contributors this cycle: @Yuxin-Qiao · @TyceHerrman · @Rrrripp · @quangdog · @toyo2333 · @missaq · @tashicorp · @AnyGong · @dmt0 · @int3g · @david-dacs.

Mole Mac App

Mole Mac is the same work in a window: cleaning, uninstall leftovers, a treemap view of the disk, and live system readings in the menu bar. It shows you every file before it deletes anything. The CLI stays free and open source.

想要图形界面可以看看 Mole Mac，清理、卸载残留、磁盘树状图和菜单栏实时监控都在里面，删任何东西之前都会先让你看到具体是哪些文件。命令行版本继续免费开源。

Mole

Deep clean and optimize your Mac.

Changelog

Install and update work on macOS 12 to 14 again: the update lock relied on a system tool that only newer macOS ships; where it is absent Mole now falls back to an equally safe lock directory.

mo uninstall no longer exits silently: unreadable bundles, id-less launchers, unreadable volumes, and out-of-time scans now narrow the plan and keep going, remaining refusals print their reason, the spinner starts right after you confirm, and pressing q stays a quiet cancel.

Uninstall finds renamed data directories: apps whose bundle id extends their display name, like AyuGram writing to "AyuGram Desktop", now have those exact directories cleaned too, under strict evidence so one app can never reach another's data.

mo clean finishes instead of vanishing: a cancelled run prints a summary with the reason, a Mail Downloads folder that cannot be sized is skipped as one item, and one unreadable app no longer skips the whole leftovers section.

mo update asks once and stays predictable: the admin session no longer lapses into a second authentication prompt mid-install, and the git fallback runs only on explicit updates.

Removing Mole keeps your settings recoverable: mo remove now moves ~/.config/mole, including your whitelist, to the Trash instead of deleting it permanently.

Install explains itself and shows progress: a refused install names the failing check and the fixing command, and binary verification shows a spinner instead of a silent wait.

更新日志

macOS 12 到 14 上安装和更新恢复正常：更新锁依赖的系统工具只有较新的 macOS 才带，缺失时 Mole 现在退回到同样安全的锁目录。

mo uninstall 不再静默退出：不可读的应用包、无 id 的启动器、不可读的磁盘卷、超时的扫描都会收窄计划继续执行，仍需拒绝的会说明原因，确认后进度动画立即出现，按 q 依旧是安静取消。

卸载能找到改名的数据目录：像 AyuGram 把数据写在 "AyuGram Desktop" 这类 bundle id 延伸自显示名的应用，对应目录现在也会被清理；推导只认严格证据，一个应用永远碰不到另一个应用的数据。

mo clean 能跑完而不是消失：被取消的运行会打印带原因的摘要，无法测量大小的 Mail Downloads 目录会作为单项跳过，单个不可读应用不再导致整节残留扫描被跳过。

mo update 只问一次且更可预期：管理员会话不会在安装中途失效再弹一次认证，git 回退也只在显式更新时使用。

移除 Mole 时设置可以找回：mo remove 现在把 ~/.config/mole（包括白名单）移入废纸篓，而不是永久删除。

安装过程解释自己并显示进度：被拒绝的安装会指出没过的检查和修复命令，二进制校验期间有加载动画而不是静默等待。

Thanks

Issue reporters and PR contributors this cycle: @Yuxin-Qiao · @r266-tech · @rriegman · @brun04maral · @gcosta74 · @nickdos · @dmt0 · @bashu · @zlxrnn · @iammike2 · @schn00x.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

If V1.49.0 blocked you

V1.49.0 could refuse an install or update while reporting only a busy lock, with no reason and no way forward. In V1.49.1 the message names the cause and prints the command that fixes it.

Reinstall with curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash. If mo update needs admin rights, run it in a real terminal, or run sudo -v && mo update first.

Changelog

Install and update refusals explain themselves: the installation lock now separates an untrusted parent directory, an unusable lock directory, a lock path replaced by a symlink or device, a missing admin session, and a real concurrent writer. Each names the directory at fault and prints the command that fixes it.

A lapsed admin session no longer fails an install: when credentials expire between authentication and the privileged step, Mole asks once through the terminal and continues, and stops cleanly where there is no terminal to ask on.

mo update stops before a privileged install it cannot finish: when the admin session cannot reach the installer child process, it says so up front instead of failing partway through.

mo update --nightly no longer reinstalls on every run: when the commit API is unavailable it falls back to a bounded, non-interactive lookup, and refuses an unforced reinstall while the latest commit stays unresolved.

Updates recover safely: mo update can repair a broken local updater, keeps concurrent installs separate, pins nightly source installs, and verifies the exact installed version or commit before reporting success.

Clean no longer appears stuck: long filesystem, metadata, and developer-cache scans now share firm deadlines. A timed-out scan discards partial results and stops later cleanup safely.

Dry run really stays dry: MOLE_DRY_RUN=1 now enables the complete preview path, including Trash and system sections, without removing files.

Cleanup boundaries are stricter: Mole protects active PowerLog data, macOS update staging, security-agent caches, compiled model caches, and live logs, with fresh checks at deletion time.

Uninstall is safer: same-bundle apps on local disks and mounted volume roots keep shared services and leftovers intact. Size timeouts now stop before discovery, teardown, or deletion.

Developer cleanup is more reliable: Xcode and Simulator activity checks are more accurate, and versioned Claude, Copilot, and other agent inventories reject partial or stale scan results.

Optimize reports real outcomes: every task records changed, attention, skipped, or failed state consistently in the final summary, exit status, and history.

Status is clearer: the two-column layout is better balanced, battery health keeps its published capacity, and tunnel interfaces are no longer mislabeled as proxies.

Analyze finds more storage: Parallels virtual machine data is now included in disk analysis.

更新日志

安装和更新的拒绝会说明自己：安装锁现在区分上级目录不可信、锁目录不可用、锁文件被换成软链或设备、管理员会话缺失、真的有并发写入五种情况，各自指出具体目录并给出对应的修复命令。

管理员会话过期不再让安装失败：如果凭据在认证之后、特权步骤之前失效，Mole 会通过终端再问一次然后继续；没有终端可问时干净地停下。

mo update 在做不完的特权安装之前就停下：当管理员会话无法传递给安装器子进程时，它会提前说明，而不是走到一半失败。

mo update --nightly 不再每次都重装：提交接口不可用时会退到有时限的非交互查询，在最新提交仍然无法解析时拒绝未强制的重装。

更新可以安全自愈：mo update 可以修复损坏的本地更新器，隔离并发安装，锁定 nightly 源码版本，并在成功前核验实际安装的版本或提交。

clean 不再像卡死：耗时的文件系统、元数据和开发者缓存扫描现在都有统一时限；扫描超时会丢弃不完整结果，并安全停止后续清理。

dry-run 真正只预览：MOLE_DRY_RUN=1 现在会启用完整预览流程，包括废纸篓和系统清理部分，不会删除文件。

清理边界更严格：Mole 会保护正在使用的 PowerLog 数据、macOS 更新暂存目录、安全软件缓存、编译模型缓存和实时日志，并在删除前再次确认状态。

卸载更安全：本地磁盘和挂载卷根目录中具有相同 Bundle ID 的应用会保留共享服务与残留；大小探测超时会在发现、停用服务或删除之前停止。

开发者清理更可靠：Xcode 和 Simulator 活动判断更准确，Claude、Copilot 等工具的版本清单也会拒绝不完整或过期的扫描结果。

optimize 如实报告结果：每个任务的已修改、需关注、已跳过或失败状态都会一致反映在最终摘要、退出状态和历史记录中。

status 更清晰：双栏布局更均衡，电池健康会保留已公布容量，隧道接口也不会再被误报为代理。

analyze 能发现更多空间：磁盘分析现在会包含 Parallels 虚拟机数据。

Thanks

Thanks to @gloiiire, @Lyleton, @iTofu, @M-Hassan-Raza, @QuakeWang, @r266-tech, and @iammike2 for their contributions and reports, and to everyone who tested Mole and reported edge cases.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Updates recover safely: mo update can repair a broken local updater, keeps concurrent installs separate, pins nightly source installs, and verifies the exact installed version or commit before reporting success.

Clean no longer appears stuck: long filesystem, metadata, and developer-cache scans now share firm deadlines. A timed-out scan discards partial results and stops later cleanup safely.

Dry run really stays dry: MOLE_DRY_RUN=1 now enables the complete preview path, including Trash and system sections, without removing files.

Cleanup boundaries are stricter: Mole protects active PowerLog data, macOS update staging, security-agent caches, compiled model caches, and live logs, with fresh checks at deletion time.

Uninstall is safer: same-bundle apps on local disks and mounted volume roots keep shared services and leftovers intact. Size timeouts now stop before discovery, teardown, or deletion.

Developer cleanup is more reliable: Xcode and Simulator activity checks are more accurate, and versioned Claude, Copilot, and other agent inventories reject partial or stale scan results.

Optimize reports real outcomes: every task records changed, attention, skipped, or failed state consistently in the final summary, exit status, and history.

Status is clearer: the two-column layout is better balanced, battery health keeps its published capacity, and tunnel interfaces are no longer mislabeled as proxies.

Analyze finds more storage: Parallels virtual machine data is now included in disk analysis.

更新日志

更新可以安全自愈：mo update 可以修复损坏的本地更新器，隔离并发安装，锁定 nightly 源码版本，并在成功前核验实际安装的版本或提交。

clean 不再像卡死：耗时的文件系统、元数据和开发者缓存扫描现在都有统一时限；扫描超时会丢弃不完整结果，并安全停止后续清理。

dry-run 真正只预览：MOLE_DRY_RUN=1 现在会启用完整预览流程，包括废纸篓和系统清理部分，不会删除文件。

清理边界更严格：Mole 会保护正在使用的 PowerLog 数据、macOS 更新暂存目录、安全软件缓存、编译模型缓存和实时日志，并在删除前再次确认状态。

卸载更安全：本地磁盘和挂载卷根目录中具有相同 Bundle ID 的应用会保留共享服务与残留；大小探测超时会在发现、停用服务或删除之前停止。

开发者清理更可靠：Xcode 和 Simulator 活动判断更准确，Claude、Copilot 等工具的版本清单也会拒绝不完整或过期的扫描结果。

optimize 如实报告结果：每个任务的已修改、需关注、已跳过或失败状态都会一致反映在最终摘要、退出状态和历史记录中。

status 更清晰：双栏布局更均衡，电池健康会保留已公布容量，隧道接口也不会再被误报为代理。

analyze 能发现更多空间：磁盘分析现在会包含 Parallels 虚拟机数据。

Thanks

Thanks to @gloiiire, @Lyleton, @iTofu, @M-Hassan-Raza, @QuakeWang, and @r266-tech for their contributions, and to everyone who tested Mole and reported edge cases.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

More reliable updates: mo update now retries temporary network failures and shows a clear error instead of exiting silently.

Safer file removal: files that need extra permissions move through a protected Trash path, and failed moves keep a recovery location.

Analyze works over SSH: files can move to Trash without Finder, and partial deletions update the list correctly.

Safer cleanup rules: Mole leaves macOS update files alone and skips app caches when their status is uncertain.

Fewer terminal hangs: background cleanup no longer takes over terminal input, and timed tasks clean up their child processes.

Status settings stay intact: concurrent mo status sessions no longer overwrite each other's preferences.

更新日志

更新更稳定：mo update 遇到临时网络故障会自动重试，失败时也会明确提示，不再直接退出。

文件删除更安全：需要权限的文件会通过受保护的路径移入废纸篓，移动失败时会保留恢复位置。

analyze 支持 SSH 删除：不依赖 Finder 也能把文件移入废纸篓，部分删除失败时列表也会正确更新。

清理规则更稳妥：Mole 不再清理 macOS 更新文件，无法确认状态的应用缓存也会跳过。

减少终端卡住问题：后台清理不会再抢占终端输入，限时任务结束时也会清理子进程。

status 设置不会互相覆盖：同时运行多个 mo status 时，各自保存的偏好不会丢失。

Thanks

Thanks to everyone who tested V1.48.0 and shared feedback.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Clean tells you what each category freed: every section closes with its own reclaimed total, so a long run reads as a summary instead of a wall of rows.

Cleanup reaches more real leftovers: JianyingPro generated caches, aborted idleassetsd aerial downloads that quietly fill /private/var/folders, Zed's bundled and versioned npm caches, and Dia rows retargeted at the Chromium caches that actually hold the data.

A staged macOS update is left alone: cleanup asks Software Update whether anything is queued before touching macOS Install Data, and judges age by the newest write inside the folder, not the folder's own timestamp.

Deleting from analyze works over SSH: removals go through trash(8) instead of a Finder dialog a remote session cannot answer, so a delete finishes rather than timing out.

Cleanup keeps more of what you still need: Homebrew's api and bootsnap caches survive so brew responds right away next run, and compiled model caches, nested E5RT bundles, and imported JianyingPro material count as your data.

mo status reports what the machine actually says: metrics run in a fixed locale for comma decimal systems, SMART status follows the current format, and the CPU card shows the core count you set.

purge checks with you before cloud-backed folders: candidates inside iCloud Drive or a CloudStorage provider need a confirmation first, and a scripted run skips them and reports how many it held back.

Failures explain themselves: a Homebrew upgrade error keeps brew's own diagnostic, uninstall names the system files it could not remove, and the Legacy Overrides step in optimize can be whitelisted like any other task.

更新日志

clean 会报出每一类清了多少：每段结束时给出本类回收的总量，长时间清理读起来是一份汇总，而不是一屏明细。

清理覆盖到更多真实残留：剪映生成缓存、悄悄占满 /private/var/folders 的 idleassetsd 中断航拍下载、Zed 内置与带版本号的 npm 缓存，以及重新指向真正存放数据的 Chromium 缓存的 Dia 条目。

已暂存的 macOS 更新不会被动：清理 macOS Install Data 前会先问系统更新有没有排队中的更新，判断新旧时看的是文件夹内部最新的写入时间，而不是文件夹自己的时间戳。

analyze 的删除在 SSH 下可用：删除改走 trash(8)，不再依赖远程会话无法应答的 Finder 弹窗，于是删除会真正完成而不是超时。

清理保留更多你还需要的东西：Homebrew 的 api 与 bootsnap 缓存会留下，下次 brew 命令立刻有响应；已编译模型缓存、嵌套 E5RT 包、导入剪映的素材都算你的数据。

mo status 如实反映机器状态：指标固定 locale，逗号小数地区读数正确；SMART 状态跟上当前格式；CPU 卡片按你设定的核数显示。

purge 处理云端目录前先征询你：iCloud 云盘或 CloudStorage 下的候选项需要先确认，脚本化运行则跳过并报出压下了多少项。

失败会自己说明原因：Homebrew 升级出错保留 brew 自己的诊断，卸载会点名它没能删掉的系统文件，optimize 的历史遗留项审计可以像其他任务一样加进白名单。

Thanks

Issue reporters and PR contributors this cycle: @M-Hassan-Raza · @italojs · @alxhill · @YeJe-cpu · @z0ffy · @tylergibbs1 · @hhh2210 · @gloiiire · @rick-yao.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Uninstall no longer freezes at prompts: background scan workers could steal the terminal and suspend mo uninstall before or after a removal; three layered fixes keep the prompt in the foreground on every shell.

Accurate CPU numbers on Apple Silicon: mo status no longer reads parked efficiency cores as 90-100% busy or measures its own startup burst, so totals now track top instead of running 30+ points high.

New Legacy Overrides step in optimize: detects hidden App Nap and disk-image verification overrides left by old tweak utilities, and removes only the override key so macOS defaults apply again.

Cleanup covers more developer leftovers: guarded Codex Desktop update staging and Tart VM caches, Terragrunt caches in purge, and stale Edge updater payloads older than your installed Edge.

Install integrity is now fail-closed: a failed checksum or attestation aborts the install instead of silently downgrading to an unverified source build, and delete-path validation now resolves ancestor symlinks before deciding.

Cleanup reports what it actually did: item counts match what was cleaned, sub-megabyte amounts show as KB instead of 0MB, and Gemini CLI chat checkpoints are never treated as temp files.

Smoother terminal experience: gg jump-to-top works on stock macOS bash, optimize renders correctly under comma-decimal locales, and the health score no longer rises as load gets worse.

更新日志

卸载不再卡死在提示符：后台扫描进程可能抢走终端，让 mo uninstall 在删除前后被挂起；三层修复让提示始终保持在前台，各种 shell 下都不再冻结。

Apple Silicon 上 CPU 数字准了：mo status 不再把休眠的能效核读成 90-100%，也不再把自身启动负载测进去，总占用与 top 一致，不再虚高 30 多个点。

optimize 新增历史遗留项审计：检测老优化工具留下的 App Nap 全局开关和磁盘镜像跳过校验设置，只删覆盖键本身，让系统回到默认行为。

清理覆盖更多开发者残留：受保护的 Codex Desktop 更新暂存和 Tart 虚拟机缓存、purge 支持 Terragrunt 缓存、清除比已装 Edge 更旧的更新器残留。

安装校验改为失败即中止：校验不通过时直接停止安装，不再静默降级到未经验证的源码构建；删除路径校验现在会先解析上级软链再判定。

清理结果如实汇报：条目数与实际清理一致，小于 1MB 的清理量以 KB 显示而不是 0MB，Gemini CLI 对话检查点永远不会被当作临时文件清掉。

终端体验更顺：gg 跳转到顶部在系统自带 bash 上恢复可用，逗号小数 locale 下 optimize 正常渲染，健康分不会再随负载升高反而变好。

Thanks

Issue reporters and PR contributors this cycle: @sownhere · @LuisMIguelFurlanettoSousa · @ebbsanchez · @Carsonn-Liu · @oichtental · @XDavidT · @feux-follets · @niyongsheng · @pingshunhuangalex · @TyceHerrman.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

Homebrew cleanup keeps your tools working: brew cleanup could drop active executable links, so Mole now snapshots them first and restores any that cleanup removed while their formula is still installed.

Cleanup leaves in-use app data alone: legacy LM Studio data and Raycast X (v2) files are preserved when cleaning or uninstalling their older siblings.

No more hung prompts or broken terminals: interactive commands keep the foreground so nested sudo reads no longer stall, and the terminal is restored after you cancel an uninstall.

Updates repair themselves: an interrupted helper download no longer leaves a broken analyzer that still reports you are current; the next update stages and repairs it.

Steadier analyze and status views: stabler analyze output, clearer status header specs, no spinner or section flicker, and clearer dry-run summaries.

purge honors scan roots outside home: artifacts under configured roots such as /var/www can now be removed, with the existing depth and out-of-root safety checks intact.

更新日志

Homebrew 清理不再弄坏命令行工具：brew cleanup 可能删掉仍在用的可执行软链，Mole 现在先做快照，清理后自动恢复那些 formula 仍在、却被误删的链接。

清理时不动仍在使用的应用数据：清理或卸载旧版本时，保留 LM Studio 旧数据和 Raycast X（v2）文件。

不再卡在提示或留下坏终端：交互命令保持前台，嵌套 sudo 输入不再卡住，取消卸载后终端会被复原。

更新能自我修复：中断的辅助程序下载不会再留下损坏的分析器并谎报“已是最新”，下次更新会重新暂存并修好。

analyze 和 status 显示更稳：analyze 输出更稳定，status 头部规格更清晰，消除 spinner 和分区闪烁，dry-run 摘要更明确。

purge 支持 home 以外的扫描根目录：/var/www 等配置根目录下的构建产物现在能真正被清除，同时保留原有的深度和越界安全校验。

Thanks

Issue reporters and PR contributors this cycle: @adilrc.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.

Mole

Deep clean and optimize your Mac.

Changelog

mo clean: Redesigned the output: every row follows one "label · detail" grammar, paths with spaces are clickable in the terminal, idle sections stay silent, and duplicate or advisory rows are gone.

mo clean: A failed probe can no longer delete your files: a Spotlight stall, an unreadable Time Machine status, or a missing mount list now keeps data in place instead of treating live apps as orphans, which also fixes the Intego breakage.

mo clean: The user whitelist now covers direct removals such as Xcode DerivedData, Edge and Brave staged updates survive version cleanup, and the deletion validator rejects Homebrew roots and bare top-level paths.

mo uninstall: Side-by-side installs sharing one bundle id, like Xcode-beta next to Xcode, are kept safe, Karabiner-Elements can be uninstalled, and login item helpers are booted out without the sfltool password dialog.

mo clean: New cleanup coverage for LM Studio caches, Chrome on-device model stores, stale JetBrains version directories, and Handoff clipboard staging.

Performance: Privileged file sweeps batch into a single rm so large log archives clean in seconds instead of minutes, and preference repair plus the Spotlight probe now run under strict time budgets.

更新日志

mo clean：清理输出重新梳理了一遍，每行统一成「对象 · 详情」的格式，带空格的路径在终端里可以直接点开，没东西可清的分组不再刷屏，重复和啰嗦的提示都拿掉了。

mo clean：修掉几处误删的风险，Spotlight 卡住、Time Machine 状态读不到、磁盘列表拿不到时都会保留文件，不再把正在用的应用当成残留清掉，Intego 被误伤的问题也一并修复。

mo clean：白名单对 Xcode DerivedData 这类直接删除的路径也生效了，Edge 和 Brave 已下载好的更新包不会被误清，Homebrew 根目录和裸的顶层路径会被直接拦下。

mo uninstall：同一个 bundle id 装了两份时（比如 Xcode 和 Xcode-beta）会识别出来并保护好另一份，Karabiner-Elements 可以正常卸载了，卸载时登录项后台任务直接注销，不再弹 sfltool 密码框。

mo clean：新增 LM Studio 缓存、Chrome 本地模型、JetBrains 旧版本目录和 Handoff 剪贴板暂存文件的清理。

性能：需要管理员权限的文件清扫合并成一次批量删除，清大体积日志归档从几分钟降到几秒，偏好设置修复和 Spotlight 检测也都加了时间上限。

Thanks

Issue reporters and PR contributors this cycle: @hhh2210 · @mickaphd · @xqzhou · @nazocthun · @alexei-led · @hemanth1986.

Mole Mac App

Prefer a GUI? Try Mole Mac App. The CLI stays free and open source.