Macの大掃除を1コマンドで！95GBも空き容量を取り戻せるオールインワン最適化ツール — Mole

アーキテクチャ・仕組み

• 単一バイナリとして配布され、外部依存が最小限
• ファイル操作は ~/Library/Logs/mole/operations.log に自動ログ記録（MO_NO_OPLOG=1 で無効化可能）
• mo analyze はFinderのゴミ箱経由でファイルを移動するため、直接削除より安全
• パス検証、保護ディレクトリルール、保守的なクリーンアップ範囲、高リスク操作時の明示的確認など「安全第一」の設計

対応環境

• macOS: メイン対応プラットフォーム
• Windows: 実験的サポート（windowsブランチで提供）
• ターミナル: Kaku（推奨）、Alacritty、kitty、WezTerm、Ghostty、Warp対応。iTerm2は互換性の問題あり
• MO_LAUNCHER_APP=<name> 環境変数でターミナルアプリを手動指定可能

主要機能一覧

安全機能

• --dry-run オプションで事前プレビュー可能（clean、uninstall、purge、installer、optimize等）
• --debug で詳細ログ出力
• --whitelist でクリーンアップ・最適化から除外するルールを管理
• --paths でプロジェクトスキャン対象ディレクトリをカスタマイズ
• 破壊的操作（clean、uninstall、purge、installer、remove）は確認プロンプトあり
• CoreSimulatorのIN_USEアイテムは自動スキップ

JSON出力・自動化対応

• mo analyze --json および mo status --json でJSON形式の出力が可能
• mo status はパイプ検出時に自動でJSON出力に切り替え
• スクリプトやCI/CDとの連携に活用可能

ランチャー連携

• Raycast / Alfredとの統合スクリプトを提供
• setup-quick-launchers.sh で5つのコマンド（Clean、Uninstall、Optimize、Analyze、Status）を追加

設定ファイル

• ~/.config/mole/purge_paths: purgeコマンドのスキャン対象ディレクトリ
• カスタムパス未設定時は ~/Projects、~/GitHub、~/dev をデフォルトでスキャン

ライセンス

• MITライセンス（商用利用可、自由に使用・改変・再配布可能）

Homebrewでインストール（推奨）

brew install mole

スクリプトでインストール

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

基本的な使い方

mo                    # 対話式メニューを起動
mo clean              # ディープクリーンアップ
mo uninstall          # アプリを関連ファイルごと削除
mo optimize           # システム最適化
mo analyze            # ディスク使用量を視覚化
mo status             # リアルタイムシステム監視
mo clean --dry-run    # 削除前にプレビュー（安全確認）

mo purge（ビルド成果物の削除）を使う場合は brew install fd も推奨