Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@terzigolu/ccwatch) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ccwatch

Fast cost & quota statusline for Claude Code. Cached transcript scanning, configurable visibility, dedicated context bar.

🌐 watchstatus.bar

ccwatch preview

One-line install

npx @terzigolu/ccwatch

That's it. Open Claude Code — the statusline appears immediately. Then run /ccwatch inside Claude Code to choose which fields you want visible.

To remove:

npx @terzigolu/ccwatch uninstall

Alternative: install as a Claude Code plugin

/plugin marketplace add https://github.com/terzigolu/ccwatch
/plugin install ccwatch
/setup

What you get

5h / 7d quota bars — green→yellow→red gradient with countdowns to reset.
Session cost & burn rate — $0.42 $1.40/h →$3.10 18m so you know where the session is heading.
Today / week / month / total — running cost totals so you always know where the bill stands.
Per-project breakdown — which project is eating your budget (cache hit rate included).
Dedicated context bar (ctxbar) — separate progress bar for the context window, 0%→100%, color-graded.
Lines changed — +250/-40 so you can see whether output justifies the spend.

Why ccwatch

You're burning through API credits or a $200/month Max subscription — but Claude Code doesn't tell you how fast, which project, or what it'll cost by end of day. ccwatch fills that gap.

It works with both billing models: API (pay-per-token) or a Pro/Max subscription (quota-based). No guessing, no surprises at the end of the month.

Two things that make ccwatch different:

It's fast. Other statuslines rescan the entire ~/.claude/projects tree (often 900 MB+) on every render. ccwatch caches per-file by mtime + size, so cold-render is ~0.9s and warm-render is ~80ms — the bar feels instant even on big histories.
You choose what's visible. Run /ccwatch and a wizard walks you through which cells to show. Pick 4 or pick all 8.

Configure visibility

Run /ccwatch inside Claude Code. The wizard asks which cells you want visible and writes the result to ~/.claude/plugins/ccwatch/config.json.

Available cells:

key	what it shows
`5h`	5h quota bar + countdown
`7d`	7d quota bar + countdown
`today`	today's tokens + cost (global + per-project)
`history`	this week + this month cost
`session`	session cost, $/h, projection, duration, ctx%, lines
`total`	all-time cost + per-project total + cwd
`model`	ctx% + model name + clock
`ctxbar`	dedicated context-window progress bar

Or edit ~/.claude/plugins/ccwatch/config.json by hand:

{
  "rows": [["5h", "7d"], ["session", "ctxbar"]],
  "compactRows": [["5h", "7d"], ["session"], ["ctxbar"]],
  "compactBreakpoint": 113,
  "columns": null
}

Accurate to the cent

Most tools estimate costs with a flat rate. That's wrong — Opus output is 19x more expensive than Haiku. ccwatch gets it right:

Per-model pricing — reads the model ID from every message. Opus, Sonnet, Haiku each priced correctly.
Streaming dedup — each API call writes 2–7 JSONL entries. ccwatch deduplicates by message.id. Every message counted exactly once.
Cache separation — cache reads cost 10% of fresh input. ccwatch tracks them separately and shows ♻hit rate per project.
Cross-session history — session cost resets when you restart. Your bill doesn't. ccwatch scans all JSONL — today, this week, this month, per project.

How it works

stdin JSON → ccwatch CLI → cached scan of ~/.claude/projects/**/*.jsonl
           → dedup by message.id → per-model pricing
           → adaptive layout → stdout

API users — exact costs from per-model token pricing.
Pro / Max subscribers — reads OAuth quota via the Anthropic API. 5h and 7d bars show actual runway with countdowns.

Slash commands

/ccwatch — interactive visibility wizard (recommended)
/setup — re-wire statusLine.command if it drifts
/configure — edit config JSON directly (advanced)
/doctor — diagnose plugin install + statusline wiring

Uninstall

npx @terzigolu/ccwatch uninstall

Or via Claude Code:

/plugin remove ccwatch

Authors

Built and maintained by:

License

MIT — see LICENSE.