Mole

Deep clean and optimize your Mac.

Changelog

1. Slim universal apps on Apple Silicon: mo slim removes the Intel code from apps you own, slims each one on a copy that must pass code signing and Gatekeeper checks before it replaces the original, moves the original to the Trash, and needs no developer tools; preview with mo slim --dry-run.
2. Let your AI agent drive Mole: The official Mole skill teaches Claude Code, Codex, Cursor and other agents to preview every cleanup with --dry-run and leave uninstalls and admin steps to you; install it with npx skills add tw93/Mole -a claude-code codex cursor -g -y.
3. Uninstall with personal data selected: mo uninstall --with-data <name> starts with the app's settings and data selected, still lists them in the preview, and D lets you keep any path.
4. Clean more app leftovers: Clean reaches Feishu and its sandboxed caches, WeChat web profiles, idle Helium signing clones and Futu NiuNiu update downloads while Futu is closed.
5. Correct external drive cleanup: mo clean --external reports the space it actually freed, keeps the drive's Trash and protected Finder metadata, and sizes a temporary folder with an unreadable child instead of skipping it.
6. Safer uninstall prompts: Homebrew cask password prompts stay in the foreground, every real uninstall needs an interactive confirmation, a dry run without a terminal ends with its plan, and app names with control characters print safely.
7. No Command Line Tools prompt on update: On a Mac without developer tools, mo update and the installer no longer pop up the Command Line Tools installer, and both fall back to Git release tags when the GitHub API lookup fails.
8. Stop commands that ignore Ctrl-C: A command that ignores the stop signal is now force-stopped two seconds after its time limit, so a stuck step can no longer hang a cleanup or uninstall.
9. Cleaner mo remove: It removes Mole's shell completion lines, keeps your own lines and rc symlinks intact, and exits with an error when no terminal can confirm the removal.
10. Smoother Analyze and Purge: Analyze keeps every entry browsable and refreshes a folder that changed right after its scan, and Purge re-scans a slow container folder one project at a time instead of skipping later artifacts.

更新日志

1. 在 Apple Silicon 上给通用 App 瘦身：mo slim 会删掉你自己装的 App 里的 Intel 代码，每个 App 都先在副本上处理，副本通过代码签名和 Gatekeeper 检查后才替换原 App，原 App 移到废纸篓，整个过程不需要开发者工具，可以先用 mo slim --dry-run 预览。
2. 让 AI Agent 帮你用 Mole：官方 Mole skill 会让 Claude Code、Codex、Cursor 等 Agent 每次清理前先用 --dry-run 预览，卸载 App 和需要管理员权限的步骤留给你自己来，安装命令是 npx skills add tw93/Mole -a claude-code codex cursor -g -y。
3. 卸载时默认选中个人数据：mo uninstall --with-data <名字> 一开始就选中 App 的设置和数据，预览里仍会逐条列出，按 D 可以保留任意一条路径。
4. 清理更多 App 残留：clean 现在能清理飞书及其沙盒缓存、微信的网页 profile、闲置的 Helium 签名副本，以及富途牛牛关闭时留下的更新安装包。
5. 外置硬盘清理更准确：mo clean --external 报告的是实际清理出的空间，保留硬盘上的废纸篓和受保护的 Finder 元数据，临时目录里有读不到的子目录时也会照常计算大小，不再整项跳过。
6. 卸载确认更稳妥：Homebrew cask 的密码提示保持在前台，真实卸载必须在终端里确认，没有终端时的 dry run 列出计划后正常结束，名字里带控制字符的 App 也能安全显示。
7. 更新时不再弹出命令行工具安装框：没装开发者工具的 Mac 上，mo update 和安装脚本不会再弹出 Command Line Tools 安装框，GitHub API 查不到版本时也会改用 Git 的 release tag。
8. 忽略 Ctrl-C 的命令也能停下：某条命令不响应停止信号时，超过时间限制两秒后会被强制结束，清理和卸载不会再卡在这一步。
9. mo remove 卸得更干净：会删掉 Mole 写入的 shell 补全行，保留你自己的配置行和 rc 文件的软链，没有终端可以确认时以错误退出。
10. Analyze 和 Purge 更顺手：Analyze 的每一项都能继续浏览，扫描后马上有变化的目录也会刷新，Purge 遇到扫描很慢的容器目录时会逐个项目重扫，不再跳过后面的构建产物。

Thanks

Issue reporters and PR contributors this cycle: @viniciusdsandrade · @HangLark · @M-Hassan-Raza · @greyby · @r266-tech · @Showdown76py · @ragnarok22 · @Ctrl-Alb.

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.