cc-statusline

English | 한국어 | 日本語 | 中文 | Español

Custom statusline for Claude Code.

Installation

Add the following to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bunx @say8425/cc-statusline",
    "padding": 0
  }
}

Screenshots

Git diff only

PR only

Git diff + PR

Worktree

Worktree + Usage Metrics

Usage Metrics

Features

• Session Time: Current session elapsed time
• Cost: Session cost in USD
• Context: Token usage with percentage (color-coded)
• Git Diff: File count, insertions, deletions
• PR URL: Clickable OSC 8 hyperlink
• Worktree Support: Shows real project name when running in a cc --worktree session
• TrueColor: Dynamic colors based on thresholds
• Limit Reset Time: Reset time display (HH:MM)
• Block Usage: 5-hour utilization percentage
• Weekly Reset Timer: Weekly limit reset time (MM/DD HH:MM)
• Weekly Usage: 7-day utilization percentage

Emoji Guide

Emoji	Description
📁	Project folder name
🌲	Worktree name (shown in worktree sessions)
🌿	Current Git branch
⏱️	Session elapsed time
💰	Session cost in USD
🧠	Context window usage
⏳	Limit reset time
📊	5-hour utilization %
⏰	Weekly limit reset time
📅	7-day utilization %
✏️	Uncommitted changes
📎	Pull request link

Usage Metrics

Shows usage information from Claude Code's stdin JSON input.

How It Works

Claude Code passes rate_limits in the stdin JSON input (CLI 2.1.80+):

1. 5-hour utilization - Usage percentage for the current billing block (rate_limits.five_hour.used_percentage)
2. 7-day utilization - Weekly usage percentage (rate_limits.seven_day.used_percentage)
3. Reset timer - Exact reset time (rate_limits.five_hour.resets_at), shown as HH:MM
4. Weekly reset timer - Weekly limit reset time (rate_limits.seven_day.resets_at), shown as MM/DD HH:MM (e.g., 02/15 17:00)

Usage metrics are automatically displayed when rate_limits is present in the stdin JSON. No additional flags or configuration needed.

Note

rate_limits is only available for Claude.ai subscribers (Pro/Max) after the first API response. See the official statusline docs for the full JSON schema.

Dependencies

• Bun - JavaScript runtime
• gh - GitHub CLI (optional, for PR URL)

Development

# Install dependencies
bun install

# Run tests
bun test

# Run tests with coverage
bun test --coverage

# Type check
bun run typecheck

# Lint
bun run lint

Color Thresholds

Metric	Normal (white)	Warning (yellow)	Critical (red)
Context %	< 50%	50-80%	> 80%
Block Usage %	< 50%	50-80%	> 80%

License

MIT