Burrow

ドキュメント

Burrow ができることのすべて、各ツールが触れる範囲、そして何かを削除する前に従うルール。

概要

Burrow は macOS 向けのネイティブなデスクトップアプリで、Windows 向けには WinUI 3 による beta 版があります。ふつうならクリーナー・アンインストーラ・重複ファイル検出・ディスク可視化・メニューバー監視に分かれている仕事をひととおり扱い、そのすべてを MCP でコーディングエージェントに開きます。

14 のツールがひとつのウインドウを共有します。ツールごとに画面全体の色が変わりますが、これは色こそが「今から何に触れるか」を伝える手がかりだからです。うち 2 つ、長期の履歴と MCP サーバには、対応するコマンドライン機能がまったくありません。

すべてローカルで動きます。スキャン結果・指標・履歴はこの Mac に留まり、MCP サーバはループバックにのみ接続します。

インストール

macOS では Homebrew が最短の経路です。Developer ID で署名され Apple の公証を受けた、エンジン同梱のビルドをインストールし、隔離属性も保つので Gatekeeper がチケットを検証できます。

brew install --cask caezium/tap/burrow

直接ダウンロードと Windows のプレビュー版は インストールページにあります。アップデートは署名付きの Sparkle フィードを通じてアプリ内に届きます。Homebrew で入れた場合の更新は brew upgrade.

フルディスクアクセス

許可がなくても Burrow は安全なスキャンを実行します。フルディスクアクセスを許可すると、macOS がふだん隠している Application Support やコンテナの深いキャッシュにも届くようになります。許可も取り消しも、システム設定の「プライバシー & セキュリティ」でいつでも行えます。

空き容量を取り戻す

クリーン

10 を超える分類をスキャンします。App のキャッシュ、システムキャッシュ、ログ、開発ツールのキャッシュ、AI ツールのキャッシュ、ブラウザのデータ、クラウドストレージのクライアント、デザインツール、コミュニケーションアプリ、そのほかの一時ファイルです。

確認用の一覧は、削除しても安全な順に並びます。作り直せるキャッシュが先で、目に見える状態は最後です。サイズ計算はハードリンクを認識するため、ツール間で共有されているファイルはパスごとではなく一度だけ数えられます。

ディープクリーン

開発作業が残した掘りくずです。判断の基準が違うので、ふつうのキャッシュとは分けています。 dist, build, target, .next, .build, DerivedData, __pycache__、 coverage のようなビルド成果物はネットワークなしで作り直せます。一方、 node_modules, Pods、 venv のような依存ディレクトリは取得し直す必要があるため、そのコストを添えて表示し、あなたが確認するまでチェックは外れたままです。

インストーラ

検索対象: .dmg と .pkg のうち、App をインストールしたあともダウンロードフォルダに残り続けているもの。ひとつずつは小さくても、数年使った Mac では合計で数十ギガバイトになることも珍しくありません。

重複ファイル

段階的な内容ハッシュを使います。まずサイズでまとめ、候補の先頭部分だけをハッシュ化し、それでも一致するものだけを全体でハッシュ化します。ハードリンクや複製されたファイルはひとつの実体として扱うので、表示される回収可能サイズは実際に戻ってくるサイズと一致します。

似ている写真

見た目はほとんど同じなのにバイト単位では異なる画像、たとえば連写のコマや書き出し直した写真を、視覚的に照合します。内容ハッシュでは見つけられないものを、こちらなら見つけられます。

アプリケーション

App

インストール済みのすべての App を、サイズ・名前・使用日・入手先で並べ替えられます。複数選択して削除すると、本体に加えて環境設定、Application Support のデータ、コンテナ、保存された状態、起動エージェントも取り除きます。

Homebrew のタブでは、どの cask と formula が古くなっているかを確認し、その場で更新できます。Burrow は表示名ではなく cask トークンで解決します。よく使われる App の中には、自称する名前とトークンが異なるものが十数個あるからです。

残存ファイル

逆方向の話です。すでに存在しない App に属する関連ファイル・環境設定・起動エージェントを扱います。Burrow はそれぞれを、残していった App に結びつけます。ですからあなたが承認するのは、パスの羅列ではなく「あの App の残り物」です。

まず片づける価値があるのは、削除済み App の起動エージェントです。 launchd はもう存在しないバイナリを起動しようとし続け、起動のたびにログを汚します。

メンテナンス

最適化

決まりきった作業を、ひとつの確認にまとめました。Quick Look の再構築、キャッシュとメタデータの修復、DNS の消去、ログイン項目の点検です。

チューンアップ

ひと通りでまとめて手入れします。ほとんど当てはまらない固定のチェックリストを並べるのではなく、いまのこの Mac に本当に必要なメンテナンスだけを選び、最後まで実行します。

ディスクを把握する

分析

ボリューム全体を、実際に確保されているバイト数の大きさでツリーマップに描きます。任意の枝を掘り下げれば一階層下の内訳が同じ形で見え、そのままメニューから Finder で表示したりゴミ箱に移したりできます。

「何がディスクを使っているのか」に答えるなら、並べ替えた一覧よりツリーマップのほうが向いています。いちばん食べているものが、スクロールして探す最初の行ではなく、いちばん大きな面積として目に入るからです。

大きなものを削除したのに空き容量が増えない場合、たいていはローカルの Time Machine スナップショットが押さえています。詳しくは ディスクは空いているのに「いっぱいです」と言われる理由.

マシンを見守る

ステータス

CPU・メモリ・GPU・ディスク・ネットワーク・バッテリーを、それぞれのスパークラインとともにひとつの画面に並べます。プロセス一覧はどの列でも並べ替えられ、見続けたい行は固定できます。Apple シリコンでは、ファンの回転数とダイの温度を SMC からネイティブに読み取ります。

