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

1. 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.
2. 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.
3. 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.
4. 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.
5. 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.
6. 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.
7. Dry run really stays dry: MOLE_DRY_RUN=1 now enables the complete preview path, including Trash and system sections, without removing files.
8. 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.
9. 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.
10. 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.
11. Optimize reports real outcomes: every task records changed, attention, skipped, or failed state consistently in the final summary, exit status, and history.
12. 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.
13. Analyze finds more storage: Parallels virtual machine data is now included in disk analysis.

更新日志

1. 安装和更新的拒绝会说明自己：安装锁现在区分上级目录不可信、锁目录不可用、锁文件被换成软链或设备、管理员会话缺失、真的有并发写入五种情况，各自指出具体目录并给出对应的修复命令。
2. 管理员会话过期不再让安装失败：如果凭据在认证之后、特权步骤之前失效，Mole 会通过终端再问一次然后继续；没有终端可问时干净地停下。
3. mo update 在做不完的特权安装之前就停下：当管理员会话无法传递给安装器子进程时，它会提前说明，而不是走到一半失败。
4. mo update --nightly 不再每次都重装：提交接口不可用时会退到有时限的非交互查询，在最新提交仍然无法解析时拒绝未强制的重装。
5. 更新可以安全自愈：mo update 可以修复损坏的本地更新器，隔离并发安装，锁定 nightly 源码版本，并在成功前核验实际安装的版本或提交。
6. clean 不再像卡死：耗时的文件系统、元数据和开发者缓存扫描现在都有统一时限；扫描超时会丢弃不完整结果，并安全停止后续清理。
7. dry-run 真正只预览：MOLE_DRY_RUN=1 现在会启用完整预览流程，包括废纸篓和系统清理部分，不会删除文件。
8. 清理边界更严格：Mole 会保护正在使用的 PowerLog 数据、macOS 更新暂存目录、安全软件缓存、编译模型缓存和实时日志，并在删除前再次确认状态。
9. 卸载更安全：本地磁盘和挂载卷根目录中具有相同 Bundle ID 的应用会保留共享服务与残留；大小探测超时会在发现、停用服务或删除之前停止。
10. 开发者清理更可靠：Xcode 和 Simulator 活动判断更准确，Claude、Copilot 等工具的版本清单也会拒绝不完整或过期的扫描结果。
11. optimize 如实报告结果：每个任务的已修改、需关注、已跳过或失败状态都会一致反映在最终摘要、退出状态和历史记录中。
12. status 更清晰：双栏布局更均衡，电池健康会保留已公布容量，隧道接口也不会再被误报为代理。
13. 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.