mole-mac-cleanup

Mole - Mac のクリーンアップと最適化ツール

Repo: https://github.com/tw93/Mole Command: mo（moleではありません！） Install: brew install mole

人間向けの注意: 引数なしでmoを実行すると、対話型TUIモードが開きます。エージェントには役立ちませんが、手動で試してみるとよいでしょう！😉

できること

CleanMyMac、AppCleaner、DaisyDisk、iStat Menus の機能を組み合わせたオールインワンツールキットです。

• 徹底的なクリーンアップ — キャッシュ、ログ、ブラウザーの残留ファイルを削除します
• スマートアンインストーラー — アプリと隠れた残存ファイルを削除します
• ディスク分析 — 使用状況を視覚化し、大容量ファイルを管理します
• ライブモニタリング — システム統計をリアルタイムで表示します
• プロジェクト生成物の削除 — node_modules、target、buildなどをクリーンアップします

---

非対話型コマンド（Clawd 向け）

プレビュー／ドライラン（必ず最初に実行）

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

クリーンアップを実行

mo clean                        # Run deep cleanup (caches, logs, browser data, trash)
mo clean --debug                # Cleanup with detailed logs

システムの最適化

mo optimize                     # Rebuild caches, reset services, refresh Finder/Dock
mo optimize --debug             # With detailed operation logs

mo optimizeで行われる処理：

• システムデータベースを再構築し、キャッシュをクリアします
• ネットワークサービスをリセットします
• Finder と Dock を更新します
• 診断ログとクラッシュログをクリーンアップします
• スワップファイルを削除し、ダイナミックペイジャーを再起動します
• 起動サービスと Spotlight インデックスを再構築します

ホワイトリストの管理

mo clean --whitelist            # Manage protected cache paths
mo optimize --whitelist         # Manage protected optimization rules

プロジェクト生成物の削除

mo purge                        # Clean old build artifacts (node_modules, target, venv, etc.)
mo purge --paths                # Configure which directories to scan

設定ファイル：~/.config/mole/purge_paths

インストーラーのクリーンアップ

mo installer                    # Find/remove .dmg, .pkg, .zip installers

スキャン対象：Downloads、Desktop、Homebrew キャッシュ、iCloud、Mail の添付ファイル

セットアップとメンテナンス

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. 削除対象を確認します：

   mo clean --dry-run --debug
   

2. 問題がなければ、クリーンアップを実行します：

   mo clean
   

3. クリーンアップ後にシステムを最適化します：

   mo optimize --dry-run
   mo optimize
   

4. 開発プロジェクトの生成物をクリーンアップします：

   mo purge
   

---

クリーンアップ対象（mo clean）

• ユーザーアプリのキャッシュ
• ブラウザーのキャッシュ（Chrome、Safari、Firefox）
• 開発者ツール（Xcode、Node.js、npm）
• システムログと一時ファイル
• アプリ固有のキャッシュ（Spotify、Dropbox、Slack）
• ゴミ箱

注意事項

• ターミナル： Ghostty、Alacritty、kitty、WezTerm の使用をおすすめします。iTerm2 には問題があります。
• 安全性： まず--dry-runを使用してください。厳格な保護機能を備えています。
• デバッグ： 詳細なログを表示するには--debugを追加してください。