Headroom

Headroom

Windows PC の RAM とディスクを静かに監視します。

Headroom はシステムトレイに常駐し、短い履歴を保持して、何がいっぱいになっているかを表示します。クリーンアップの対象は許可リストに限定されています。削除するには YES と入力します。確認済みのファイルをごみ箱またはアーカイブフォルダーに移動するには MOVE と入力します。

Jasdish Singh。MIT、2026年。

できること

• RAM、コミットチャージ、ページファイル、空き容量を監視します。
• 履歴と短いレポート（ディスクの推移、リークの可能性、容量が増えたフォルダー）を記録します。
• user_temp、windows_temp、chrome_cache、edge_cache、firefox_cache、thumbnail_cache、recycle_bin のみをクリーンアップします。設定でパスを追加することはできません。
• ファイル、重複コピー、古いダウンロード、スタートアッププログラムを確認します。
• 127.0.0.1 でページを配信し、読み取り専用のデスクトップペット Roomy を表示します。
• ローカル MCP サーバーを公開します。clean、move、startup_disable はプランを返します。PC に変更を加えることはありません。

インストール

コマンドは headroom です。

Exe。 GitHub Releases から headroom-<version>-windows-x64.exe をダウンロードします。ポータブルな単一ファイルです。保持したいフォルダーに headroom.exe として保存してください。

winget、 マニフェストが承認された後：

winget install JasdishSingh.Headroom

pip。 PyPI での名前は headroom-pc です。Python 3.11 以降が必要です。

py -3.12 -m pip install "headroom-pc[tray]"
headroom status

tray を指定するとシステムトレイアイコンが追加されます。MCP サーバーは常に含まれています。

クイックスタート

headroom status
headroom top
headroom clean --dry-run
headroom watch
headroom dashboard

headroom watch はすぐにサンプルを取得し、その後は30秒ごとに取得します（バッテリー駆動時は間隔が長くなり、負荷が高いときは短くなります）。headroom install はサインイン時に起動するよう設定します。2つ目の watch、ダッシュボード、またはペットを起動しても、別のインスタンスは起動しません。

headroom dashboard は http://127.0.0.1:<port>/?token=... を表示して開きます。最初のサンプルが保存される前は、ページに現在の値が表示されます。

コマンド、デフォルト、終了コードについては、docs/commands.md を参照してください。

Roomy

Roomy は小さなベージュ色のモニターです。コードがしっぽになっています。少し歩き回り、吹き出しに「RAM 62% used」のように PC の RAM 使用率を表示します。クリーンアップ、移動、削除はできません。

headroom pet
headroom widget
headroom pet --skin midnight
headroom pet --skin tower --lite

headroom widget は同じペットです。クリックするとダッシュボードが開きます。ドラッグすると位置が記憶されます。右クリックでは、ダッシュボード、レポート、ミュート、非表示、終了を選択できます。

ダッシュボードには Roomy のオン／オフ切り替えがあります。これを使ってペットを起動または停止でき、再起動後も選択内容が記憶されるため、widget.autostart の設定より優先されます。

スキンとフレーム予算については、docs/roomy.md を参照してください。

MCP

headroom mcp は、この PC 上で動作する stdio サーバーです。インストール済みの exe をクライアントに指定します。

headroom.exe mcp

Claude Desktop（claude_desktop_config.json）：

{
  "mcpServers": {
    "headroom": {
      "command": "headroom.exe",
      "args": ["mcp"]
    }
  }
}

Cursor（.cursor/mcp.json）：

{
  "mcpServers": {
    "headroom": {
      "command": "headroom.exe",
      "args": ["mcp"]
    }
  }
}

Codex と ChatGPT（config.toml）：

[mcp_servers.headroom]
command = "headroom.exe"
args = ["mcp"]

pip パッケージを PATH に追加している場合、コマンドは headroom で、引数は引き続き mcp です。

mcp-name: io.github.Jasdish-Singh/headroom

AI でクイックスタート

MCP サーバーに接続した後、以下を Claude、ChatGPT、または Cursor に貼り付けてください。

You have access to Headroom, a local tool that monitors and protects this PC's RAM and disk.

Start a full health check:
1. Call `status` and tell me current RAM, commit, page file and free disk space in plain English.
2. Call `top` and list the 5 biggest RAM users, saying whether each is normal or worth closing.
3. Call `analyze` and `scan` to find what's taking up disk space, grouped into important, safe to clean, and needs my review.
4. Call `dupes` and `startup_list`, and point out duplicate files and startup apps slowing my PC.
5. Call `changes` and `report` to tell me what changed recently and any trends to watch.

Finish with a short summary: my overall PC health (good / watch / act now), the top 3 things to do, and how much space or RAM each would free.

Rules: only read and explain. If cleanup helps, call `clean`, `move` or `startup_disable` only to show me a plan. Never delete, move or disable anything yourself. I'll approve inside Headroom.

同じテキストは docs/ai-starter-prompt.md および MCP プロンプト health_check にあります。ツール一覧については、docs/commands.md を参照してください。

その他

• コマンド
• Roomy
• プラグイン
• ビルド
• 公開