cc-costline

Enhanced statusline for Claude Code — adds cost tracking, usage limits, and leaderboard rank to your terminal.

14.6k ~ $2.42 / 40% by Opus 4.6 | 5h: 45% / 7d: 8% | 30d: $866 | #2/22 $67.0

Install

npm i -g cc-costline && cc-costline install

Open a new Claude Code session and you'll see the enhanced statusline. Requires Node.js >= 22.

What you get

Segment	Example	Description
Tokens ~ Cost / Context	`14.6k ~ $2.42 / 40% by Opus 4.6`	Session token count, cost, context usage, and model
Usage limits	`5h: 45% / 7d: 8%`	Claude 5-hour and 7-day utilization (auto-colored like context). At 100%, shows countdown: `5h:-3:20`
Period cost	`30d: $866`	Rolling cost total (configurable: 7d, 30d, or both)
Leaderboard	`#2/22 $67.0`	ccclub rank (if installed)

Colors

Context & usage limits — green (< 60%) → orange (60-79%) → red (≥ 80%)
Leaderboard rank — #1 gold, #2 white, #3 orange, others cyan
Period cost — yellow

Optional integrations

Claude usage limits — reads OAuth credentials from macOS Keychain automatically. Just claude login and it works.
ccclub leaderboard — install ccclub (npm i -g ccclub && ccclub init). Rank appears automatically.

Both are zero-config: if not available, the segment is silently omitted.

Commands

cc-costline install              # Set up Claude Code integration
cc-costline uninstall            # Remove from settings
cc-costline refresh              # Manually recalculate cost cache
cc-costline config --period 7d   # Show 7-day cost (default)
cc-costline config --period 30d  # Show 30-day cost
cc-costline config --period both # Show both periods

How it works

install configures ~/.claude/settings.json — sets the statusline command and adds session-end hooks. Your existing settings are preserved.
render is called by Claude Code on every turn. It reads stdin JSON for session data, then refreshes data sources inline with separate TTLs:
- Local cost (2-min TTL): scans ~/.claude/projects/**/*.jsonl, applies per-model pricing → ~/.cc-costline/cache.json
- Usage limits (5-min retry, token-aware): fetches api.anthropic.com/api/oauth/usage → /tmp/sl-claude-usage. Detects OAuth token rotation to retry immediately with fresh rate limit quota. Stale data persists across failures.
- ccclub rank (5-min retry): fetches ccclub.dev/api/rank → /tmp/sl-ccclub-rank
refresh can also be run manually or via session-end hooks to warm the cost cache.

Pricing table

Prices per million tokens (USD):

Model	Input	Output	Cache Write	Cache Read
Opus 4.6	$5	$25	$6.25	$0.50
Opus 4.5	$5	$25	$6.25	$0.50
Opus 4.1	$15	$75	$18.75	$1.50
Sonnet 4.5	$3	$15	$3.75	$0.30
Sonnet 4	$3	$15	$3.75	$0.30
Haiku 4.5	$1	$5	$1.25	$0.10
Haiku 3.5	$0.80	$4	$1.00	$0.08

Unknown models fall back by family name, defaulting to Sonnet pricing.

Development

npm test    # Build + run unit tests (node:test, zero dependencies)

Uninstall

cc-costline uninstall
npm uninstall -g cc-costline

Acknowledgments

ccclub by 碎瓜 (@mazzzystar) — Claude Code leaderboard among friends

License

MIT

Ventuss-OvO/cc-costline