Mole - Mac Cleanup & Optimization Tool
Repo: https://github.com/tw93/Mole
Command: mo (not mole!)
Install: INLINECODE2
Note for humans: mo without params opens an interactive TUI mode. Not useful for agents, but you might wanna try it manually! 😉
What It Does
All-in-one toolkit combining CleanMyMac, AppCleaner, DaisyDisk, and iStat Menus:
- - Deep cleaning — removes caches, logs, browser leftovers
- Smart uninstaller — removes apps + hidden remnants
- Disk insights — visualizes usage, manages large files
- Live monitoring — real-time system stats
- Project artifact purge — cleans
node_modules, target, build, etc.
Non-Interactive Commands (Clawd-friendly)
Preview / Dry Run (ALWAYS USE FIRST)
CODEBLOCK0
Execute Cleanup
CODEBLOCK1
System Optimization
CODEBLOCK2
What mo optimize does:
- - Rebuild system databases and clear caches
- Reset network services
- Refresh Finder and Dock
- Clean diagnostic and crash logs
- Remove swap files and restart dynamic pager
- Rebuild launch services and Spotlight index
Whitelist Management
CODEBLOCK3
Project Artifact Purge
CODEBLOCK4
Config file: INLINECODE8
Installer Cleanup
CODEBLOCK5
Scans: Downloads, Desktop, Homebrew caches, iCloud, Mail attachments
Setup & Maintenance
mo touchid # Configure Touch ID for sudo
mo completion # Set up shell tab completion
mo update # Update Mole itself
mo remove # Uninstall Mole from system
mo --version # Show installed version
mo --help # Show help
Typical Workflow
- 1. Check what would be cleaned:
CODEBLOCK7
- 2. If looks good, run cleanup:
CODEBLOCK8
- 3. Optimize system (after cleanup):
CODEBLOCK9
- 4. Clean dev project artifacts:
mo purge
What Gets Cleaned (mo clean)
- - User app cache
- Browser cache (Chrome, Safari, Firefox)
- Developer tools (Xcode, Node.js, npm)
- System logs and temp files
- App-specific cache (Spotify, Dropbox, Slack)
- Trash
Notes
- - Terminal: Best with Ghostty, Alacritty, kitty, WezTerm. iTerm2 has issues.
- Safety: Use
--dry-run first. Built with strict protections. - Debug: Add
--debug for detailed logs.
Mole - Mac 清理与优化工具
仓库地址： https://github.com/tw93/Mole
命令： mo（不是 mole！）
安装： brew install mole
给人类的提示： 不带参数运行 mo 会打开交互式 TUI 模式。对智能体来说不太实用，但你可以手动试试！😉
功能概述
集成了 CleanMyMac、AppCleaner、DaisyDisk 和 iStat Menus 的一体化工具包：
- - 深度清理 — 清除缓存、日志、浏览器残留文件
- 智能卸载 — 移除应用及隐藏残留文件
- 磁盘洞察 — 可视化使用情况，管理大文件
- 实时监控 — 系统状态实时显示
- 项目产物清理 — 清理 node_modules、target、build 等目录
非交互式命令（适合 Clawd 使用）
预览/试运行（务必先使用）
bash
mo clean --dry-run # 预览清理计划
mo clean --dry-run --debug # 详细预览，包含风险等级和文件信息
mo optimize --dry-run # 预览优化操作
mo optimize --dry-run --debug # 详细优化预览
执行清理
bash
mo clean # 运行深度清理（缓存、日志、浏览器数据、废纸篓）
mo clean --debug # 清理并输出详细日志
系统优化
bash
mo optimize # 重建缓存、重置服务、刷新 Finder/Dock
mo optimize --debug # 输出详细操作日志
mo optimize 执行的操作：
- - 重建系统数据库并清除缓存
- 重置网络服务
- 刷新 Finder 和 Dock
- 清理诊断和崩溃日志
- 移除交换文件并重启动态分页器
- 重建启动服务和 Spotlight 索引
白名单管理
bash
mo clean --whitelist # 管理受保护的缓存路径
mo optimize --whitelist # 管理受保护的优化规则
项目产物清理
bash
mo purge # 清理旧的构建产物（node_modules、target、venv 等）
mo purge --paths # 配置要扫描的目录
配置文件：~/.config/mole/purge_paths
安装包清理
bash
mo installer # 查找/移除 .dmg、.pkg、.zip 安装包
扫描范围：下载、桌面、Homebrew 缓存、iCloud、邮件附件
设置与维护
bash
mo touchid # 为 sudo 配置 Touch ID
mo completion # 设置 Shell 标签补全
mo update # 更新 Mole 本身
mo remove # 从系统中卸载 Mole
mo --version # 显示已安装版本
mo --help # 显示帮助信息
典型工作流程
- 1. 检查将要清理的内容：
bash
mo clean --dry-run --debug
- 2. 如果看起来没问题，运行清理：
bash
mo clean
- 3. 优化系统（清理后）：
bash
mo optimize --dry-run
mo optimize
- 4. 清理开发项目产物：
bash
mo purge
清理内容（mo clean）
- - 用户应用缓存
- 浏览器缓存（Chrome、Safari、Firefox）
- 开发工具（Xcode、Node.js、npm）
- 系统日志和临时文件
- 应用特定缓存（Spotify、Dropbox、Slack）
- 废纸篓
注意事项
- - 终端： 推荐使用 Ghostty、Alacritty、kitty、WezTerm。iTerm2 存在兼容问题。
- 安全性： 请先使用 --dry-run。工具内置了严格保护机制。
- 调试： 添加 --debug 可获取详细日志。
