ドキュメント

概要

MoleのMacアプリとCLIは、クリーン対象のカテゴリがほぼ共通で、保守的な安全ルールと保護リストは同じですが、できることの範囲は完全には同じではありません。CLI は無料、オープンソース、GPL-3.0ライセンス。MacアプリはSwiftUIで作られたMacアプリで、買い切り $19、無料アップデート付き、サブスクなしです。MacアプリではクリーンアップとMacのメンテナンスを画面上で操作でき、CLIにはターミナル専用のコマンドがいくつか追加されています。

Macアプリ

インストール

ホームページからDMGをダウンロードするか、Homebrewでインストールします：brew install --cask mole-app。

アップデート後、タイトルバーに新機能を見るが表示され、開くか閉じると消えます。実行中のバージョンとその前の4つのバージョンの更新内容が表示され、末尾のリンクからすべてのリリースも見られます。Moleメニューの新機能からいつでも開き直せます。

クリーン · 地球

クリーンの先頭にはアプリキャッシュが並び、ブラウザ、クラウドクライアントのキャッシュとアプリログをまとめます。開発、AI、通信、デザインの各ツールは別グループに表示します。その後にアンインストール後の残留ファイル、ダウンロード・デスクトップに2週間以上置かれたインストーラ、システムデータが続きます。システムデータの対象はローカルのTime Machineスナップショット、システムのキャッシュとログ、古いmacOSインストーラ、古い壁紙のダウンロードです。最後はゴミ箱です。「個別に管理」にはバックアップ、iCloudのローカルファイル、仮想マシン、モデルを表示し、清掃対象の容量には含めません。

削除前に各項目を確認します。システムデータはmacOSの分類であり、フォルダや目標容量ではありません。Moleが測るファイル容量とシステム設定の数字は一致しません。ハードリンクで共有するファイルは重複計上しません。キャッシュは標準で完全削除し、設定でゴミ箱への移動に変更できます。ローカルスナップショットを削除するとその復元ポイントは失われますが、外付けディスクのバックアップは残ります。システム統合ログの清掃は個別確認が必要で、元に戻せません。

既定で要確認なのは、再構築コストの大きいパッケージキャッシュ（npm、yarn、pnpm、bun、CocoaPods、Gradle）と、依存関係のダウンロードなしで再生成できるプロジェクト生成物（build、dist、target、.build、.next、DerivedData、__pycache__、coverage）です。Macアプリは Pods、venv などのダウンロード済み依存ディレクトリを候補にしません。再構築にネットワークが必要で、ロックファイルどおりの状態を再現できない場合があるためです。プロジェクトの node_modules は例外で、90日間変更がなくロックファイルから再インストールできる場合にだけ表示され、削除時は必ずゴミ箱に移します。要確認項目は確認するまで未選択で、設定からゴミ箱経由にもできます。

「個別に管理」にある専用操作で、対応するParallels仮想ディスク内の未使用領域をParallels自身のツールで回収できます。先に仮想マシンを通常終了してください。実行中や一時停止中は対象外です。見積もりを確認して個別に実行します。仮想マシンと内部のファイルは残り、一括清掃には含まれません。実行を中断せず完了を待ってください。

AIツールのクリーンアップとケア · 月

このMacにAIツールのデータがあると、クリーン画面の右上の遠くに月が現れ、AIツールのクリーンアップとケアに入れます。入口はデータが見つかったときだけ表示され、確認は決まったいくつかのフォルダの有無を見るだけでディスクを走査しません。不要なら設定 › 一般 › クリーンアップで非表示にできます。画面に入っても自動ではスキャンせず、「AIデータをスキャン」で始まり、見つかれば結果がそのまま開きます。

