Help us improve
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
Share bugs, ideas, or general feedback.
By SYM1000
Customize the Claude Code status bar with interactive layout configuration, widget toggles, and presets, plus manage plugin setup and removal
npx claudepluginhub sym1000/claude-statusbar --plugin statusbarConfigure the status bar layout and widgets interactively, or apply a preset. Use when: customizing which widgets appear, changing the layout mode, applying presets, toggling individual widgets. Triggers: "customize statusbar", "statusbar config", "change layout", "enable widgets", "statusbar developer", "statusbar minimal", "statusbar full", "statusbar preset".
Set up, check status, or uninstall the statusbar plugin. Use when: first-time setup after installing the plugin, checking if the status bar is configured, or uninstalling the plugin. Triggers: "setup statusbar", "install statusbar", "configure statusbar", "uninstall statusbar", "remove statusbar", "statusbar status".
A customizable status bar plugin for Claude Code that displays real-time session metrics at the bottom of your terminal.
20+ widgets | 3 layouts | pixel art mascot | zero dependencies
Opus 4.6 │ effort:high │ ████░░░░ 42% │ main* │ $1.23 │ 12m 34s
▐▛███▜▌ Opus 4.6 │ effort:high │ ████░░░░ 72%
▝▜█████▛▘ main* │ $1.23 │ 14m 22s
▘▘ ▝▝ 5h:34% │ +42 -7 │ cache:67%
/plugin marketplace add SYM1000/claude-statusbar
/plugin install statusbar
/statusbar:setup
Restart Claude Code after setup. The status bar will appear at the bottom of every session.
Customize interactively:
/statusbar:config
Or apply a preset directly:
/statusbar:config developer
| Preset | Layout | Description |
|---|---|---|
minimal | compact | Model + context bar |
default | compact | Model, context, cost, duration, git |
developer | standard | All developer metrics (2 lines) |
full | mascot | Everything + pixel art mascot |
tracker | standard | Message & token tracking focus |
Opus 4.6 │ effort:high │ ████░░░░ 42% │ main* │ $1.23 │ 12m 34s
Opus 4.6 │ effort:high │ ████████░░ 72% │ main* │ +42 -7
$1.23 │ 14m 22s │ 5h:34% │ 7d:12% │ cache:67%
▐▛███▜▌ Opus 4.6 │ effort:high │ ████░░░░ 72%
▝▜█████▛▘ main* │ $1.23 │ 14m 22s
▘▘ ▝▝ 5h:34% │ +42 -7 │ cache:67%
The mascot is the Claude Code alien ("Clawd") rendered in Claude's signature orange.
| Widget | Shows | Example |
|---|---|---|
model | Active model | Opus 4.6 |
effort | Thinking effort | effort:high |
context | Usage bar + % | ████░░░░ 42% |
cost | Session cost | $1.23 |
duration | Session time | 12m 34s |
git | Branch + dirty | main* |
| Widget | Shows | Example |
|---|---|---|
lines | Code changes | +156 -23 |
rate-5h | 5h rate limit | 5h:34% |
rate-7d | 7d rate limit | 7d:12% |
tokens | Token counts | 84k/21k |
cache | Cache hit rate | cache:67% |
context-size | Window size | 1M |
latency | API time | api:18.5s |
| Widget | Shows | Example |
|---|---|---|
messages | Message count | ✉ 12/11 |
total-tokens | Cumulative | Σ 84kin 21kout |
tools-used | Tool calls | ⚒ 47 |
| Widget | Shows | Example |
|---|---|---|
session | Session ID | a1b2c3 |
vim | Vim mode | NORMAL |
mcp | MCP servers | MCP:3 |
worktree | Worktree | wt:feature-x |
agent | Agent name | planner |
style | Output style | concise |
mascot | Pixel art | Clawd alien |
| Widget | Shows | Example |
|---|---|---|
compact-warn | Auto-compact warning | ⚠ COMPACT |
All colors use RGB true color for maximum fidelity:
rgb(215, 119, 87))Test locally without installing as a plugin:
claude --plugin-dir /path/to/statusbar
Or test the renderer directly:
echo '{"model":{"display_name":"Opus 4.6"},"context_window":{"used_percentage":42}}' | node scripts/statusline.js
/statusbar:setup uninstall
Then restart Claude Code.
MIT
Share bugs, ideas, or general feedback.
Based on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
Lightweight Claude Code status-line monitor with switchable styles, themes, and slash commands. v3.13.3–v3.13.5 fix the 5h/7d bars sticking at a stale high % after Anthropic re-baselines usage mid-window (e.g. weekly limit raised): the cross-session merge now accepts an official downward revision once the old reading goes unconfirmed for 120s, idle windows replaying hours-old rate_limits blobs (expired 5h reset) can no longer overwrite or re-confirm the shared reading, and the →NN% projection drops its old-denominator samples and relearns after a re-baseline instead of freezing for the rest of the window. v3.13.0 adds a ⚙ session-mode line — effort (low/medium/high/xhigh/max/ultracode/auto) · thinking · fast · output-style — with a distinct static colour gradient per effort tier. v3.12.0 adds an always-on end-of-window projection (→NN%, learned from your local work rhythm) + an at-risk `⚠eta` forecast after each reset timer, session lines on by default, and a faint on-bar version that shows a `↑` hint when a newer release is on PyPI. v3.10.0 adds an opt-in live-activity line (in-progress todo, active tool, completed-tool rollup), git ahead/behind + session duration/lines on the project line, running-subagent lines, an opt-in `bar_shimmer` starfield on the battery bars, and a self-hosted plugin marketplace — plus a reliability fix so auto-update actually runs in daemon mode (detached, non-blocking) and the cache countdown is now per-session-correct. v3.9.0 makes the `cache` countdown auto-detect the real prompt-cache TTL (5m vs 1h) from the transcript, fixing a ~55-minute early `cache COLD` for Claude subscription users (Claude Code requests the 1-hour TTL automatically). v3.7.0 defends against status-line hijacking: a new `cs --setup --project [PATH]` writes a project-level override so another tool stealing the global `~/.claude/settings.json` slot can't kick `cs` out of this project; when displacement is detected, the bar also surfaces a one-line warning. v3.6.0 makes daemon (fast) mode the default for `cs --setup` — under 1% CPU continuously instead of ~3% inline at refreshInterval=1; pass `--inline` to opt back. Requires the `cs` CLI from PyPI (`pip install claude-statusbar` or `uv tool install claude-statusbar`).
Live usage status bar for Claude Code — session limits, weekly usage, lines changed, 10 themes, widget priorities, shimmer animations, and zero API calls
Claude Code statusline showing info at a glance: tokens, context, model, subagents, burn rate, skills, plugins, OpenSpec specs, task lists, and more
A Claude Code statusline that shows reasoning effort (⚡) and thinking (💡). 5 presets (xsmall-xlarge), Catppuccin theme, no Node/Nerd Font, native PowerShell on Windows.
Ultra-compressed communication mode. Cuts ~75% of tokens while keeping full technical accuracy by speaking like a caveman.
Memory compression system for Claude Code - persist context across sessions
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge.
Sign in to claim