m1ckc3s/claude-status-bar

解決する課題

Claude Codeのユーザーは、AIが「考えている」またはターミナルでツールを実行している間、待つ必要があることが多く、ターミナルウィンドウを常に注視していなければ、AIがアクティブかどうか、またはユーザーの許可を待っているかを把握するのが困難です。このアプリはmacOSのメニュー バーに視覚的なインジケータを提供し、ターミナルから離れていてもAIの状態を一目で確認できるようにします。

動作方法

このアプリはステートレスであり、~/.claude/settings.json ファイルにマージされたフックを通じて Claude Code と連携します。Claude Code の実行中にこれらのフックから更新をポーリングします。Claude Code セッションが開始されるとアプリは自動的に起動し、セッションが存在しなくなった時点で終了します。複数のライブセッションからのステータス更新を1つのメニュー バー アイコンに集約します。

対象ユーザー

Claude Code（CLI、デスクトップアプリ、またはCursor拡張経由）を使用するmacOSユーザーで、AIの活動状況や許可要求を邪魔しない方法で追跡したい方。

特徴

• リアルタイムステータス追跡：考え中／作業中の場合はアニメーションアイコン、許可待ちの場合は黄色のドット、現在のターンの経過時間をタイマーで表示。
• ツール使用のラベル表示：Claudeがツールを使用している際、「編集中」「読み込み中」「コマンド実行中」などのラベルを表示。
• マルチセッション対応：許可待ちのセッションを、考え中のセッションよりも優先し、ユーザーがブロックされないようにします。
• カスタマイズ可能なビジュアル：複数のアニメーションスタイル（Claude Spark、Claude Codeギフト、ピクセルアートのカニ）と色の選択（オレンジまたはシステム適応）を提供。
• 軽量でドック不要：使用状況ダッシュボードなしの軽量な体験。