/claude-statusbar

name: claude-statusbar
description: Manage `cs` (claude-statusbar) — switch the look (aurora blocks / aurora thin / classic) or density, override severity colors, preview the looks, 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, 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, 状态栏, 主题, 样式, 粗细, 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 status line in Claude Code.

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-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` | | Pick a look interactively (user is in their own terminal) | tell them to run `cs theme` — ↑/↓ with live previews, Enter applies; from Claude Code use the config commands below instead | | Hide the `✦ New looks available` line without picking | `cs config set looks_seen 1` (it goes away for good once `cs theme` has been opened) | | List styles | `cs styles` | | Aurora with ■ block bars (default look) | `cs config set style aurora` + `cs config set bar_glyph block` | | Aurora with a thin ━ line ("细一点") | `cs config set style aurora` + `cs config set bar_glyph thin` | | Original battery-bar look | `cs config set style classic` | | Change density | `cs config set density <compact\|regular\|cozy>` | | Show the three looks side by side | `cs preview` | | 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 the ocs line (`ocs boss · claude-7d5a5d07 · ✉3 · lan win`: address, unread DMs, LAN bridge; own line; auto-hidden without ocs ≥ 0.5.0, `✉` needs an ocs whose `inbox` accepts `--session`) | `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 off) | | 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` | | Narrow panes: stack the quota bars one per line instead of dropping forecast/projection | `cs config set narrow_layout stack\|drop` (default `drop`) | | Set warning threshold | `cs config set warning_threshold <0-100>` | | Set critical threshold | `cs config set critical_threshold <0-100>` | | 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 (also checks IPv4 and IPv6 exits separately against our own host — warns on an IPv4/IPv6 split, WARP, VPN/proxy, or an unsupported region