ccstatus

ccstatus

Claude Code statusline with cost tracking, git context, and PR status.

 feat/auth*3 ↑2 PR#123 · ⏱  1h07m · 💰 오늘$40 🔥$32/h 어제$265(4/16) 주$2.8k(4/13~) 월$5.7k(4/1~17) [█████░░░░░] 57%

Features

• Cost tracking — daily / yesterday / weekly / monthly spend from local transcripts
• Date ranges — 주(4/13~) / 월(4/1~17) inline
• Burn rate — 🔥$32/h based on today's activity window
• Budget bar — color-coded progress vs monthly budget (default $10,000)
• Git context — branch, dirty file count, ahead/behind, stash count
• PR status — auto-detected via gh pr view, cached 5 min
• Issue ID — auto-extracts LIN-123 style IDs from branch names
• Session timer — elapsed time in current Claude Code session
• Subscription quota — reads claude-hud 5h/7d remaining if present
• Localization — Korean (default) or English
• Configurable — via /ccstatus slash command

Installation

# 1. Add marketplace
/plugin marketplace add amecoder/ccstatus

# 2. Install
/plugin install ccstatus

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "${CLAUDE_PLUGIN_ROOT}/bin/ccstatus --text"
  }
}

Or chain with existing statusline tools (e.g., claude-hud):

{
  "statusLine": {
    "type": "command",
    "command": "bash -c '$HUD; $CCSTATUS --text 2>/dev/null || true'"
  }
}

Configuration

Use the slash command inside Claude Code:

/ccstatus                  # show current config
/ccstatus budget 15000     # set monthly budget ($)
/ccstatus lang en          # switch to English
/ccstatus week sunday      # start week on Sunday
/ccstatus reset            # restore defaults

Settings are persisted to ~/.claude/ccstatus.json.

Environment overrides

Environment variables always win over the config file:

| Variable | Values | Default | |----------|--------|---------| | CCSTATUS_MONTHLY_BUDGET | number (USD) | 10000 | | CCSTATUS_LANG | ko, en | ko | | CCSTATUS_WEEK_START | monday, sunday | monday |

How it works

• Scans ~/.claude/projects/*/.jsonl for usage events from the current month
• Prices tokens using the Claude pricing table (Opus/Sonnet/Haiku 4.x)
• Caches cost aggregation for 5 minutes (~/.claude/ccstatus-cost-cache.json)
• Caches PR lookups for 5 minutes (~/.claude/ccstatus-pr-cache.json)
• Reads optional subscription quota from claude-hud cache if available

Nothing is uploaded. All computation is local.

Requirements

• Python 3.10+
• git (optional — git info hidden if unavailable)
• gh CLI (optional — PR number hidden if unavailable or not authenticated)

License

MIT