Mole

Deep clean and optimize your Mac.

Changelog

1. Choose which app data to remove: mo uninstall keeps personal data by default, including for Homebrew apps, lets you select exact paths with D before confirming, skips sizing data you keep, and points out configuration files that still reference a removed app without changing them.
2. Find more app leftovers: Uninstall now recognizes PlayCover iOS apps and their launchers, finds Claude Desktop's third-party-provider folders and more app-specific crash caches, and no longer mistakes staged updates for installed copies or unmounted backup folders for unreadable disks.
3. Clean old developer files: Clean now covers unused old Codex daemon releases, stale Homebrew service logs, Apple TV firmware and older visionOS DeviceSupport files, while a Codex marketplace backlog appears as one row instead of repeating for every folder.
4. Keep media and shared app data: Automatic cleaning preserves Final Cut Pro generated media, Jianying rendered footage, Spotify offline music and current wallpaper renders, while uninstall protects shared Unity and Epic folders, neighboring IDE data, Raycast clipboard images and Mullvad Browser profiles, and avoids stopping unrelated Electron apps or cleaning protected security agents.
5. Report disk space more accurately: Analyze counts fully shared APFS clones once during file-by-file scans and keeps equal-size rows in a consistent order, though fast folder estimates can still overcount shared blocks, and uninstall no longer counts containers macOS refused to remove as freed space.
6. Leave cloud-only folders online: mo purge skips online-only cloud folders when macOS can identify them, avoiding downloads just to look for build files and preventing those folders from consuming the whole scan budget.
7. Keep passwords hidden and cancellation responsive: Passwords typed while waiting for Touch ID no longer appear on screen, and uninstall and selection menus now stop correctly on interruption, including terminals where spinner shutdown previously hung.
8. Stop when exclusions cannot be read: Clean, purge and optimize stop when your whitelist cannot be read or its location cannot be checked, rather than proceeding without the paths you protected.
9. Improve system checks: Status recovers battery temperature from the battery pack when the usual reading is missing and bounds battery queries, while optimize supports newer recent-item lists, checks the correct launch-agent executable and avoids repeating DNS and Spotlight checks.
10. Finish updates and identify development builds: Updates to custom install folders no longer stop after copying files, macOS installs ignore Windows release tags, failed downloads name the network problem, and mo --version shows the commit of a Homebrew HEAD build.
11. Use your own nixpkgs: Nix users can import the Mole package or overlay into their configuration, and documentation or test changes no longer force the package to rebuild.
12. Read the guide in more languages: The README now includes Russian and Ukrainian translations, clearer macOS and Windows entry points, and the official download sources.

更新日志

1. 卸载时自己选择要删的数据：mo uninstall 默认保留个人数据，Homebrew 安装的 App 也一样，确认前按 D 选择要删除的具体路径，保留的数据不再反复计算大小，卸载后还会指出哪些配置文件仍引用这个 App，但不会修改配置。
2. 识别更多 App 和残留文件：卸载现在能识别 PlayCover 安装的 iOS App 和启动器，找到 Claude Desktop 第三方服务配置目录及更多 App 崩溃缓存，也不会再把更新暂存副本当成另一份安装，或把未挂载的备份目录当成无法读取的磁盘。
3. 清理更多开发工具旧文件：新增清理不再使用的 Codex 后台程序旧版本、过期 Homebrew 服务日志、Apple TV 固件和旧版 visionOS DeviceSupport，积压的 Codex 插件更新暂存文件也合成一行，不再逐个重复显示。
4. 保留媒体和共用的 App 数据：自动清理会保留 Final Cut Pro 生成媒体、剪映渲染素材、Spotify 离线音乐和当前壁纸，卸载时也会保护 Unity、Epic 的共享目录、其他 IDE 的数据、Raycast 剪贴板图片和 Mullvad Browser 配置，并避免退出无关的 Electron App 或清理受保护的安全软件服务。
5. 空间统计更准确：Analyze 逐文件扫描时会对完全共享数据块的 APFS 克隆文件去重，同样大小的条目保持固定顺序，但快速目录估算仍可能重复计算共享块，卸载时也不再把 macOS 拒绝删除的容器计入已清理空间。
6. 云端文件不再为扫描而下载：macOS 能识别仅在线文件夹时，mo purge 会跳过这些目录，不再为了查找构建文件触发下载，也不会让它们占满扫描时间。
7. 密码不显示，取消能退出：等待 Touch ID 时输入的密码不再显示在终端里，卸载和选择菜单也能正确响应中断，修复了部分终端里停止 loading 时卡住的问题。
8. 白名单读不到就停止清理：clean、purge 和 optimize 无法读取白名单或检查其所在路径时会停止，不再漏掉你保护的路径后继续清理。
9. 系统检查更准确：Status 在常规温度读数缺失时会读取电池组数据，并限制电池查询的等待时间，optimize 则支持新版最近使用列表、正确检查启动代理程序，不再重复运行 DNS 和 Spotlight 检查。
10. 更新能完成，开发版能区分：自定义安装目录的更新不再复制完文件就中断，macOS 安装会排除 Windows 版本标签，下载失败会说明网络原因，mo --version 也会显示 Homebrew HEAD 构建的提交标识。
11. Nix 可接入自己的配置：Nix 用户可以直接导入 Mole 包或 overlay，文档和测试改动也不再触发软件包重新构建。
12. 增加两种语言的使用说明：README 新增俄语和乌克兰语版本，补齐 macOS、Windows 入口和官方下载来源。

Thanks

Issue reporters and PR contributors this cycle: @Shramkoweb · @tfc · @viniciusdsandrade · @kirinraw · @r266-tech · @danpalmer · @mlsimon734 · @Imyukehan · @divemasterza · @nicodiferd · @r26gray · @xuanzhangx.

Mole Mac App

If you would rather work in a window than a terminal, Mole Mac App covers cleaning, app removal, maintenance, disk analysis and live status, shows everything before it deletes, and adds tools in the menu bar. It costs $19 once, with free updates and a 14-day refund, and you can download it here. The CLI stays free and open source.