leeguooooo/claude-code-usage-bar

解決する課題

Claude Code は、レート制限、コンテキストウィンドウの使用状況、プロンプトキャッシュの状態について、詳細かつリアルタイムでの可視性を提供していません。このプロジェクトにより、残りのクォータやリセット時刻を確認するためにウィンドウやコンテキストを切り替える必要がなくなります。

動作方法

Claude Code の statusLine に直接統合され、ターミナル上に表示されるか、macOS デスクトップアプリ用の浮動HUDとして提供されます。公式の5時間および7日間のレート制限を追跡し、現在のモデルとコンテキストウィンドウの使用率を監視し、プロンプトキャッシュの「温かさ」が持続するまでのカウントダウンを計算します。1秒ごとにデータを更新しながら、低負荷のデーモンとして動作可能で、CPU使用率は1%未満に抑えられます。

対象ユーザー

Claude Code や Claude デスクトップアプリを使用し、API使用状況やセッションステータスを即座に確認できるリアルタイムダッシュボードを求める開発者やパワーユーザー。

主な特徴

• 公式レート追跡: 5時間/7日間の使用状況バーとリセットカウントダウン、ウィンドウ終了予測を表示。
• キャッシュ監視: プロンプトキャッシュが「温かさ」を保つまでのカウントダウンタイマーを提供。
• 二重インターフェース: ターミナルのステータスラインと macOS 浮動HUDの両方をサポート。
• カスタマイズ可能: スタイル3種類、テーマ9種類でステータスバーの外観を変更可能。
• 低負荷: オプションのデーモンモードにより、CPUへの影響を最小限に抑える。
• 依存関係ゼロのインストール: プリビルドバイナリまたは Python パッケージとして利用可能。