claude-statusbar control skill
Use this skill any time the user wants to inspect, change, customize, or
diagnose the cs status bar. Replaces the older individual slash commands
(/statusbar, /statusbar-theme, /statusbar-style, /statusbar-preview,
/statusbar-doctor, /statusbar-reset) — they still work but this skill
covers all of them with conversational intent.
Decision tree
Match the user's intent to the right cs command. Run it via Bash, then
give a short confirmation (one line, no lecture).
| User intent |
Command |
| Inspect current config |
cs config show |
| List themes |
cs themes |
| List styles |
cs styles |
Switch theme to <name> |
cs config set theme <name> |
Switch style to <name> |
cs config set style <name> |
| Change density |
cs config set density <compact|regular|cozy> |
| Show all 27 combinations |
cs preview |
| Filter preview to one style/theme |
cs preview --style <s> or cs preview --theme <t> |
| Diagnose problem |
cs doctor |
| Return one key to its default |
cs config unset <key> (the config stores only what you changed) |
| Wipe config |
cs config reset |
| Install / first-time setup |
cs --setup |
| Upgrade / update to latest version |
cs upgrade — NEVER guess uv tool install / pip install -U / pipx upgrade: it detects the install channel that is actually running cs and picks the right one (many users don't have uv at all) |
| Turn auto-upgrade off |
cs config set auto_upgrade false (default true — a detached once-a-day check upgrades every install channel, binaries included; CLAUDE_STATUSBAR_NO_UPDATE=1 also wins) |
| Enable fast mode (daemon) |
cs --setup --fast |
| Disable fast mode |
cs daemon stop then re-run cs --setup |
| Toggle session cost display |
cs config set show_cost true|false |
| Toggle prompt-cache countdown |
cs config set show_cache_age true|false |
| Toggle project + branch 2nd line |
cs config set show_project_branch true|false (default true) |
| Toggle AgentParty/Codex bridge line |
cs config set show_party true|false (default true) |
Toggle ocs address (ocs boss · claude-7d5a5d07, own line; auto-hidden without ocs ≥ 0.5.0) |
cs config set show_ocs true|false (default true) |
Toggle todo progress (▸ task 3/7, 3rd line) |
cs config set show_todos true|false (default true) |
Toggle active-tool indicator ◐ (3rd line) |
cs config set show_tools true|false |
Toggle completed-tool rollup ✓ name×N (3rd line) |
cs config set show_tool_rollup true|false (default off — volume tally) |
| Toggle running-subagent bottom line(s) |
cs config set show_agents true|false (default off — Claude Code shows background agents natively) |
Toggle session duration ⏱ (on identity line) |
cs config set show_duration true|false |
Toggle lines added/removed +/- (on identity line) |
cs config set show_lines true|false |
Toggle git ahead/behind ↑↓ (on identity line) |
cs config set show_ahead_behind true|false |
Toggle the bar_shimmer twinkling starfield (experimental, classic only) |
cs config set bar_shimmer true|false (default off) |
| Toggle the rate-limit forecast (→NN% projected use / ⚠eta warning) |
cs config set show_forecast true|false (default on) |
Toggle the faint version + update hint at the identity-line end (· vX.Y.Z ↑new) |
cs config set show_version true|false (default on) |
| Toggle the ⚙ session-mode line (effort/thinking/fast/output-style) |
cs config set show_mode true|false (default on) |
| Toggle the per-effort colour gradient on the mode line |
cs config set mode_gradient true|false (default on) |
| Hide weekly bar |
cs config set show_weekly false |
| Set warning threshold |
cs config set warning_threshold <0-100> |
| Set critical threshold |
cs config set critical_threshold <0-100> |
| Auto-collapse to hairline below width |
cs config set auto_compact_width <px> |
| Force / disable no-quota (API) mode |
cs config set api_mode <auto|on|off> |
| Show working directory |
cs config set show_cwd true|false + cs config set cwd_style <basename|full> |
| Relay balance fuel gauge |
cs config set show_balance true|false + cs config set balance_bar true|false (no-quota mode only; auto-hidden when the relay has no balance API) |
| Exit-IP purity segment |
cs config set show_ip_risk true|false |
| Relay fingerprint-risk watermark |
cs config set show_fp_risk true|false |
Window-end projection →NN% |
cs config set show_projection true|false |
| Worktree marker glyph |
cs config set worktree_glyph 🌲 (default ⑂; any 1-2 cell symbol — an emoji ignores the theme color, the emoji font decides it) |
| Worktree marker color |
cs config set color_worktree "#bd93f9" (empty string restores the theme's hue) |
No-quota mode (third-party relay / Bedrock / Vertex)
When Claude Code points at a third-party relay (ANTHROPIC_BASE_URL ≠
api.anthropic.com) or a cloud backend (CLAUDE_CODE_USE_BEDROCK /
CLAUDE_CODE_USE_VERTEX), the official 5h/7d quota doesn't exist. cs detects
this and switches to a no-quota layout: the two quota battery bars are
dropped and the context window is promoted to its own ctx[…] battery bar
(green→yellow→red on 70/85% used), followed by the model name + the usual
live-activity tail. This mirrors claude-hud's behavior and is what to reach for
when a user says "用 API 就没状态了 / 连上下文都没了".
- Detection is automatic (
api_mode = auto, the default). A transcript-based
heuristic also catches relays whose env var didn't reach the statusLine
subprocess (an assistant turn exists yet quota never arrived → no-quota).
- Force it on a setup where auto-detect misses:
cs config set api_mode on
(or per-shell CS_API_MODE=on). Force the official layout back with
api_mode off. CS_API_MODE env wins over the saved config.
- Works under both the inline and fast-mode (daemon) render paths.
AgentParty / Codex bridge line
Claude Code support is the full native statusLine integration configured by
cs --setup. Codex support is narrower: when AgentParty writes
~/.agentparty/state/<workspaceId>/statusline.json for the current workspace,
cs appends a local-only line with channel, human/agent identity, listener
mode, unread count, and last-message preview.
Use cs config set show_party false to hide it. This bridge never calls the
AgentParty CLI, reads tokens, or makes network requests.
Per-severity color overrides (v3.4.1+)
The user can override the three severity colors independently of theme:
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
Accepts #rrggbb, #rgb, or bare rrggbb. The override layers on top of
whatever theme is active — no need to switch theme just to tune one color.
When user says "make 余量颜色 / safe color / green sharper", "warning
偏淡", "critical too red" — go to the override, not the theme.
Vibe → theme suggestion
If the user describes a vibe instead of naming a theme, suggest one and
ask before switching:
| Vibe / context |
Theme |
| Muted, professional, dark terminal |
graphite (default) |
| Soft, warm, dark |
twilight |
| Classic dev / Nord-inspired |
nord |
| High contrast, vivid |
dracula |
| Warm, cute, light bg |
sakura |
| Light terminal |
linen |
| Pure grayscale / no color |
mono |
| Popular pastel, easy on long viewing |
catppuccin-mocha |
| Deeper neon-blue mood |
tokyo-night |
Render anatomy (so you can explain what you're changing)
5h[██16% ░░░]⏰2h27m | 7d[██32% ░░]⏰4d05h | Opus 4.7(280k/1M) | $ 1.42 | cache 4m23s
└─ 5h ─────┘└──5h──┘ └─ 7d ──┘ └─7d─┘ └────context───────┘ └cost┘ └─cache─┘
Every numeric segment colors itself by its own severity (since v3.4):
- 5h →
theme.s_* chosen from msgs_pct
- 7d →
theme.s_* chosen from weekly_pct
- model+context →
theme.s_* chosen from ctx_used_pct (None → neutral)
- cache → its own string-age severity (COLD → red, <1m → yellow, else green)
[ ], ( ), | → theme.mute (recede behind data)
Common diagnostic flows
"Status bar isn't showing" → cs doctor. It self-checks:
- Claude Code's
~/.claude/settings.json has the statusLine block
- the
cs binary is on PATH
- whether the daemon is alive (if fast-mode configured)
- whether the cache files are stale
"refreshInterval too high" → cs doctor will recommend cs --setup --fast
when it sees refreshInterval ≤ 2s on the inline command. Fast mode drops
1Hz CPU from ~6% to ~2%.
"Color won't change after cs config set theme X" → check the user
isn't on a Claude Code session that read settings.json at start. Ask
them to send a new prompt; the next render picks up the new theme.
"Codex / AgentParty name isn't showing" → confirm AgentParty has written
~/.agentparty/state/<workspaceId>/statusline.json for the current cwd and
that show_party is still true.
Don't
- Don't lecture about ANSI codes or terminal compatibility unless asked.
- Don't suggest editing
~/.claude/claude-statusbar.json by hand. Use
cs config set <key> <value>.
- Don't change theme just to fix one color — use
color_ok / color_warn / color_hot overrides.
- Don't run destructive commands (
cs config reset, cs daemon stop)
without confirming with the user.
Style of response
Be terse. Run the command, paste the one-line confirmation, point at the
next step if relevant. The status bar is on screen — they can see the
result immediately, no need to describe it.
1---2name: claude-statusbar3description: Manage `cs` (claude-statusbar) — switch theme/style/density, override severity colors, preview combinations, run doctor, reset config, install, upgrade (`cs upgrade` — the only supported upgrade path), or remove the bar, toggle fast/daemon mode, show cost or prompt-cache age, toggle the AgentParty/Codex bridge line, or toggle the activity segments (todos, active tool, running subagents, session duration, lines changed, git ahead/behind). Use whenever the user mentions cs, claude-statusbar, status bar, status line, 状态栏, AgentParty, Codex, show_party, 主题, theme switching, style switching, color customization, 余量颜色, 警告颜色, severity color, /statusbar, cs preview, cs doctor, fast mode, daemon, refreshInterval, 5h/7d window, context window display, prompt cache, todos / 待办, active tool, subagents / 子agent, session duration / 时长, lines changed / 行数, git ahead-behind / 领先落后, forecast / 预测 / 还能用多久, at-risk chip, show_forecast, or asks to install / upgrade / update / 升级 / configure / diagnose / customize the bottom stat4---56# claude-statusbar control skill78Use this skill any time the user wants to inspect, change, customize, or9diagnose the `cs` status bar. Replaces the older individual slash commands10(`/statusbar`, `/statusbar-theme`, `/statusbar-style`, `/statusbar-preview`,11`/statusbar-doctor`, `/statusbar-reset`) — they still work but this skill12covers all of them with conversational intent.1314## Decision tree1516Match the user's intent to the right `cs` command. Run it via Bash, then17give a short confirmation (one line, no lecture).1819| User intent | Command |20|---|---|21| Inspect current config | `cs config show` |22| List themes | `cs themes` |23| List styles | `cs styles` |24| Switch theme to `<name>` | `cs config set theme <name>` |25| Switch style to `<name>` | `cs config set style <name>` |26| Change density | `cs config set density <compact\|regular\|cozy>` |27| Show all 27 combinations | `cs preview` |28| Filter preview to one style/theme | `cs preview --style <s>` or `cs preview --theme <t>` |29| Diagnose problem | `cs doctor` |30| Return one key to its default | `cs config unset <key>` (the config stores only what you changed) |31| Wipe config | `cs config reset` |32| Install / first-time setup | `cs --setup` |33| Upgrade / update to latest version | `cs upgrade` — NEVER guess `uv tool install` / `pip install -U` / `pipx upgrade`: it detects the install channel that is actually running `cs` and picks the right one (many users don't have uv at all) |34| Turn auto-upgrade off | `cs config set auto_upgrade false` (default `true` — a detached once-a-day check upgrades every install channel, binaries included; `CLAUDE_STATUSBAR_NO_UPDATE=1` also wins) |35| Enable fast mode (daemon) | `cs --setup --fast` |36| Disable fast mode | `cs daemon stop` then re-run `cs --setup` |37| Toggle session cost display | `cs config set show_cost true\|false` |38| Toggle prompt-cache countdown | `cs config set show_cache_age true\|false` |39| Toggle project + branch 2nd line | `cs config set show_project_branch true\|false` (default `true`) |40| Toggle AgentParty/Codex bridge line | `cs config set show_party true\|false` (default `true`) |41| Toggle ocs address (`ocs boss · claude-7d5a5d07`, own line; auto-hidden without ocs ≥ 0.5.0) | `cs config set show_ocs true\|false` (default `true`) |42| Toggle todo progress (`▸ task 3/7`, 3rd line) | `cs config set show_todos true\|false` (default `true`) |43| Toggle active-tool indicator `◐` (3rd line) | `cs config set show_tools true\|false` |44| Toggle completed-tool rollup `✓ name×N` (3rd line) | `cs config set show_tool_rollup true\|false` (default off — volume tally) |45| Toggle running-subagent bottom line(s) | `cs config set show_agents true\|false` (default off — Claude Code shows background agents natively) |46| Toggle session duration `⏱` (on identity line) | `cs config set show_duration true\|false` |47| Toggle lines added/removed `+/-` (on identity line) | `cs config set show_lines true\|false` |48| Toggle git ahead/behind `↑↓` (on identity line) | `cs config set show_ahead_behind true\|false` |49| Toggle the `bar_shimmer` twinkling starfield (experimental, classic only) | `cs config set bar_shimmer true\|false` (default off) |50| Toggle the rate-limit forecast (→NN% projected use / ⚠eta warning) | `cs config set show_forecast true\|false` (default on) |51| Toggle the faint version + update hint at the identity-line end (`· vX.Y.Z ↑new`) | `cs config set show_version true\|false` (default on) |52| Toggle the ⚙ session-mode line (effort/thinking/fast/output-style) | `cs config set show_mode true\|false` (default on) |53| Toggle the per-effort colour gradient on the mode line | `cs config set mode_gradient true\|false` (default on) |54| Hide weekly bar | `cs config set show_weekly false` |55| Set warning threshold | `cs config set warning_threshold <0-100>` |56| Set critical threshold | `cs config set critical_threshold <0-100>` |57| Auto-collapse to hairline below width | `cs config set auto_compact_width <px>` |58| Force / disable no-quota (API) mode | `cs config set api_mode <auto\|on\|off>` |59| Show working directory | `cs config set show_cwd true\|false` + `cs config set cwd_style <basename\|full>` |60| Relay balance fuel gauge | `cs config set show_balance true\|false` + `cs config set balance_bar true\|false` (no-quota mode only; auto-hidden when the relay has no balance API) |61| Exit-IP purity segment | `cs config set show_ip_risk true\|false` |62| Relay fingerprint-risk watermark | `cs config set show_fp_risk true\|false` |63| Window-end projection `→NN%` | `cs config set show_projection true\|false` |64| Worktree marker glyph | `cs config set worktree_glyph 🌲` (default `⑂`; any 1-2 cell symbol — an emoji ignores the theme color, the emoji font decides it) |65| Worktree marker color | `cs config set color_worktree "#bd93f9"` (empty string restores the theme's hue) |6667## No-quota mode (third-party relay / Bedrock / Vertex)6869When Claude Code points at a third-party relay (`ANTHROPIC_BASE_URL` ≠70`api.anthropic.com`) or a cloud backend (`CLAUDE_CODE_USE_BEDROCK` /71`CLAUDE_CODE_USE_VERTEX`), the official 5h/7d quota doesn't exist. cs detects72this and switches to a **no-quota layout**: the two quota battery bars are73dropped and the **context window is promoted to its own `ctx[…]` battery bar**74(green→yellow→red on 70/85% used), followed by the model name + the usual75live-activity tail. This mirrors claude-hud's behavior and is what to reach for76when a user says "用 API 就没状态了 / 连上下文都没了".7778- Detection is automatic (`api_mode = auto`, the default). A transcript-based79 heuristic also catches relays whose env var didn't reach the statusLine80 subprocess (an assistant turn exists yet quota never arrived → no-quota).81- Force it on a setup where auto-detect misses: `cs config set api_mode on`82 (or per-shell `CS_API_MODE=on`). Force the official layout back with83 `api_mode off`. `CS_API_MODE` env wins over the saved config.84- Works under both the inline and fast-mode (daemon) render paths.8586## AgentParty / Codex bridge line8788Claude Code support is the full native `statusLine` integration configured by89`cs --setup`. Codex support is narrower: when AgentParty writes90`~/.agentparty/state/<workspaceId>/statusline.json` for the current workspace,91`cs` appends a local-only line with channel, human/agent identity, listener92mode, unread count, and last-message preview.9394Use `cs config set show_party false` to hide it. This bridge never calls the95AgentParty CLI, reads tokens, or makes network requests.9697## Per-severity color overrides (v3.4.1+)9899The user can override the three severity colors independently of theme:100101```bash102cs config set color_ok "#4ec85b" # calm / safe103cs config set color_warn "#e8b260" # warning104cs config set color_hot "#e87474" # critical105106cs config set color_ok "" # clear back to theme default107```108109Accepts `#rrggbb`, `#rgb`, or bare `rrggbb`. The override layers on top of110whatever theme is active — no need to switch theme just to tune one color.111112**When user says** "make 余量颜色 / safe color / green sharper", "warning113偏淡", "critical too red" — go to the override, not the theme.114115## Vibe → theme suggestion116117If the user describes a vibe instead of naming a theme, suggest one and118ask before switching:119120| Vibe / context | Theme |121|---|---|122| Muted, professional, dark terminal | `graphite` (default) |123| Soft, warm, dark | `twilight` |124| Classic dev / Nord-inspired | `nord` |125| High contrast, vivid | `dracula` |126| Warm, cute, light bg | `sakura` |127| Light terminal | `linen` |128| Pure grayscale / no color | `mono` |129| Popular pastel, easy on long viewing | `catppuccin-mocha` |130| Deeper neon-blue mood | `tokyo-night` |131132## Render anatomy (so you can explain what you're changing)133134```1355h[██16% ░░░]⏰2h27m | 7d[██32% ░░]⏰4d05h | Opus 4.7(280k/1M) | $ 1.42 | cache 4m23s136└─ 5h ─────┘└──5h──┘ └─ 7d ──┘ └─7d─┘ └────context───────┘ └cost┘ └─cache─┘137```138139Every numeric segment colors itself by its own severity (since v3.4):140- 5h → `theme.s_*` chosen from `msgs_pct`141- 7d → `theme.s_*` chosen from `weekly_pct`142- model+context → `theme.s_*` chosen from `ctx_used_pct` (None → neutral)143- cache → its own string-age severity (COLD → red, <1m → yellow, else green)144- `[ ]`, `( )`, ` | ` → `theme.mute` (recede behind data)145146## Common diagnostic flows147148**"Status bar isn't showing"** → `cs doctor`. It self-checks:149- Claude Code's `~/.claude/settings.json` has the `statusLine` block150- the `cs` binary is on PATH151- whether the daemon is alive (if fast-mode configured)152- whether the cache files are stale153154**"refreshInterval too high"** → `cs doctor` will recommend `cs --setup --fast`155when it sees `refreshInterval ≤ 2s` on the inline command. Fast mode drops1561Hz CPU from ~6% to ~2%.157158**"Color won't change after `cs config set theme X`"** → check the user159isn't on a Claude Code session that read `settings.json` at start. Ask160them to send a new prompt; the next render picks up the new theme.161162**"Codex / AgentParty name isn't showing"** → confirm AgentParty has written163`~/.agentparty/state/<workspaceId>/statusline.json` for the current cwd and164that `show_party` is still true.165166## Don't167168- Don't lecture about ANSI codes or terminal compatibility unless asked.169- Don't suggest editing `~/.claude/claude-statusbar.json` by hand. Use170 `cs config set <key> <value>`.171- Don't change theme just to fix one color — use `color_ok / color_warn /172 color_hot` overrides.173- Don't run destructive commands (`cs config reset`, `cs daemon stop`)174 without confirming with the user.175176## Style of response177178Be terse. Run the command, paste the one-line confirmation, point at the179next step if relevant. The status bar is on screen — they can see the180result immediately, no need to describe it.
leeguooooo