履歴

ステータスが取得したサンプルはすべて、ローカルの SQLite ファイルに記録されます。5 分前から 90 日前まで自由にさかのぼれ、ファンが実際に回った瞬間についてはプロセスごとのピーク一覧も見られます。どこにも送信されません。

ポート

待ち受け中のポートと、そのプロセス、実行ファイルのパス、所有ユーザーをリアルタイムに表示します。lsof を実行しなくても、3000 番ポートを使っているプロセスがわかります。

ネットワーク

インターフェイスごと・プロセスごとの通信量をリアルタイムに表示します。アクティビティモニタの累計とは違い、こちらは速度なので、いま回線を埋めているプロセスがそのまま一番上に来ます。

接続を直す

接続が切れたときに地上へ戻るための道案内です。インターフェイスの状態、DNS の解決、ゲートウェイへの到達性、キャプティブポータルの検出を、順番に確認します。

App を開かなくても、メニューバーから全体像が下りてきます。リアルタイムの指標、上位のプロセス、そして必要なツールへの入口が並びます。

エージェントと MCP

Burrow は MCP サーバも兼ねているので、コーディングエージェントはあなたのソースコードから推測するのではなく、機械そのものに尋ねられます。公開しているツールは 26 個。うち 14 個は読み取り専用ですぐに使えます。この Mac を変更するツールは、設定で明示的に有効にしない限り、エージェントから呼び出すことすらできません。

Claude Code をこのアプリに向けます:

{
  "mcpServers": {
    "burrow": {
      "command": "/Applications/Burrow.app/Contents/MacOS/Burrow",
      "args": ["--mcp"]
    }
  }
}

読み取り専用のツール

burrow_snapshot, burrow_history, burrow_top_processes, burrow_process_usage, burrow_info, burrow_analyze, burrow_dupes, burrow_orphans, burrow_photos, burrow_ports, burrow_net, burrow_doctor, burrow_disk_forecast、 burrow_list_apps.

承認が必要なツール

burrow_clean, burrow_purge, burrow_uninstall, burrow_optimize、 burrow_installer はこの Mac を変更するため、あなたが有効にするまで使えません。

HTTP API

ループバックの HTTP API を 127.0.0.1:9277 で提供します。MCP ではなく HTTP を話すツール向けに、同じ読み取り専用データを返します。初期状態は有効で、設定から無効にできます。ループバックにのみ接続するため、ほかの機械からは決して届きません。

安全の考え方

Burrow は、間違えたときに失うのがデータではなく作り直しの手間で済むように作られています。次の 4 つのルールが、アプリのどこでも守られます。

  • 消す前に、見せる。 どの操作も、何かが動く前にファイルとバイト数を並べます。あなたが確認して、はじめて Burrow が動きます。
  • 結果の重さで並べる。 分類は削除しても安全な順に並び、作り直しに実際のコストがかかるものは、あなたが自分でチェックを入れるまで外れたままです。
  • 常駐する root ヘルパーを置かない。 管理者権限が必要なときは macOS 自身の認証ダイアログが確認し、Burrow はそのコマンドだけを実行してプロセスを終えます。特権を持ったデーモンが残り続けることはありません。
  • 自分で読める保護リスト。 決して削除対象にならないパスは、慣習ではなくコードで強制されており、そのソースは公開されています。

署名と公証

0.11.0 以降の macOS リリースはすべて Developer ID で署名され、Apple の公証を受けています。署名・公証・チケットの添付・Gatekeeper の検査がすべて成功しない限り、タグから公開することはできません。0.10.5 以前のアーカイブ版はこの保証より前のものです。Gatekeeper に止められた場合は、右クリックして「開く」を選んでください。

プライバシーと送信データ

ファイル、パス、URL、指標がこの Mac を出ることはありません。スキャン、履歴、MCP サーバは完全にローカルで完結します。

Burrow は匿名で、いつでも停止できる使用状況と診断情報を送信します。クラッシュとハングの報告、起動とアップデートの結果、名前が固定された性能計測の抽出です。画面を記録することはなく、ユーザーのファイルやその内容を送ることもありません。設定のスイッチひとつで両方とも止まり、ソースからビルドした場合は最初から無効です。

すべての項目は TELEMETRY.mdに記載しています。なお、このウェブサイトは別途、Cookie を使わない解析を利用しています。個人のプロフィールを作らず、ブラウザの識別子も保存せず、URL のクエリとフラグメントを取り除き、Do Not Track を尊重します。

困ったときは

Gatekeeper にアプリを止められる

0.11.0 以降では起きないはずです。もし起きたなら、ダウンロードの途中で改変された可能性が高いので、GitHub から取得し直してください。アーカイブ版の場合は、アプリを右クリックして「開く」を選んでください。

フルディスクアクセスを許可したのにスキャンが浅いまま

macOS はこの許可をアプリのコード署名に結びつけています。署名の異なるビルドで置き換えると無効になります。フルディスクアクセスの一覧から Burrow をいったん削除し、もう一度追加してください。

空き容量が増えない

ファイルを削除しても、ローカルの Time Machine スナップショットがまだ参照しているブロックは解放されません。macOS は容量が逼迫すると自動的にスナップショットを間引きます。 tmutil listlocalsnapshots / で、いま何があるかを確認できます。

エージェントに承認付きのツールが見えない

クリーン、削除、そのほか実際に手を加えるツールは、設定でエージェントの操作を有効にするまで隠れたままです。これは意図的なものです。あなたが別途承認していないものを、エージェントが削除できてはならないからです。