ccbar

Vibe coding is no longer just for fun. Know what it costs.

Real-time cost tracking and quota monitoring for Claude Code. Zero dependencies.

Why ccbar

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. ccbar fills that gap.

It works with both billing models: whether you're on the API (pay-per-token) or a Pro/Max subscription (quota-based), ccbar tracks your spend in real time. No guessing, no surprises at the end of the month.

Install

Public GitHub marketplace:

/plugin marketplace add https://github.com/Narcooo/ccbar
/plugin install ccbar@narcooo
/ccbar:setup

This is the current public install path.

Local development marketplace:

For local development or pre-listing installs, add the dedicated development marketplace manifest from a filesystem path. Use .claude-plugin/dev-marketplace/marketplace.json so local work does not clobber the public narcooo marketplace identity.

/plugin marketplace add /absolute/path/to/ccbar/.claude-plugin/dev-marketplace/marketplace.json
/plugin install ccbar@ccbar-dev
/ccbar:setup

ccbar installs as a native Claude Code plugin. setup wires the plugin into statusLine.command, and the bundled SessionStart hook repairs the wiring if it drifts later.

For local debugging only, there is also a thin Python wrapper around the built Node CLI. This is not the primary install path and still requires the local Node build output.

npm run build
python -m ccbar doctor

What you get

Row 1:  5h quota bar + countdown · today tokens + cost › proj tokens ♻cache/hit% cost · week cost › proj tokens cost │ month tokens cost › proj cost
Row 2:  7d quota bar + countdown · session cost + $/h + →projection + duration + ctx% + lines · total cost › proj tokens ♻cache cost + path

Terminal too narrow? ccbar switches to a compact 2x2 layout first, then drops trailing columns only as a last resort. Content within columns is never truncated.

Lightweight by design

ccbar is now a native Claude Code plugin built on Node.js/TypeScript. There is no PyPI bootstrap layer, no extra daemon requirement for correctness, and no separate ccbar --install step. It reads the JSONL logs Claude Code already writes and renders directly through Claude's plugin-driven statusline flow.

Accurate to the cent

Most tools estimate costs with a flat rate. That's wrong — Opus output is 19x more expensive than Haiku. ccbar 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. ccbar deduplicates by message.id. Every message counted exactly once.
• Cache separation — cache reads cost 10% of fresh input. ccbar tracks them separately and shows ♻hit rate per project.
• Cross-session history — session cost resets when you restart. Your bill doesn't. ccbar scans all JSONL — today, this week, this month, per project.

Full-spectrum monitoring

API & Subscription — both covered

API users — ccbar calculates exact costs from per-model token pricing. You see dollars spent per session, per project, per day.

Pro / Max subscribers — ccbar reads your OAuth quota via the Anthropic API. The 5-hour and 7-day progress bars show exactly how much runway you have left, with countdowns to reset.

Either way, you get a single statusline that tells the full story.

Configure

/ccbar:configure
/ccbar:doctor

{
  "compactRows": [["5h", "today"], ["7d", "total"]],
  "compactBreakpoint": 113,
  "columns": null
}

The plugin stores config under ~/.claude/plugins/ccbar/config.json.

How it works

stdin JSON → plugin runtime → scan ~/.claude/projects/**/*.jsonl
           → dedup by message.id → per-model pricing
           → adaptive layout → stdout

Plugin commands:

• /ccbar:setup wires statusLine.command
• /ccbar:configure edits plugin config
• /ccbar:doctor checks plugin cache and statusline wiring

Uninstall

/plugin remove ccbar