jarrodwatts/claude-hud

解決する課題

Claude HUDは、ユーザーの入力の下に、常に表示されるリアルタイムのステータスライン（HUD）を提供するClaude Code用プラグインです。コンテキストウィンドウの使用量、アクティブなツール、エージェントの進捗状況など、Claude Codeセッションの内部状態を、ユーザーが手動でシステムに問い合わせることなく可視化できないという問題を解決します。

仕組み

このプラグインは、Claude Codeのネイティブなstatusline APIを利用しています。stdinおよびtranscript JSONLファイルからJSONデータを処理して、トークン、ツールのアクティビティ、エージェントのステータスに関する情報を抽出します。その後、これらの情報をターミナルにフォーマットされたステータスラインとしてレンダリングし、スムーズなパフォーマンスを確保するために300msのデバウンスを設けて、各インタラクション後に再レンダリングします。

対象ユーザー

Claude Codeを使用しており、セッションのリソース使用量、プロジェクトのコンテキスト、AIの現在の活動を、常に一目で確認できるようにしたい開発者。

ハイライト

• リアルタイムモニタリング: コンテキストの健全性（ビジュアルバー付き）、使用率の制限、セッションの継続時間を追跡します。
• ツールとエージェントの追跡: アクティブなツール（read, edit, search）と実行中のサブエージェントのステータスを表示します。
• プロジェクトコンテキスト: 現在のプロジェクトパスとGitブランチのステータス（dirty状態を含む）を表示します。
• 高度なカスタマイズ性: プリセット（Full, Essential, Minimal）と、レイアウト、色、言語（English, Simplified Chinese, Traditional Chinese）のための詳細な設定システムを提供します。
• ネイティブ統合: tmuxなどの別ウィンドウを必要とせず、あらゆるターミナルで動作します。