結果は、消して後悔するかどうかで3つに分かれます。キャッシュと古いバージョンは最初からチェックされ、Claude Code、Codex、Cursor Agent、Grok、GitHub Copilotのコマンドラインツールの置き換えられた古いバージョン（デスクトップ版Cursorが自分用に残すcursor-agentの古いリリースも含む）と、Claude、Codex、Cursor、Grokのキャッシュが入ります。セッションとworktreeはチェックなしで、ツールごとの保存期間（15、30、90、120日または「表示しない」から選択、初期値は「表示しない」で、その間は各ツールの行に残しているセッションの数と合計サイズが表示され、メニューの各選択肢にはそれぞれ並ぶ件数とサイズが出ます）を過ぎたCodex、Claude Code、OpenCode、Devinのセッション、同じ保存期間を過ぎてプロジェクトフォルダがなくなったClaude Codeのセッション、Codexが削除済みのセッションに残した画像、独自の変更やブランチに保存されていないコミットがないことをgitで確認できるworktreeが入ります。変更がすでにメインブランチに取り込まれたworktreeも対象です。使っていないツールとメンテナンスもチェックなしで、30日使われず実行中でもないAIのコマンドラインツール（セッションと設定ごと削除）、200 MBを超えるSQLiteデータベースの圧縮、削除済みツールが残した設定フォルダが入ります。古いバージョン、キャッシュ、セッション、worktreeは展開して1件ずつ外せます。

過去24時間に使ったセッションは表示されないので、CodexやClaude Codeを開いたままでも使えます。実行中のツールが開いているデータは使用中と表示され、選択できず、各行は削除の直前にもう一度確認されます。ファイルはゴミ箱へ移し、Codexのセッションはゴミ箱にコピーしてからCodex自身のコマンドで削除し、Codexがそのために生成した画像も一緒にゴミ箱へ移し、Homebrewで入れたツールはbrewで削除し、データベースの圧縮はその場で行います。メモリ、プラン、スキルはどの行にも入らず、ローカルモデルでは1か月使っていないOllamaのモデルだけが並び、Ollama自身のollama rmで削除します。

アプリ · 火星

「アプリ」タブは、アプリの更新、起動項目の管理、アンインストール後の後片付けをまとめた画面です。「更新」ではSparkle、Electron、Homebrew Cask / Formula、GitHub Releases、Mac App Storeのアプリを確認し、対応する更新はその場でインストールします。macOSが必要とする場合はApp Storeへの移動を明示します。

「起動」ではLogin Items、Launch Agents、Launch Daemons、バックグラウンド項目を一覧します。対応項目は無効化、ファイル表示、Apple管理項目はシステム設定への移動ができます。

アンインストールでは削除するアプリを選びます。MoleはApplication Support、Caches、Preferences、Logs、Launch Agents、Launch Daemons、Login Items、Containers、Group Containers、Saved Application State、Input Methodsなど15以上のLibraryサブディレクトリから残留ファイルを探します。Dock項目は自動で整理されます。設定やチャットなど、そのアプリ専用のデータはアプリと一緒に選択されます。ブラウザのプロファイル、ほかのアプリと共有するデータ、関連が弱いか曖昧な残留ファイルは、確認できるよう未選択のまま表示されます。セクションのチェックを外せば、再インストール用に残せます。同じ開発元が署名したオーディオプラグインやドライバ、/Users/Shared内のアプリのフォルダも確認用に表示されます。自動生成された名前の残留ファイルが数千個あっても、一つのフォルダとしてゴミ箱へ移動します。Cmdキーを押しながらクリックすると複数のアプリを同じバッチでアンインストールでき、個別の失敗は再試行のためにリストに残ります。アプリの行を右クリックしてデータのみクリアを選ぶと、アプリを残したままデータだけを削除します。

更新はできる限りアプリ内で完結します：SparkleとHomebrew CaskはMoleの中で直接インストールし、Mac App StoreはCommerceKitを経由して、認証やタイムアウトで失敗したときにApp Storeアプリに切り替わります。その他のアプリは起動してそれぞれのアップデーターに引き継ぎます。

