/claude-statusbar
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,
$ npx -y skills add leeguooooo/claude-code-usage-bar --skill claude-statusbar --agent claude-codeHow it fires
How this skill gets triggered: by you, by Claude, or both.
- Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
- You can call itInvoke it directly when you want it.
- Slash command
/claude-statusbar
Context preview
The summary Claude sees to decide when to auto-load this skill.
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,
SKILL.md
claude-statusbar.SKILL.mdname: claude-statusbar
description: 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 status line in Claude Code or Codex/AgentParty workflows.
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 re
Read more
name: claude-statusbar description: 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 status line in Claude Code or Codex/AgentParty workflows.
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 re
Your Claude Code usage, at a glance. 5h / 7d rate-limit bars, reset countdowns, model, context window, and prompt-cache freshness — inline in Claude Code's status line, or a floating HUD on the desktop app. macOS standalone users should upgrade to v3.32.5 now.