Agent skill

Claude Statusbar

by leeguooooo in leeguooooo/claude-code-usage-bar

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)…

MITAuto-check passedAgent Workflows

Install Claude Statusbar

skills CLI
$ npx skills add leeguooooo/claude-code-usage-bar --skill claude-statusbar -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install leeguooooo/claude-code-usage-bar claude-statusbar --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/leeguooooo/claude-code-usage-bar.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/claude-statusbar .claude/skills/claude-statusbar && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
claude-statusbar
GitHub stars
378
Token cost
~2.5k tokens
SKILL.md length
1,144 words
Files
1
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

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)…

  • The user mentions cs
  • SKILL.md covers Decision tree, No-quota mode (third-party…, Per-severity color overrides… and Vibe → theme suggestion, plus 4 more sections
  • Calls uv, pip and pipx
  • Claude-statusbar

What it does

Claude Statusbar is an agent skill from leeguooooo/claude-code-usage-bar. 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, 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…

Its SKILL.md is about 2.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Agent Workflows, covering Context engineering, Subagents and Rate limiting. It works with Git and Python. The repository describes itself as: Lightweight Claude Code statusLine: 5h/7d rate-limit usage, reset countdowns, model + context window, prompt-cache age — one line, 3 styles × 9 themes, daemon fast-mode. The licence is MIT.

When your agent uses it

  • The user mentions cs
  • Claude-statusbar
  • Theme switching
  • Style switching

Example prompts

  • “/claude-statusbar”

Requirements

  • Python 3

What it can do on your machine

Read from SKILL.md and the folder at commit 76b4b39. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv
    • pip
    • pipx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md. Its commands use uv, pip and pipx, which can reach the network depending on how they are called.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Claude Statusbar loads about 2.5k tokens when it runs. Until then it costs about 248 tokens; SKILL.md has 1,144 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~248
When it runs · the whole SKILL.md, loaded when a task matches
~2.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from leeguooooo/claude-code-usage-bar at commit 76b4b39, republished under its MIT licence (© leeguooooo). 1,144 words, ~2,512 tokens.

Download SKILL.mdSave it as .claude/skills/claude-statusbar/SKILL.md (or your agent's skills folder).
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, 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-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 intentCommand
Inspect current configcs config show
List themescs themes
List stylescs styles
Switch theme to <name>cs config set theme <name>
Switch style to <name>cs config set style <name>
Change densitycs config set density <compact|regular|cozy>
Show all 27 combinationscs preview
Filter preview to one style/themecs preview --style <s> or cs preview --theme <t>
Diagnose problemcs doctor
Return one key to its defaultcs config unset <key> (the config stores only what you changed)
Wipe configcs config reset
Install / first-time setupcs --setup
Upgrade / update to latest versioncs 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 offcs 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 modecs daemon stop then re-run cs --setup
Toggle session cost displaycs config set show_cost true|false
Toggle prompt-cache countdowncs config set show_cache_age true|false
Toggle project + branch 2nd linecs 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 on)
Toggle the per-effort colour gradient on the mode linecs config set mode_gradient true|false (default on)
Hide weekly barcs config set show_weekly false
Set warning thresholdcs config set warning_threshold <0-100>
Set critical thresholdcs config set critical_threshold <0-100>
Auto-collapse to hairline below widthcs config set auto_compact_width <px>
Force / disable no-quota (API) modecs config set api_mode <auto|on|off>
Show working directorycs config set show_cwd true|false + cs config set cwd_style <basename|full>
Relay balance fuel gaugecs 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 segmentcs config set show_ip_risk true|false
Relay fingerprint-risk watermarkcs config set show_fp_risk true|false
Window-end projection →NN%cs config set show_projection true|false
Worktree marker glyphcs config set worktree_glyph 🌲 (default ⑂; any 1-2 cell symbol — an emoji ignores the theme color, the emoji font decides it)
Worktree marker colorcs config set color_worktree "#bd93f9" (empty string restores the theme's hue)
Show full SKILL.md (528 more words)Show less

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.

Per-severity color overrides (v3.4.1+)

The user can override the three severity colors independently of theme:

bash
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 / contextTheme
Muted, professional, dark terminalgraphite (default)
Soft, warm, darktwilight
Classic dev / Nord-inspirednord
High contrast, vividdracula
Warm, cute, light bgsakura
Light terminallinen
Pure grayscale / no colormono
Popular pastel, easy on long viewingcatppuccin-mocha
Deeper neon-blue moodtokyo-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.

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.

© leeguooooo, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/claude-statusbar of leeguooooo/claude-code-usage-bar.

Open the folder on GitHubat commit 76b4b39

Compare with similar skills

Claude Statusbar next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Claude Statusbar compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Claude Statusbar this skillleeguooooo/claude-code-usage-bar378—~2.5kAutomated safety check: PassMIT
Badstephenleo/bmad-autonomous-development107—~7.7kAutomated safety check: PassMIT
Analyze Trajectoryyologdev/yoyo-evolve1.9k—~3.6kAutomated safety check: PassMIT
File-Based Planning in ArabicOthmanAdi/planning-with-files27k—~3.2kAutomated safety check: NotesMIT
Pydantic AI Harnesspydantic/skills140—~1.9kAutomated safety check: PassMIT
Weekly Project Digeststhedotmack/claude-mem99k—~3.5kAutomated safety check: PassApache-2.0

Similar skills

  • Bad

    stephenleo/bmad-autonomous-development

    BMad Autonomous Development — orchestrates parallel story implementation pipelines.

    107 GitHub stars~7.7k tokensUpdated 5 mo ago
    Agent WorkflowsAuto-check passed
  • Analyze Trajectory

    yologdev/yoyo-evolve

    Diagnoses a recurring failure such as a stuck task, repeated CI error or frequent reverts by sending sub-agents through the logs and returning one root-cause diagnosis.

    1.9k GitHub stars~3.6k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • File-Based Planning in Arabic

    OthmanAdi/planning-with-files

    Arabic edition of a file-based planning skill that keeps task_plan.md, findings.md and progress.md on disk so multi-step agent work survives lost context.

    27k GitHub stars~3.2k tokensUpdated 3 days ago
    Agent WorkflowsAuto-check: notes
  • Pydantic AI Harness

    pydantic/skills

    Official

    Extend Pydantic AI agents with batteries-included capabilities from pydantic-ai-harness -- Code Mode (collapse many tool calls into one sandboxed Python execution), a filesystem and shell…

    140 GitHub stars~1.9k tokensUpdated 8 days ago
    Agent WorkflowsAuto-check passed
  • Weekly Project Digests

    thedotmack/claude-mem

    Turns a project's claude-mem timeline into a week-by-week narrative, splitting it by ISO week and running one subagent per week that receives the prior week's carry-forward block.

    99k GitHub stars~3.5k tokensUpdated today
    Agent WorkflowsAuto-check passed
  • Pydantic AI Harness

    pydantic/pydantic-ai

    Official

    Adds optional capabilities to Pydantic AI agents from pydantic-ai-harness, led by Code Mode, which runs many tool calls as one sandboxed Python script.

    20k GitHub stars~4.9k tokensUpdated today
    AI & LLM EngineeringAuto-check passed

Works with

Categories

Questions about Claude Statusbar

What does Claude Statusbar do?

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)…. Claude Statusbar is an agent skill from leeguooooo/claude-code-usage-bar. 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, or toggle the activity segments (todos, active tool, running subagents, session duration, lines changed, git ahead/behind).

When should I use Claude Statusbar?

Claude Statusbar fits situations like: the user mentions cs; Claude-statusbar; theme switching; style switching.

How do I install Claude Statusbar in Claude Code?

Run `npx skills add leeguooooo/claude-code-usage-bar --skill claude-statusbar -a claude-code`. Or copy the skill folder (skills/claude-statusbar in leeguooooo/claude-code-usage-bar) into .claude/skills/claude-statusbar in your project. Claude Code loads it when a task matches its description.

How do I install Claude Statusbar in Codex?

Run `npx skills add leeguooooo/claude-code-usage-bar --skill claude-statusbar -a codex`. Or copy the skill folder (skills/claude-statusbar in leeguooooo/claude-code-usage-bar) into .agents/skills/claude-statusbar in your project. Codex loads it when a task matches its description.

Can I use Claude Statusbar in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add leeguooooo/claude-code-usage-bar --skill claude-statusbar -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/claude-statusbar, .gemini/skills/claude-statusbar, .github/skills/claude-statusbar and .opencode/skills/claude-statusbar in your project.

What does Claude Statusbar need to run?

Going by SKILL.md and its folder, Claude Statusbar needs the command-line tools its instructions call (uv, pip and pipx). Our summary lists: Python 3.

Does Claude Statusbar access the network?

SKILL.md contains no URLs. Its commands use uv and pip, which can reach the network depending on how they are called. This is read from the text; nothing was executed.

Is Claude Statusbar safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Claude Statusbar use?

Claude Statusbar is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Claude Statusbar use?

About 2.5k tokens (SKILL.md is roughly 10k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Claude Statusbar?

Skills that share tags, products or a category with Claude Statusbar: Bad (stephenleo/bmad-autonomous-development, 107 stars), Analyze Trajectory (yologdev/yoyo-evolve, 1.9k stars), File-Based Planning in Arabic (OthmanAdi/planning-with-files, 27k stars) and Pydantic AI Harness (pydantic/skills, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Claude Statusbar?

leeguooooo (a GitHub user) maintains it in leeguooooo/claude-code-usage-bar, which has 378 GitHub stars. The repository was last updated on October 9, 2026.

Source: leeguooooo/claude-code-usage-bar on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.