Cache-Aware CC Status Line

A rich status line for Claude Code showing the usual (Git, costs, models...) but also cache metrics and compaction+context usage.

Why does it matter? Because cached tokens count 90% less towards your usage limit/API costs.

Preview

On a normal turn:

Normal

Compact
On a cache miss/bust turn:

Normal

Compact

Installation

Prerequs

Claude Code
Node.js on PATH

Option A — npm (recommended)

npx -y simple-claude-code-status-line

That's it. The command writes the statusLine entry into ~/.claude/settings.json for you. Restart Claude Code to see it.

Run again any time to repair/reset the entry. Existing settings are preserved.

If detection fails on your shell, force install mode explicitly: npx -y simple-claude-code-status-line init

Other options

Option B — Claude Code plugin

/plugin marketplace add https://github.com/stanlrt/simple-claude-code-status-line.git
/plugin install simple-claude-code-status-line@simple-claude-code-status-line

Then run /statusline-setup and Claude will handle the rest.

[!NOTE] Plugin install uses git clone. If your global git config rewrites HTTPS to SSH (url.<x>.insteadOf rule), the clone will fail with a host key error. Use Option A or Option C.

Option C — Manual

Copy statusline-command.js to ~/.claude/statusline-command.js

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "node /absolute/path/to/.claude/statusline-command.js"
  }
}

[!IMPORTANT] Use the absolute path. The ~ shorthand is not expanded in the command value.

Normal mode

Symbols

Symbol	Meaning
`🗿` / `🗿🗿` / `🗿🗿🗿`	Caveman mode intensity: lite / full / ultra (requires caveman plugin, optional but recommended)
`Claude Sonnet 4.6`	Current model
`▸ opus`	Advisor model (if configured via `/advisor`)
`████████░░ 78%`	Context window usage bar, see below
`hit:87%`	Cache hit rate this turn
`fresh:1.2k`	Uncached input tokens this turn; what you pay full price for
`write:46.3k`	Tokens written to cache this turn (only shown when nonzero). Spikes on first turn or after a bust
`BUST`	Cache miss detected. Appears when `hit:0%` and input is substantial
`⎇ main`	Current git branch
`+2`	Staged files (green)
`~1`	Modified files (yellow)
`?3`	Untracked files (gray)
`↓2`	Commits behind remote (purple)
`$0.0042`	Estimated cumulative session cost
`5h:67%`	Tokens used in current 5-hour billing block vs your historical max (via ccusage). Green <50%, yellow <75%, red ≥75%. Hidden if no data.
`~/projects/myapp`	Current working directory

Context window bar

The entire bar represents your model's context window (100% means it is fully saturated).

simple-claude-code-status-line

Popularity

What's Inside

README

Cache-Aware CC Status Line

Preview

Installation

Prerequs

Option A — npm (recommended)

Option B — Claude Code plugin

Option C — Manual

Normal mode

Symbols

Context window bar

Confidence

Similar Plugins

ui-design

nanobanana

llm-council-plugin

product-management

More by stanlrt

superpowers-custom