Statusline Integration (Beta) 🚀

Display real-time usage statistics in your Claude Code status line.

Overview

The statusline command provides a compact, real-time view of your Claude Code usage, designed to integrate with Claude Code's status line hooks. It shows:

• 💬 Current session cost - Cost for your active conversation session
• 💰 Today's total cost - Your cumulative spending for the current day
• 🚀 Current session block - Cost and time remaining in your active 5-hour billing block
• 🔥 Burn rate - Token consumption rate with visual indicators
• 🤖 Active model - The Claude model you're currently using

Setup

Configure settings.json

Add this to your ~/.claude/settings.json or ~/.config/claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bun x ccusage statusline", // Use "npx -y ccusage statusline" if you prefer npm
    "padding": 0  // Optional: set to 0 to let status line go to edge
  }
}

Output Format

The statusline displays a compact, single-line summary:

🤖 Opus | 💰 $0.23 session / $1.23 today / $0.45 block (2h 45m left) | 🔥 $0.12/hr

Components Explained

• Model (🤖 Opus): Currently active Claude model
• Session Cost (💰 $0.23 session): Cost for the current conversation session
• Today's Cost ($1.23 today): Total cost for the current day across all sessions
• Session Block ($0.45 block (2h 45m left)): Current 5-hour block cost with remaining time
• Burn Rate (🔥 $0.12/hr): Cost burn rate per hour with color-coded indicators:
  • Green text: Normal (< 2,000 tokens/min)
  • Yellow text: Moderate (2,000-5,000 tokens/min)
  • Red text: High (> 5,000 tokens/min)

When no active block exists:

🤖 Opus | 💰 $0.00 session / $0.00 today / No active block

Technical Details

The statusline command:

• Reads session information from stdin (provided by Claude Code hooks)
• Identifies the active 5-hour billing block
• Calculates real-time burn rates and projections
• Outputs a single line suitable for status bar display

Beta Notice

⚠️ This feature is currently in beta. More customization options and features are coming soon:

• Custom format templates
• Configurable burn rate thresholds
• Additional metrics display options
• Session-specific cost tracking

Troubleshooting

No Output Displayed

If the statusline doesn't show:

1. Verify ccusage is in your PATH
2. Check Claude Code logs for any errors
3. Ensure you have valid usage data in your Claude data directory

Incorrect Costs

If costs seem incorrect:

• The command uses the same cost calculation as other ccusage commands
• Verify with ccusage daily or ccusage blocks for detailed breakdowns

Related Commands

• blocks - Detailed 5-hour billing block analysis
• daily - Daily usage reports
• session - Session-based usage analysis