介绍
# Mole - Mac Cleanup & Optimization Tool
**Repo:** https://github.com/tw93/Mole **Command:** `mo`（不是 `mole`！） **Install:** `brew install mole`
> **Note for humans:** 不带参数的 `mo` 会打开一个交互式 TUI 模式。这对 Agent 来说没什么用，但你可能想手动试试！ 😉
## 功能介绍
一体化工具集，集成了 CleanMyMac、AppCleaner、DaisyDisk 和 iStat Menus 的功能： - **深度清理** — 移除缓存、日志、浏览器残留 - **智能卸载** — 移除应用及其隐藏残留 - **磁盘分析** — 可视化使用情况，管理大文件 - **实时监控** — 实时系统状态 - **项目产物清理** — 清理 `node_modules`、`target`、`build` 等。
---
## 非交互式命令（适合 Clawd）
### 预览 / 试运行（务必先使用此项） ```bash mo clean --dry-run # Preview cleanup plan mo clean --dry-run --debug # Detailed preview with risk levels & file info mo optimize --dry-run # Preview optimization actions mo optimize --dry-run --debug # Detailed optimization preview ```
### 执行清理 ```bash mo clean # Run deep cleanup (caches, logs, browser data, trash) mo clean --debug # Cleanup with detailed logs ```
### 系统优化 ```bash mo optimize # Rebuild caches, reset services, refresh Finder/Dock mo optimize --debug # With detailed operation logs ```
**`mo optimize` 的作用：** - 重建系统数据库并清除缓存 - 重置网络服务 - 刷新 Finder 和 Dock - 清理诊断和崩溃日志 - 移除交换文件并重启动态分页器 - 重建启动服务和 Spotlight 索引
### 白名单管理 ```bash mo clean --whitelist # Manage protected cache paths mo optimize --whitelist # Manage protected optimization rules ```
### 项目产物清理 ```bash mo purge # Clean old build artifacts (node_modules, target, venv, etc.) mo purge --paths # Configure which directories to scan ```
配置文件：`~/.config/mole/purge_paths`
### 安装包清理 ```bash mo installer # Find/remove .dmg, .pkg, .zip installers ```
扫描范围：下载、桌面、Homebrew 缓存、iCloud、邮件附件
### 设置与维护 ```bash 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 ```
---
## 典型工作流
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` 获取详细日志。