Mole V1.13

Dig deep like a mole to clean your Mac.

Changelog

1. Turbocharged Core & UX: Re-architected with parallel Go processing for near-instant metrics. Added 'F' key support for instant UI refreshes, significantly smoothing the uninstallation workflow.
2. Safety Hardening 2.0: Updated SECURITY_AUDIT.md details our "Iron Dome" protection, now covering AI models (Claude, Ollama), network tools, and login items. We explicitly removed risky setting resets to guarantee stability.
3. Deep & Smart Cleaning: Now targets local APFS snapshots and Spotlight user caches to reclaim hidden space, while intelligently scrubbing ephemeral build artifacts like .next and __pycache__.
4. Developer-First Logic: Enhanced recognition for IDEs (JetBrains, VSCode) preserves workspaces. Added AGENT.md to standardize AI-assisted development protocols.
5. Robust Modular Architecture: Complete codebase modularization improves stability, with strictly handled TCC permissions and safer root operations.

🎉 A little 🎄 Christmas surprise awaits you in the terminal!

Thanks to everyone who provided feedback and reported bugs. Your input makes Mole better. If you find Mole useful, a Star is always appreciated.

https://github.com/tw93/Mole

Mole V1.12

Dig deep like a mole to clean your Mac.

Changelog

1. Smarter Cleanup: mole clean now includes new rules for AI models, Docker, and browser caches. The --dry-run option allows you to export and review the full file list before deletion, ensuring you know exactly what will be removed, --debug supports more detailed content output for better troubleshooting.
2. Uninstall UX: Added a 24-hour cache for app scanning results, so you don't have to wait for a full scan every time. The interface now supports real-time filtering to quickly locate and select apps for removal, optimize the uninstalled and more complete content of dozens of IDE editors.
3. Enhanced Safety & Whitelisting: Default protection added for network tools (Surge, Clash, Mihomo). mole optimize now supports a --whitelist argument, allowing you to select and skip specific checks (e.g., Firewall/Gatekeeper).
4. Visuals & Monitoring: mole status now identifies CPU/GPU core counts and adds real-time metrics for Battery, Load, and Network. mole analyze is smoother with async pre-fetching and a history stack for navigation.
5. Core Architecture: Massive refactor of common.sh into modular libraries. Introduced a unified Sudo manager (Touch ID/KeepAlive), safer file operations, and added 130+ automated tests for stability.

更新日志

1. 清理能力升级：mole clean 新增对 AI 模型、Docker 及浏览器缓存的清理规则，--dry-run 模式现在支持导出详细清单供审查，让你在执行前对清理内容更加了解，--debug 支持更详细的内容输出，用于更好排查问题。
2. 卸载体验优化：引入 24 小时扫描缓存机制，二次进入无需等待，列表支持实时关键词过滤，帮助你快速定位并选择需要卸载的应用，优化数十种 IDE 编辑器的卸载更全的内容。
3. 安全与白名单：增强应用保护，默认排除 Surge、Clash、Mihomo 等网络工具，mole optimize 新增 --whitelist 参数，支持选择跳过防火墙或 Gatekeeper 等特定检查。
4. 可视化与监控：mole status 支持识别 CPU/GPU 核心数量，并新增电池健康、系统负载及网络吞吐的实时监控，mole analyze 支持异步预加载和历史记录栈，大文件浏览更顺滑。
5. 核心代码重构：将核心库拆分为模块化组件；引入统一的 Sudo 管理器（支持 Touch ID 和后台保活），所有文件操作接入安全 API，新增 130+ 自动化测试用例确保稳定性。

Thanks to everyone who provided feedback and reported bugs. Your input makes Mole better. If you find Mole useful, a Star is always appreciated.

https://github.com/tw93/Mole

Mole V1.11

Dig deep like a mole to clean your Mac.

Changelog

1. Cleanup runs much faster now with optimized scanning, and protects more dev tools like renv, JetBrains IDEs, and OpenVPN configs from accidental deletion.
2. Vim users rejoice: all menus now support h/j/k/l navigation, plus analyze view has refresh, and menus auto-fit your terminal height.
3. Optimize command preserves Finder cache so your window positions and sidebar settings stay intact.
4. Password input is more reliable, fixing lid-close wake issues, Intel CPU errors, and iTerm2 exit quirks.
5. Under the hood: 1000+ line cleanup script split into 7 modules, added health checks and security scans, plus 400+ new test cases for stability.

更新日志

1. 清理速度快了不少，扫描算法优化过了。保护规则也更全，renv、JetBrains 全家桶、OpenVPN 配置这些不会被误删。
2. Vim 党福音：所有菜单都能用 h/j/k/l 导航了，analyze 支持刷新，列表高度自动适配终端窗口。
3. Optimize 命令不再删 Finder 缓存，你的窗口位置、侧边栏设置这些都会保留。
4. 密码输入更靠谱了，修了合盖唤醒输不了密码、Intel CPU 报错、iTerm2 卡退出这些问题。
5. 代码层面：1000+ 行的清理脚本拆成了 7 个模块，加了健康检查和安全扫描，新写了 400+ 条测试用例提升稳定性。

