CC-STATUS
Terminal HUD for Claude Code
Context window, cost, burn rate, tools, agents, and focus — one glance, no switching.
Six Signals, One Bar
SESSION
Repo, branch, model, duration, diff stats, context bar, and token counts.
COST
Live cost, burn rate, tokens/min, API wait ratio, cache efficiency, MCP counts.
SOUL
cc-soul mind: memories, learning entries, code intelligence — if you run it.
TOOLS
Running tools with names plus completed counts from the transcript.
AGENTS
Subagent activity with running/completed status and elapsed time.
TODOS
Current in-progress task so you don’t lose focus mid-flow.
Why It Matters
Protect context. Know limits before they hurt quality.
Track cost live, not after the session.
Spot slow sessions by isolating API wait time.
Map tools, agents, and tasks at a glance.
Installation
Install from the Claude Code plugin marketplace.
Browse the marketplace or install directly:
/plugin add genomewalker/cc-statusRun setup to configure your statusLine:
/cc-status-setupRestart Claude Code. Operational.
Update anytime via /plugin update in Claude Code.
Data Flow
No network calls. No external services. Local stdin only.
FAQ
Does it phone home?
Negative. Reads stdin and local files only.
Outside Claude Code?
Negative — built for statusLine stdin protocol.
Trust the cost numbers?
Affirmative. Data from Claude Code session telemetry. cc-status formats and derives.
No cc-soul installed?
Soul line stays quiet. All other systems nominal.