claude-statusbar

claude-statusbar control スキル

ユーザーが cs ステータスバーの確認、変更、カスタマイズ、診断を希望した場合は、いつでもこのスキルを使います。従来の個別スラッシュコマンド（/statusbar、/statusbar-theme、/statusbar-style、/statusbar-preview、/statusbar-doctor、/statusbar-reset）に代わるものです。これらのコマンドも引き続き使えますが、このスキルですべての会話上の意図に対応できます。

意図の判定

ユーザーの意図に合った cs コマンドを選びます。Bash で実行してから、簡潔に（1行で、講釈せずに）確認します。

ユーザーの目的	コマンド
現在の設定を確認する	cs config show
テーマを一覧表示する	cs themes
スタイルを一覧表示する	cs styles
テーマを <name> に切り替える	cs config set theme <name>
スタイルを <name> に切り替える	cs config set style <name>
密度を変更する	cs config set density <compact|regular|cozy>
27 通りの組み合わせをすべて表示する	cs preview
プレビューを 1 つのスタイル／テーマに絞り込む	cs preview --style <s> or cs preview --theme <t>
問題を診断する	cs doctor
1 つのキーをデフォルトに戻す	cs config unset <key>（設定には変更した項目だけが保存されます）
設定を消去する	cs config reset
インストール／初回セットアップ	cs --setup
最新バージョンにアップグレード／更新する	cs upgrade — uv tool install／pip install -U／pipx upgrade を決して推測して使わないでください。実行中の cs が実際に使用しているインストール経路を検出し、適切な方法を選択します（uv をまったく使っていないユーザーも多くいます）
自動アップグレードを無効にする	cs config set auto_upgrade false（デフォルトは true — 1 日 1 回、切り離されたチェックがバイナリを含むすべてのインストール経路をアップグレードします。CLAUDE_STATUSBAR_NO_UPDATE=1 も優先されます）
高速モード（デーモン）を有効にする	cs --setup --fast
高速モードを無効にする	cs daemon stop を実行してから、cs --setup を再実行します
セッションコスト表示を切り替える	cs config set show_cost true|false
プロンプトキャッシュのカウントダウン表示を切り替える	cs config set show_cache_age true|false
プロジェクトとブランチの 2 行目表示を切り替える	cs config set show_project_branch true|false（デフォルトは true）
ocs の行（ocs boss · claude-7d5a5d07 · ✉3 · lan win：アドレス、未読 DM、LAN ブリッジ。独立した行。ocs ≥ 0.5.0 がない場合は自動的に非表示。✉ を表示するには、inbox が --session を受け付ける ocs が必要）を切り替える	cs config set show_ocs true|false（デフォルトは true）
ToDo の進捗（▸ task 3/7、3 行目）表示を切り替える	cs config set show_todos true|false（デフォルトは true）
アクティブなツールのインジケーター ◐（3 行目）表示を切り替える	cs config set show_tools true|false
完了したツールの集計 ✓ name×N（3 行目）表示を切り替える	cs config set show_tool_rollup true|false（デフォルトはオフ — 使用量の集計）
実行中のサブエージェントの最下行表示を切り替える	cs config set show_agents true|false（デフォルトはオフ — Claude Code はバックグラウンドエージェントを標準で表示します）
セッション時間 ⏱（識別情報の行）表示を切り替える	cs config set show_duration true|false
追加／削除行数 +/-（識別情報の行）表示を切り替える	cs config set show_lines true|false
Git の ahead／behind ↑↓（識別情報の行）表示を切り替える	cs config set show_ahead_behind true|false
bar_shimmer のきらめく星空（実験的機能、クラシックのみ）を切り替える	cs config set bar_shimmer true|false（デフォルトはオフ）
レート制限の予測（→NN% の使用率予測／⚠eta 警告）表示を切り替える	cs config set show_forecast true|false（デフォルトはオン）
識別情報の行末に薄く表示されるバージョンと更新のヒント（· vX.Y.Z ↑new）を切り替える	cs config set show_version true|false（デフォルトはオン）
⚙ セッションモードの行（effort／thinking／fast／output-style）表示を切り替える	cs config set show_mode true|false（デフォルトはオン）
モードの行にある effort ごとのカラーグラデーションを切り替える	cs config set mode_gradient true|false（デフォルトはオン）
週間バーを非表示にする	cs config set show_weekly false
警告のしきい値を設定する	cs config set warning_threshold <0-100>
重大警告のしきい値を設定する	cs config set critical_threshold <0-100>
指定した幅を下回るとヘアライン表示に自動的に折りたたむ	cs config set auto_compact_width <px>
クォータなし（API）モードを強制／無効にする	cs config set api_mode <auto|on|off>
作業ディレクトリを表示する	cs config set show_cwd true|false + cs config set cwd_style <basename|full>
リレーの残高燃料計	cs config set show_balance true|false + cs config set balance_bar true|false（クォータなしモードのみ。リレーに残高 API がない場合は自動的に非表示）
出口 IP の健全性セグメント（IPv4 と IPv6 の出口をそれぞれ独自のホストと照合します。IPv4／IPv6 の不一致、WARP、VPN／プロキシ、または未対応の地域の場合に警告します。Anthropic には接続しません。また、ドメインごとのプロキシルールにより claude.ai が別経路で接続される場合があります）	cs config set show_ip_risk true|false
リレーのフィンガープリントリスクの透かし表示	cs config set show_fp_risk true|false
ウィンドウ終了時の予測 →NN% 表示	cs config set show_projection true|false
Worktree マーカーのグリフ	cs config set worktree_glyph 🌲（デフォルトは ⑂。1～2 セルの任意の記号を指定できます。絵文字はテーマの色を無視し、絵文字フォントによって表示が決まります）
Worktree マーカーの色	cs config set color_worktree "#bd93f9"（空の文字列を指定すると、テーマの色に戻ります）