Thanks to everyone who provided feedback and reported bugs. Your input makes Mole better. If you find Mole useful, a Star is always appreciated.

https://github.com/tw93/Mole

Mole V1.10

Dig deep like a mole to clean your Mac.

Changelog

1. System Status Dashboard is now built in. Run mo status to try it out.
2. The Go analyzer has been split into cache / scan / format modules, with the analyzer/status binaries and related scripts kept on a regular update cycle.
3. Analysis, cleaning, optimization, and uninstall flows have been polished end to end: scan warm-up, cleaning tips, large-file view, window layout, and menu interactions are all tuned for better performance and a smoother experience.
4. Stability and compatibility are further strengthened by fixing Wi-Fi anomalies, whitelist matching, space-containing password auth, Clash protection, and more, plus improved error handling and 43 new test cases to raise coverage.
5. Automation and workflows have been upgraded so build artifacts, binary refreshes, and CI checks are routinely maintained, keeping the whole development-to-release pipeline consistent and traceable.

更新日志

1. System Status Dashboard 正式接入，建议直接运行 mo status 看一眼。
2. Go 分析器拆分为缓存 / 扫描 / 格式化三个模块，并对 analyzer/status 二进制及其配套脚本做规律性的更新维护。
3. 从磁盘分析、清理、优化到卸载，整条链路都做了一轮打磨：包括扫描预热、清理提示、大文件列表、窗口布局和菜单交互等细节优化，在性能和使用顺手度上都有明显提升。
4. 稳定性和兼容性继续加固：修复了 Wi-Fi 异常、白名单匹配、含空格密码认证、Clash 防护等问题，同时增强错误处理逻辑，并补充了 43 条测试用例以提升验证覆盖度。
5. 自动化流程和工作流进一步完善：常态化提交构建产物、更新二进制以及强化 CI 检查，让从研发到投放的整条链路更加一致、可控且可追溯。

Learn how to use it through this main document. If you find Mole useful, a Star is always appreciated.

https://github.com/tw93/Mole

Mole V1.9

Dig deep like a mole to clean your Mac.

Changelog

1. Added the new mo optimize command with full system tuning (cache refresh, network reset, log cleanup, Spotlight rebuild).
2. Rewrote the entire disk analysis module in Go with faster concurrent scanning and smart caching.
3. Improved large-directory handling by auto-collapsing node_modules and optimizing large-file detection.
4. Strengthened path-safety checks to prevent accidental system deletion and expanded protected directories.
5. Enhanced whitelist validation to block malformed paths, spaces, and injection attempts like double slashes.
6. Added post-Base64 decoding validation to prevent null-byte and illegal-path injection risks.
7. Optimized logging and caching systems to reduce I/O and improve overall performance.
8. Improved sudo keep-alive stability and refined DS_Store cleanup, need to disable the whitelist.
9. Overhauled keyboard and UI interactions with simpler inputs, better prompts, and unified Q to exit.
10. Upgraded code quality with ShellCheck, new unit tests, optimized scripts, many places have been presented in a completely new way.
11. Fixed the timeout issue during Brew cleanup, optimized the installation experience of Raycast to support 4 commands.

更新日志

1. 新增 mo optimize 一键系统优化命令，涵盖缓存刷新、网络重置、日志清理、Spotlight 重建等全套操作。
2. 使用 Go 语言重写磁盘分析模块，支持并发扫描并引入智能缓存，大幅提升分析速度。
3. 优化大型目录处理，自动折叠 node_modules，并改进大文件检测与展示逻辑。
4. 加强路径安全校验，防止误删系统文件，并扩大关键系统目录的保护范围。
5. 升级白名单校验机制，严格拒绝异常路径、空格路径和 // 注入风险。
6. Base64 解码后新增完整性与非法字符校验，避免批量卸载中的路径注入问题。
7. 优化日志与缓存系统，减少 I/O 消耗并提升整体性能。
8. 改进 sudo 保活稳定性，并增强 DS_Store 清理逻辑，需关闭白名单。
9. 全面优化键盘与界面交互，输入更简洁、提示更清晰，统一使用 Q 退出。
10. 提升代码质量：加入 ShellCheck、完善单测、优化脚本，很多地方的展示焕然一新。
11. 修复Brew清理时候的超时问题，Raycast 安装体验优化支持4个命令。

Learn how to use it through this main document. If you think mole is useful to you, welcome to Star

https://github.com/tw93/Mole

Mole V1.8

Dig deep like a mole to clean your Mac.

Changelog

