By bit-incarnas
Live usage metrics in Claude Code's status line - tracks context window, messages, tokens, and session duration for Claude Max subscriptions
A Claude Code plugin that renders a multi-line status line with live usage metrics for Claude Max/Pro subscriptions.
▸ ENV: Opus 4.7 | CC: 2.1.116 | SK: 12 | HK: 3 | MCP: 2 | AG: 0 | Py: 3.14
● CONTEXT: ▓▓▓▓▓░░░░░░░░░░░░░░░░░░░░░░░░░ 18% | 176.0k/1.0M | EFFORT: ● high
▬ USE: 5H: 5% ↓4:05 | 7D: 15% ↓Sat 19:00 | T: 42/avg:502
◆ PWD: ACCEPT EDITS | dev/cstat | 1M | Commit: 25m ago
rate_limits from stdin, which was added in 2.1.80. Older versions render the USE line with zeros and em-dashes.python3 on your PATH — stdlib only, no pip install./plugin marketplace add https://github.com/bit-incarnas/cstat
/plugin install cstat@status-bar
/cstat:setup
/cstat:setup writes the statusLine entry into ~/.claude/settings.json. Restart Claude Code and the bar appears.
| Command | What it does |
|---|---|
/cstat:setup | Wire statusLine into ~/.claude/settings.json (auto-detects your python3 path) |
/cstat:stats | Detailed usage report — lifetime totals, per-model tokens, recent sessions, hourly histogram |
/cstat:configure [section] [on|off] | Toggle the four sections, change plan tier, or override rate-limit targets |
Edit plugins/cstat/config/defaults.json directly or via /cstat:configure:
{
"display": {
"showEnv": true,
"showContext": true,
"showUsage": true,
"showPwd": true
},
"plan": "Max",
"limits": {
"5h_messages": 250,
"weekly_messages": 4500
}
}
display.* — toggle each of the four linesplan — "Max" or "Pro" (affects default rate-limit labels)limits.* — override limit targets (the USE line always uses server-reported percentages when available, so these only matter for legacy fallback)Only the first line of the status bar is visible. Your terminal window isn't tall enough. Claude Code renders each newline as a separate row; a short window clips the lower rows.
USE line shows 0% and em-dashes. Claude Code < 2.1.80, or the rate_limits object isn't in stdin yet (very new session). Run claude --version.
Slash commands don't autocomplete. The plugin isn't loaded. Run /plugin and verify cstat@status-bar is enabled, or re-install with the install block above.
~/.claude/, and writes ANSI to stdout./tmp/cstat_cache/ with per-key TTLs — delete the directory to force a cold render.plugins/cstat/.MIT — see LICENSE.
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub bit-incarnas/cstat --plugin cstatComprehensive UI/UX design plugin for mobile (iOS, Android, React Native) and web applications with design systems, accessibility, and modern patterns
Standalone image generation plugin using Nano Banana MCP server. Generates and edits images, icons, diagrams, patterns, and visual assets via Gemini image models. No Gemini CLI dependency required.
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.
Write feature specs, plan roadmaps, and synthesize user research faster. Keep stakeholders updated and stay ahead of the competitive landscape.
Unified status line for Claude Code with multi-CLI (Claude, Codex, Gemini, z.ai) usage monitoring, context, rate limits, and cost tracking