使用量とレート制限

作業の途中でレート制限に当たるのは最悪の中断です。purplemux は Claude Code のクォータ数値をサイドバーに引き込み、利用リズムを一目で把握できる統計ダッシュボードを追加します。

サイドバーウィジェット

サイドバー下部に 2 本の細いバーが並びます: 5h と 7d。それぞれが表示するのは:

• 期間内で消費した割合
• リセットまでの残り時間
• 現在のペースを維持した場合の到達点を示す薄い予測バー

任意のバーにホバーすると完全な内訳が見られます — 使用済みパーセンテージ、予測パーセンテージ、リセット時刻 (相対時間)。

数値は Claude Code 自身のステータスライン JSON から来ます。purplemux は小さな ~/.purplemux/statusline.sh スクリプトをインストールし、Claude がステータスラインを更新するたびにデータをローカルサーバに POST します。fs.watch が UI を同期させ続けます。

色のしきい値

両方のバーは使用率に基づいて色を変えます:

しきい値はランディングページのレート制限ウィジェットと一致しています。アンバーを何度か見れば、サイドバーは周辺視野でペースを取るためのツールになります — 意識せず、でも自然に作業をウィンドウ間に分散させるようになります。

統計ダッシュボード

サイドバーから (または ⌘⇧U で) ダッシュボードを開きます。上から順に 5 つのセクション:

概要カード

4 枚のカード: 総セッション数、総コスト、今日のコスト、今月のコスト。各カードは前期間との変化を緑または赤で表示します。

モデル別トークン使用量

日ごとのスタック棒グラフで、モデルとトークンタイプ — 入力、出力、キャッシュ読込、キャッシュ書込 — に分解されます。モデルの凡例は Claude の表示名 (Opus / Sonnet / Haiku) を使い、サイドバーバーと同じ色味です。

これは、たとえば予期せぬコスト急増が Opus 中心の日だったとか、キャッシュ読込が大半の作業を担っているといった発見をするのに最適な場所です。

プロジェクト別内訳

使用したすべての Claude Code プロジェクト (作業ディレクトリ) のテーブルで、セッション数、メッセージ数、トークン、コストを表示します。行をクリックするとそのプロジェクトだけの日ごとチャートが表示されます。

共有マシンや、クライアント業務と個人の試作を分けたい場合に便利です。

活動とストリーク

30 日間の日次活動エリアチャートと、4 つのストリーク指標:

• 最長ストリーク — 連続作業日数の最高記録
• 現在のストリーク — 現時点で何日連続で作業しているか
• 総活動日数 — 期間内のカウント
• 1 日あたりの平均セッション数

週次タイムライン

過去 1 週間で実際に Claude を使った時間を示す日 × 時間のグリッド。同時セッションは視覚的に重なるので、火曜日の 15 時に 5 セッション同時、のような状況が一目でわかります。

データの出どころ

ダッシュボードのすべては ~/.claude/projects/ の Claude Code 自身のセッション JSONL からローカルで計算されます。purplemux はそれを読み、解析済みカウントを ~/.purplemux/stats/ にキャッシュし、1 バイトもマシン外に送りません。言語切替やキャッシュ再生成でもどこにも問い合わせません。

リセットの挙動

5 時間と 7 日のウィンドウはローリングで、Claude Code アカウントに紐付いています。ウィンドウがリセットされると、バーは 0 % に落ち、次のリセットタイムスタンプから割合と残り時間が再計算されます。purplemux がリセットを取り逃した場合 (サーバが停止していたなど) も、次のステータスラインのティックでウィジェットが自己修正します。

次のステップ

• ノート (AI 日次レポート) — 同じデータを日次のブリーフとして書き起こしたもの。
• セッションステータス — サイドバーがタブ単位で追跡しているもう 1 つのもの。
• キーボードショートカット — 統計の ⌘⇧U も含む。