/Applications/*.app のroot所有bundleを削除する初回は、セッション内で1度だけ管理者承認を求めます。同じセッション内では以降のアンインストールでパスワードを再要求しません。「起動」では、安定したlaunchdサービスに対応付けられるログイン項目と検証済みの LaunchAgents / LaunchDaemons をMoleが直接切り替えます。macOSのバックグラウンドタスク管理の項目で、Moleから直接操作できない項目は、対応するシステム設定の画面に誘導します。

Adobe Genuine Serviceには公式アンインストーラを開く操作があります。インストール済みのAdobeアンインストーラを検証できれば開き、できなければAdobeの手順を案内します。その後にサービスを再確認するため、開いただけでは削除完了になりません。TeamViewerや、Bitdefender、Intego、Kaspersky、Norton、Trend Microなどのウイルス対策アプリも、同じように開発元のアンインストーラを開きます。

最適化 · 水星

既定メンテナンスタスクをワンクリックで実行します。非管理者タスクは静かに実行され、管理者タスクは必要なときに1回の認証にまとめられます。

最適化は最初に、入力ソースの切り替え、Spotlight、通知センター、ユニバーサルクリップボードを対象に修復を試みます。深いタスクでは、Quick Lookの再構築、SQLiteデータベースの最適化、保存状態・隔離イベント・通知履歴の整理、壊れた設定・共有ファイルリスト・孤立したSpotlightルールの修復、ログイン項目の点検、プログラムが見つからないLaunch Agentのゴミ箱への移動、定期メンテナンスの実行を行います。

安全条件に合わない場合はタスクをスキップします。DNSやネットワークスタックのリセットは既定のメンテナンスには含まれません。

最適化の各タスクは自身のチェックで不要と判断されるとスキップされます。メモリプレッシャーが高くない場合のメモリ解放や、メールとメッセージが起動中のデータベース圧縮などがこれにあたります。スキップ理由は結果パネルに表示されるため、何が実行されたかを確認できます。メンテナンスが完了しましたの下にある概要の行をクリックすると最適化の詳細が開き、実行したタスクとスキップしたタスク、その理由が一覧で表示されます。

分析 · 木星

ディスク全体のツリーマップ表示。任意のディレクトリに深く入り込み、各レベルのサイズを確認できます。密集した項目や近いサイズの項目は要約ブロックにまとめ、マップを読みやすく保ちます。

サイズを取得できなかったエントリ（権限で制限されたフォルダ、TCCで保護されたコンテナ）は、無視されるのではなく再試行オプション付きで表示されます。保護されたナビゲーションルート（/、/Users、/Applications）はゴミ箱に移動できません。スキャン結果はキャッシュされ、開き直すと前回の結果を表示し、6時間を過ぎるとバックグラウンドで測り直します。

ツリーマップ上でディレクトリを1クリックすると中に入れます。マップの上にあるパスバーから任意の親階層に戻れます。左側リストと実際のツリーマップブロックでは、Finderで開く/表示する操作に加えて、右クリックからゴミ箱に入れるもそのまま使えます。Finderと同じく確認なしですぐ移動し、ゴミ箱から戻せます。完全に削除することになるゴミ箱内の項目だけは先に確認します。サマリーブロックは概要専用です。ツリーマップの面積はバイト数に比例するため、最も大きい項目が常に最大のブロックになります。

コンテキストメニューでは、ファイルやフォルダを削除せずにパスをコピーし、Finderやサポートへのメッセージに貼り付けられます。

マップ上部の選択では、異なるフォルダからファイルやフォルダを選べます。階層をたどったり戻ったりしても選択は残り、まとめてゴミ箱へ移動できます。フォルダにポインタを合わせると名前が表示され、5,000以上の既知のフォルダについては、中身と削除した場合の影響を一文で説明します。サイドリストの大きな項目には所属するアプリ名も表示されます。大きなファイルでは、1年間開かれず、書き込みも移動もされていないファイルに1年未使用と表示します。1日前から30日前までのスキャンと比べてボリュームの使用量が1 GB以上増えていると、増加量を示す行が現れます。内訳はゴミ箱、iPhoneとiPadのバックアップ、Xcode、AIツール、インストール済みアプリ別に表示され、各行からその場所を直接開けます。

ステータス · 太陽

ダッシュボードにヘルススコア、CPU、GPU、メモリ、バッテリー、ディスク、ネットワーク、ファンをまとめます。バッテリーがないMacではバッテリーの代わりに温度を、ファンがないMacではファンの代わりに温度を表示します。グラフで最近の変化を確認でき、対応Macでは自動、冷却、強冷のファン制御を表示します。冷却や強冷はシステム終了、再起動、アップデート後に復元されますが、自分でMoleを終了した場合は復元されません。ダッシュボードの各タグから、関連する測定値のカードを開けます。CPUとGPUの温度バッジにはセンサーごとの名前と測定値が並び、バッテリー、電源、ストレージのセンサーにはそれぞれ専用のカードがあります。メモリ、ディスク、バッテリー、チップ名もそれぞれのカードを開きます。メニューバーパネルの同じタグからも同じカードを開けます。ネットワークカード右上の接続タグをクリックすると、ローカルのIPv4アドレス、グローバルIPとその地域・通信事業者、システムプロキシを表示し、プロキシやVPNの使用中はChatGPTから見えるIPと国も、Wi-Fi接続時は信号の強さとリンクの規格、周波数帯、速度も表示します。

下のプロセス一覧は毎秒更新されます。5つの列（名前、PID、CPU、電力、メモリ）はすべてクリックで並べ替えでき、もう一度クリックすると昇降順を切り替えます。行をクリックすると、そのプロセスの説明シートが開きます。行を右クリックすると、行を固定/固定解除（ピン留めしたプロセスは更新やアプリ再起動をまたいで先頭に残るため、スクロールで見失いません）、なぜ実行中？、Finderで表示、プロセス名をコピー、PIDをコピー、終了（通常の終了要求）、強制終了が選べます。保護されたシステムプロセスには終了と強制終了は表示されません。バッテリータイルの最も電力が高い行をクリックすると、対応するプロセスの説明シートに直接ジャンプします。

メニューバーパネル

必要なときだけ使える、macOSメニューバー常駐のモニターです。表示内容は、システム負荷に合わせて動く小さなランナーの「アイコン」、「動作データ」、「アイコンとデータ」から選べます。キャラクターはMole、RunCat、ビーグル、プードル、恐竜、ドラゴン、ウマ、ウサギ、カエル、ニワトリ、ラバーダック、カワウソ、イルカ、カメ、半魚人、ピクセル、フレックス、リフトブラザーから選べます。ポップオーバーにはヘルススコア、チップ、メモリ、macOS、稼働時間をまとめた表示、ハードウェアカード、対応環境でのファン制御、CPU使用率上位5つのプロセスと、クリーン・アンインストール・最適化の「累計メンテナンス」が表示されます。

下部にはクイックツールがあります。カメラやマイクの使用中はプライバシーインジケータが点灯し、画面オン維持（Keep Screen On）は1、2、4、8、12時間、または停止するまでの時間を選べます。画面を拭く（Clean Screen）は画面を単色にして、画面やキーボードを拭きやすくします（任意の入力ロックはmacOSの「アクセシビリティ」許可を使います）。外部ボリュームやディスクイメージを取り出せるときは、ここに「取り出す」ボタンも表示されます。カスタマイズできるグローバルショートカットからMoleを開け、「Dockのアイコンを隠す」をオンにすると、バックグラウンドではメニューバーだけで動きます。設定 › メニューバーで設定します。

アプリごとのプライバシー通知。通知にアプリ名が表示されている場合は、macOSの通知にポインタを合わせて このアプリを通知しない を選びます。設定 › メニューバー › 通知 › 通知をオフにしたアプリ から後で元に戻せます。カメラだけの通知は、macOSが使用中のアプリを公開しないため一般的な表示のままとなり、アプリごとの操作は表示されません。

メニューバーの表示内容はアイコン（ランナーアニメーション）、最大3つの指標を設定できる動作データ、アイコンとデータから選べます。初期設定では2つの指標が表示され、3つ目の状態データでもう1つ追加できます。各指標にはCPU使用率、メモリ使用率、メモリプレッシャー、スワップ使用量、GPU使用率、ディスク使用量、チップ温度、バッテリー残量、消費電力、ファン回転数、アクセサリの電池残量のいずれかを割り当てられ、同じものを複数に置くことはできません。現在の通信速度を表示は独立したスイッチで、これらの指標の横にアップロードとダウンロードの速度を表示します。このアップロードとダウンロードの表示をクリックするとアプリ別の通信一覧が開き、現在の速度、または過去1分、5分、10分、30分、1日、7日、30日の転送量を、Mac全体の推移と最大12個のアプリについて確認できます。Moleがメニューバーにあるときは、ステータスやメニューバーパネルのネットワークカードに表示されるダウンロードとアップロードの速度をクリックしても、同じ一覧が開きます。Moleメニューとメニューバーの右クリックメニューにある回線と速度テストからも開けます。記録はこの速度表示が出ている間だけ1分ごとに行われ、このMac内に30日間保存され、再起動後も残ります。Moleが動いていなかった時間は記録に含まれません。上部の「速度テスト」タブを選ぶとすぐに測定が始まり、macOS標準のnetworkQualityでAppleのサーバーに接続して、ダウンロード、アップロード、遅延、負荷時の遅延を表示します。Mole独自のサーバーは使いません。ランナーキャラクターは見た目だけの違いで、サンプリングする指標を変えるものではありません。データの並び方は列（初期設定）とコンパクトな2行の縦積みから選べます。向きを反転でランナーを左向きから右向きにできます。

キャラクターを変えずにランナーのアニメーションを一時停止できます。ネイティブのツールメニューから画面オン維持、画面を拭く、対応Macのファン制御、WiFi低遅延、デスクトップを隠すを使えます。メインウインドウ、ファン冷却、デスクトップアイコンの切り替えには任意のショートカットを設定できます。WiFi低遅延はネットワークカードにもあり、AWDLとAirDropを一時停止します。オフ、スリープ、Moleの終了で元の状態に戻り、ダウンロード速度の向上を保証するものではありません。デスクトップを隠すはMoleメニューとメニューバーの右クリックメニューにもあり、システム設定の「デスクトップとDock」にある「項目を表示」と同じ設定なので、ファイルやディスクはそのまま残ります。標準のショートカットは⌃⌥⌘Dです。

Doctor

アプリ内でウインドウ左上のMoleロゴをクリックし、Doctorを実行 を選びます。MoleがMacのモデル、macOSバージョン、権限、最近の操作、ディスプレイ、外部ボリューム、ネットワーク、セキュリティ状態、環境に関する読み取り専用の短い診断レポートを生成します。レポートをコピー をクリックし、サポートへのメッセージに貼り付けてください。

Doctorは6つの状態を検出します：フルディスクアクセス未設定、メモリプレッシャーの上昇、ディスクの空き容量不足、バッテリーの健康状態の低下、再起動のおすすめ、操作ログへの書き込み不可。各状態には解決手順が記載されたヘルプ記事へのリンクがあります。詳細はヘルプページをご覧ください。

設定

設定には3つのタブがあります。一般には表示言語（再起動後に適用）、クリーンアップ設定、クリーンアップの除外項目、ライセンスの有効化とデバイス管理、ベータ版アップデートを受け取る、フルディスクアクセスへの入口があります。クリーンアップ設定ではキャッシュの削除方法（初期設定の「完全に削除」または「ゴミ箱に入れる」）、AIツールのクリーンアップとケアを表示、クイックアンインストールを選べます。ツールには画面オン維持、画面を拭く、それぞれのショートカット、画面拭きのアクセシビリティ（macOSのアクセシビリティ権限が必要）、対応Macのバッテリー充電保護とファン設定があります。バッテリー充電保護はMoleの動作中に内蔵バッテリーを75〜80%に保ち、一度の管理者承認が必要です。「冷却後にファンの加速を終了」で、冷えたあと冷却と強冷のファン制御をシステムへ戻すか選べます。メニューバーにはログイン時に自動起動、Dockのアイコンを隠す、アイコンとランナーの外観、表示指標と通信速度、メニューバーパネルのショートカット、カメラとマイクの通知などがあります。ライセンスは Cmd + Shift + L でも開けます。

ターミナルのオプション

一部の人だけが必要とするオプションは設定に入れていません。ターミナルでコマンドを実行し、Mole を終了してから開き直すと反映されます。温度を華氏で表示するには defaults write com.tw93.MoleApp temperatureUnitPreference -string fahrenheit、摂氏に戻すには defaults delete com.tw93.MoleApp temperatureUnitPreference を実行します。変わるのは表示される数値だけで、ファンの曲線や高温の警告は同じ読み取り値のまま動作します。惑星の横の詩をセリフ体ではなくシステムフォントで表示するには defaults write com.tw93.MoleApp poemFontPreference -string system、セリフ体に戻すには defaults delete com.tw93.MoleApp poemFontPreference を実行します。

CLI

インストール

Homebrewでインストールします：brew install mole。mo でインタラクティブメニューを起動するか、任意のサブコマンドを直接実行できます。

共有コマンド · Macアプリにもあり

mo clean

キャッシュと一時ファイルを詳しく調べて削除します。--dry-run で削除せずにプレビュー、--debug で詳細ログ、--whitelist で保護キャッシュの管理をサポート。実行中のアプリのキャッシュは自動的にスキップされます。

mo uninstall

対話式のアプリ選択と残留ファイル検出。アプリサイズ、バンドルID、最終使用日を表示。Macアプリと同じ15以上の残留カテゴリを検出します。--dry-run をサポート。

mo optimize

CLIのメンテナンスタスクを実行します。必要な管理者タスクではパスワードを求めます。タスク構成はMacアプリの既定の最適化タスク一覧と異なる場合があります。--whitelist で特定のタスクを今後の実行から除外できます。

mo analyze

ターミナル内のインタラクティブなツリーマップ。矢印キーまたはVimキーバインド(h/j/k/l)でナビゲート。マップから直接ファイルをゴミ箱に移動。--json 出力や mo analyze /Volumes のようなカスタムパスで外付けドライブにも対応。

mo status

リアルタイムシステムダッシュボード：CPU、GPU、メモリ、ディスクI/O、ネットワーク、バッテリー、温度、稼働時間、ヘルススコア、トッププロセスと60秒間のスパークライン。--json で他のツールへのパイプに対応。

CLI専用コマンド

mo purge

プロジェクトディレクトリ内の古いビルド成果物を検出：node_modules、target、.build、build、dist、venv。設定可能なパスをスキャン（デフォルト：~/Projects、~/GitHub、~/dev）。7日以内のプロジェクトは「Recent」マークが付き、デフォルトでは未選択。--dry-run と --paths でスキャンディレクトリの設定をサポート。

mo installer

ダウンロード、デスクトップ、Homebrewキャッシュ、iCloud、メール添付ファイルから .dmg、.pkg、.zip インストーラーファイルを検出します。各ファイルにソースの場所をラベル付け。--dry-run をサポート。

mo touchid

sudo コマンドでTouch IDを有効にします。mo touchid enable で設定、mo touchid disable で元に戻します。--dry-run をサポート。

ユーティリティコマンド

mo completion

BashとZshのシェルタブ補完をセットアップします。シェルを自動検出し、適切な設定ファイルを更新します。

mo update

最新の安定版リリースにセルフアップデート。--nightly でmainブランチの最新未リリースビルド（スクリプトインストールのみ）。--force で現在のバージョンを再インストール。

mo remove

設定ファイルとシェル統合を含め、Mole CLIをシステムからアンインストールします。--dry-run をサポート。

安全性

CLIとMacアプリは同じ安全原則を共有しています：

パス保護。組み込みの拒否リストがシステム重要ディレクトリ、ホームフォルダの基本構造、既知のキャッシュ以外の場所をカバーします。シンボリックリンクは操作前に解決・検証されます。

プロセス認識。実行中のアプリのキャッシュはクリーンアップ時にスキップされます。ブラウザが開いている間、ブラウザキャッシュは操作されません。

無料試用と有効化。Macアプリでは、各有料ツール（クリーン、アプリ、最適化、分析でのゴミ箱への移動）は2回無料で使えます。その後はアクティブなライセンスが必要です。スキャンは常に無料です。

ホワイトリスト。CLI(~/.config/mole/whitelist)とMacアプリの両方で、特定のキャッシュや最適化タスクを今後の実行から保護できます。

操作ログ。すべての削除は ~/Library/Logs/mole/operations.log に記録されます。MacアプリのDoctorオーバーレイがこのログの状態を確認し、最近の失敗を表示します。

事前プレビュー。CLIはすべての破壊的コマンドで --dry-run をサポート。Macアプリのクリーンとアンインストールは、操作前にファイル一覧とバイト数の全体を表示します。分析のゴミ箱への移動はすぐに行われ、ゴミ箱から戻せます。

トラブルシューティング

Macアプリには一般的な問題を検出するDoctorが組み込まれています。ウインドウ左上のMoleロゴをクリックし、Doctorを実行 を選ぶと開けます。個別の状態についてはヘルプページをご覧ください。

CLIでは、任意のコマンドに --debug を追加して詳細ログを取得できます。~/Library/Logs/mole/operations.log で最近のアクティビティを確認してください。コマンドが静かに失敗する場合は、システム設定でフルディスクアクセスが付与されているかを確認してください。

問題の報告については、ヘルプページの問題を報告するセクションをご覧ください。