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