claude-statusbar

Claude Code statusbar

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%

Screenshot

Installation

/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.

Configuration

Customize interactively:

/statusbar:config

Or apply a preset directly:

/statusbar:config developer

Presets

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

Layouts

Compact (1 line)

Opus 4.6 │ effort:high │ ████░░░░ 42% │ main* │ $1.23 │ 12m 34s

Standard (2 lines)

Opus 4.6 │ effort:high │ ████████░░ 72% │ main* │ +42 -7
$1.23 │ 14m 22s │ 5h:34% │ 7d:12% │ cache:67%

Mascot (3 lines)

 ▐▛███▜▌  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 Catalog

Core (enabled by default)

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*

Developer

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

Tracking

Widget	Shows	Example
messages	Message count	✉ 12/11
total-tokens	Cumulative	Σ 84kin 21kout
tools-used	Tool calls	⚒ 47

Extras

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

Alert

Widget	Shows	Example
compact-warn	Auto-compact warning	⚠ COMPACT

Color System

All colors use RGB true color for maximum fidelity:

• Context/rate limits: Green (<55%) → Yellow (<70%) → Orange (<85%) → Red (85%+)
• Cost: Claude orange
• Effort: Lavender
• Git: Cyan branch, red dirty indicator
• Mascot: Claude's signature orange (rgb(215, 119, 87))

Dev Mode

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

Uninstall

/statusbar:setup uninstall

Then restart Claude Code.

Architecture

• Pure Node.js — zero external dependencies
• File-based caching for git and terminal width (3-5s TTL)
• All data from stdin JSON, local git, or filesystem — no network calls
• Target execution time: <80ms with cache hits

License

MIT