gglucass/headroom-desktop

Menu Bar App on MacOS and Windows that cuts Claude Code and Codex token costs by ~50%

Headroom Desktop

概要: コード生成ツール(Claude Code、OpenAI Codex、OpenCode AI、Grok Build)とそれらが呼び出すLLM APIの間に配置される、クロスプラットフォームのデスクトップトレイアプリです。ローカルの最適化パイプラインを実行し、プロンプト、ツール出力、ログを圧縮することで、結果を変えずにモデルへ送信されるトークン数を約半分に削減します。

重要性: トークン使用量は、LLMを活用したコーディングアシスタントにおける最大のコスト要因です。ボイラープレート、冗長なJSON、古い会話履歴をリクエストがモデルに到達する前に削除することで、Headroomはワークフローを変更することなく、Claude CodeやCodexの利用料金を半減させることができます。

仕組み:

  • TauriベースのRustトレイアプリが、127.0.0.1:6767 でローカルHTTPプロキシを起動します。
  • コーディングクライアントは、(小さなフックや環境変数を通じて)そのプロキシを指すように自動的に再設定されます。
  • プロキシはリクエストを2番目のローカルポートで管理されるPythonランタイム(headroom + オプションツール)に転送し、そこで最適化された後、AnthropicやOpenAIの本来のエンドポイントへ送信されます。
  • レスポンスは同じ経路で戻り、必要に応じて元のコンテンツが復元されます。
  • UIには、トークン節約量のライブダッシュボード、クライアントごとの統計、オプションの追加ツールが表示されます。

技術的な詳細:

  • ホストを汚染しない – Headroomはアプリデータフォルダ内に独自の独立したPython(約3GB)をインストールします。システムPythonやグローバルな PATH には一切触れません。
  • クロスプラットフォーム – macOS (universal)、Windows 10+、Linux (preview) のビルドが単一のタグから提供されます。
  • 拡張性 – オプションのアドオン(rtk, markitdown, serenaなど)をUIから有効化でき、すべてローカルで実行されます。
  • オープンソースシェル – デスクトップUIとプロキシコードはMITライセンスです。サブスクリプションサービスとバックエンドは非公開です。
  • 安全性 – 設定変更はバックアップされ、終了やアンインストール時にはすべてのリダイレクトが削除されるため、クライアントは以前と全く同じように動作します。

対象ユーザー: すでにClaude Code、Codex、OpenCode、Grok Buildを使用しており、ツールを書き換えることなくトークン料金を削減したい開発者。また、予測可能でローカルホスト型の最適化レイヤーを必要とするAIエージェント開発者にも適しています。

インストール: macOSの場合はHomebrew cask、またはGitHubのリリースページからDMG/EXE/AppImageを直接ダウンロードしてください。アプリはmacOS上で署名/公証されており、組み込みのアップデーターが含まれています。

ライセンス: デスクトップシェル(src/ および src-tauri/)はMITライセンスです。アプリの実行には有料のHeadroomアカウントが必要です(7日間の無料トライアルあり)。

関連

  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト
  • プロジェクト