1. AI browser cleanup – Added Dia, Comet, Orion, and Zen support; smarter Service Worker cache cleaning for Chrome, Edge, Brave, Arc; preserves online editors like capcut.com, photopea.com, and pixlr.com.
2. Nix cleanup – Added Nix package manager garbage collection using --delete-older-than 30d, keeping only the latest builds.
3. Quick launcher integrations – Added Raycast one-command setup, Alfred workflow support.
4. Incremental uninstall check – Introduced delta verification to ensure safer and faster app removal.
5. Cleanup loading improvements – Unified progress feedback, smoother animations, and clearer task display during scans.
6. Multi-profile browser cleanup – Automatically detects and cleans all browser profiles (Default, Profile 1, Profile 2, etc.) for Chrome, Edge, Brave, and Arc.
7. Code cleanup and minor fixes – Removed unused variables, refined cache logic, and expanded cleaning coverage for Helium, Dia, Comet, Orion, and Zen.
8. Enhanced whitelist compatibility for surge, preventing the need to download after deletion

Learn how to use it through this main document. If you think mole is useful to you, welcome to Star

https://github.com/tw93/Mole

Mole V1.7

Dig deep like a mole to clean your Mac.

Changelog

1. Touch ID support – Added request_sudo_access with Touch ID fallback and cleaner privileged action flow.
2. Better cleaning – Improved whitelist handling, progress display, and cache/orphan detection.
3. Whitelist: Supports filtering many common cleaning methods, go to mo clean --whitelist to try it
4. Loading & links – Unified spinner style, improved parallel jobs, and cleaned up analyze temp files and link hints.
5. Visual inspection – Refreshed analyze view with badge icons, faster mdfind loops, and clearer headers for large media.
6. Dry-run safety – Ensured nothing is deleted in --dry-run mode and validated whitelist entries first.
7. Uninstall protection – Added strict path checks and manual confirmation to prevent system deletions.
8. Locale fixes – Forced neutral LC_ALL/LANG, replaced spinners with ASCII, and muted debug noise.
9. Container safety – Stopped auto-removal of “orphaned” containers by default.
10. Removed a lot of emojis. I don’t like emojis very much now.
11. Mailbox index and information are not changed by default, and cache is added to the whitelist.
12. When uninstalling software, it supports sorting by time, size, name, and fuzzy search.

Learn how to use it through this main document. If you think mole is useful to you, welcome to Star

https://github.com/tw93/Mole

Mole V1.6.3

🦡 Dig deep like a mole to clean your Mac.

📝 Changelog

New Features

• Use mo instead of mole, which is shorter and more convenient
• Added Disk Space Analyzer, allowing interactive disk usage scanning and generating categorized reports
• Introduced a whitelist management tool, supporting interactive selection and review of caches detected in dry-run mode, with entries written to ~/.config/mole/whitelist

Enhancements

• Major enhancements to the cleaning/uninstall workflow: expanded default protection list, stronger safeguards for databases and system tools, and improved interactive batch uninstall
• Improved CLI experience: added run-time progress prompts and refined interface copy to make multi-step operations clearer
• Support mole remove to delete everything related to mole from the system.
• Filter and remove configuration island configuration issues

Documentation

• Updated and expanded documentation and guides, covering the Disk Space Analyzer, whitelist usage, and common FAQs

If you find it useful, please star it.

https://github.com/tw93/Mole

Mole V1.4

🦡 Dig deep like a mole to clean your Mac.

ChangeLog

1. Dry-Run Mode – Preview Before Cleaning

mole clean --dry-run  # See what will be deleted without actually removing anything

2. Whitelist Protection – Keep Important Caches, add your own patterns as needed.

mkdir -p ~/.config/mole
echo '~/Library/Caches/ms-playwright*' >> ~/.config/mole/whitelist

3. System App Uninstall – Remove Apps Requiring Sudo, you'll be prompted for password once if needed.

mole uninstall  # Now supports system apps (Docker, VMware, etc.)

4. Startup Animation - First launch shows a Mole animation.

          /\_/\
     ____/ o o \
   /~____  =o= /
  (______)__m_m)
          /   \
       __/ /\ \__
      /__/  \__\_

  Ready to dig deep...

5. Mole supports automatic check for update prompts.
6. Supplement the newbie usage documentation, see the prompts in the readme.
7. Homebrew Installation Support – Install via Homebrew for easier management.

   brew install tw93/tap/mole  # One-command install
   brew upgrade mole           # Easy updates

Use the document to see the markdown on the homepage. If you find it useful, please star it.

https://github.com/tw93/Mole

Mole V1.2

🦡 Dig deep like a mole to clean your Mac.

Highlights

• 🦡 Deep System Cleanup - Remove hidden caches, logs, and temp files in one sweep
• 📦 Smart Uninstall - Complete app removal with all related files and folders
• ⚡️ Fast Interactive UI - Arrow-key navigation with pagination for large lists
• 🧹 Massive Space Recovery - Reclaim 100GB+ of wasted disk space

Installation

curl -fsSL https://raw.githubusercontent.com/tw93/mole/main/install.sh | bash

Usage

mole               # Interactive main menu
mole clean         # Deep system cleanup
mole uninstall     # Interactive app uninstaller
mole --help        # Show help

What Mole Cleans

What Mole Uninstalls