クォータなしモード（サードパーティーのリレー／Bedrock／Vertex）

Claude Code の接続先がサードパーティーのリレー（ANTHROPIC_BASE_URL ≠ api.anthropic.com）またはクラウドバックエンド（CLAUDE_CODE_USE_BEDROCK / CLAUDE_CODE_USE_VERTEX）の場合、公式の 5h／7d クォータは存在しません。cs はこれを検知して クォータなしレイアウトに切り替えます。2 本のクォータ残量バーは表示されなくなり、コンテキストウィンドウが独立した ctx[…] 残量バーとして表示されます （使用率 70／85% で緑→黄→赤）。その後にモデル名と、通常のリアルタイムアクティビティ表示が続きます。これは claude-hud の動作を踏襲したもので、「API を使うとステータスが消える／コンテキストまで表示されなくなる」と言われたときに使う機能です。

• 検知は自動です（api_mode = auto がデフォルトです）。トランスクリプトベースのヒューリスティックでも、環境変数が statusLine のサブプロセスに渡されなかったリレーを検知できます（アシスタントのターンは存在するのにクォータ情報が届かない場合は、クォータなしと判定します）。
• 自動検知で見逃される環境で強制的に有効にするには、cs config set api_mode on（またはシェルごとに CS_API_MODE=on）を実行します。公式レイアウトに戻すには api_mode off を指定します。CS_API_MODE 環境変数は保存済みの設定より優先されます。
• インラインとファストモード（デーモン）の両方の描画経路で動作します。

重大度ごとの色の上書き（v3.4.1 以降）

ユーザーはテーマとは別に、3 段階の重大度の色を個別に上書きできます。

cs config set color_ok   "#4ec85b"   # calm / safe
cs config set color_warn "#e8b260"   # warning
cs config set color_hot  "#e87474"   # critical

cs config set color_ok ""            # clear back to theme default

#rrggbb、#rgb、または rrggbb の形式を指定できます。上書きは現在のテーマに重ねて適用されるため、1 色を調整するだけならテーマを切り替える必要はありません。

ユーザーが「余量颜色／安全色／緑をもっと鮮やかに」「警告の色が薄すぎる」「重大の色が赤すぎる」と言った場合は、テーマではなく色の上書きを使います。

雰囲気に合わせたテーマの提案

テーマ名ではなく雰囲気を説明された場合は、テーマを提案し、切り替える前に確認してください。

雰囲気／状況	テーマ
落ち着いた、プロフェッショナル、ダークなターミナル	graphite（デフォルト）
柔らかく、温かみのある、ダークな表示	twilight
クラシックな開発環境／Nord に着想を得たスタイル	nord
高コントラスト、鮮やか	dracula
温かみがあり、かわいらしい、明るい背景	sakura
明るいターミナル	linen
純粋なグレースケール／色なし	mono
人気のパステルカラー、長時間見ても目に優しい	catppuccin-mocha
深みのあるネオンブルーの雰囲気	tokyo-night

描画の構成（変更内容を説明するため）

5h[██16% ░░░]⏰2h27m | 7d[██32%  ░░]⏰4d05h | Opus 4.7(280k/1M) | $ 1.42 | cache 4m23s
└─ 5h ─────┘└──5h──┘  └─ 7d ──┘ └─7d─┘   └────context───────┘  └cost┘  └─cache─┘

各数値セグメントは、それぞれの重大度に応じて色分けされます（v3.4 以降）。

• 5h → msgs_pct に基づいて選ばれる theme.s_*
• 7d → weekly_pct に基づいて選ばれる theme.s_*
• モデル＋コンテキスト → ctx_used_pct に基づいて選ばれる theme.s_*（None の場合はニュートラル）
• キャッシュ → 経過時間に応じて独自に色分け（COLD → 赤、1 分未満 → 黄、それ以外 → 緑）
• [ ]、( )、| → theme.mute（データの背後に控えめに表示）

よくある診断フロー

「ステータスバーが表示されない」 → cs doctor を実行します。次の項目を自己診断します。

• Claude Code の ~/.claude/settings.json に statusLine ブロックがあるか
• cs バイナリが PATH 上にあるか
• デーモンが稼働しているか（ファストモードが設定されている場合）
• キャッシュファイルが古くなっていないか

「refreshInterval の値が大きすぎる」 → インラインコマンドの refreshInterval ≤ 2s を検出すると、cs doctor が cs --setup --fast を推奨します。ファストモードでは 1Hz 動作時の CPU 使用率が約 6% から約 2% に下がります。

「cs config set theme X を実行しても色が変わらない」 → settings.json を起動時に読み込んだままの Claude Code セッションを使っていないか確認します。新しいプロンプトを送ってもらってください。次の描画から新しいテーマが反映されます。

やってはいけないこと

• 指示されない限り、ANSI コードやターミナルの互換性について長々と説明しないでください。
• ~/.claude/claude-statusbar.json を手動で編集するよう勧めないでください。cs config set <key> <value> を使ってください。
• 1 色を直すためだけにテーマを変更しないでください。color_ok / color_warn / color_hot の上書きを使ってください。
• ユーザーに確認せず、破壊的なコマンド（cs config reset、cs daemon stop）を実行しないでください。

返信のスタイル

簡潔にしてください。コマンドを実行し、1 行の確認メッセージを貼り付け、必要なら次の手順を案内します。ステータスバーは画面上に表示されているため、結果をすぐに確認できます。説明する必要はありません。