Claude Code Statusline

Beautiful, feature-rich statusline for Claude Code with real-time usage limits, context tracking, and colorful display.

Features

• 🎨 Beautiful colors - ANSI colors for better readability
• 📊 Usage limits - Real-time plan usage from Anthropic API
• 📈 Context tracking - Visual progress bar for context window
• ⏱️ Session time - Track how long you've been coding
• 💰 Cost tracking - Monitor your session costs
• 📝 Code changes - Lines added and removed
• 🌿 Git branch - Current branch display

Quick Install

Method 1: Using npx (Recommended)

cd your-project
npx claude-code-statusline init

Method 2: Using local path

cd your-project
node /path/to/statusline-installer/cli.js init

Method 3: Simple curl install

cd your-project
curl -o .claude/statusline.js https://raw.githubusercontent.com/your-repo/statusline.js

What you'll see

Sonnet 4.5 | ▓▓░░░░░░░░ 18% | ⏱ 45m 30s | Plan: 37% used | Resets in 4h 12m | $1.0792 | +247 -15 | ⎇ main

Color Breakdown

• Model name: Bold Cyan
• Context bar: Green (< 40%) / Yellow (40-70%) / Red (> 70%)
• Session time: Blue
• Plan usage: Green (< 50%) / Yellow (50-80%) / Red (> 80%)
• Reset time: Magenta
• Cost: Yellow
• Lines added: Green
• Lines removed: Red
• Git branch: Cyan

Requirements

• Node.js >= 14.0.0
• Claude Code CLI installed
• Logged in to Claude Code (for usage limits feature)

How it works

1. Reads session data from Claude Code via stdin (JSON format)
2. Fetches usage limits from Anthropic API (with 5-minute cache)
3. Formats everything with beautiful ANSI colors
4. Outputs a single-line statusline

Configuration

After installation, your .claude/settings.json will contain:

{
  "statusLine": {
    "type": "command",
    "command": "node \"T:\\absolute\\path\\to\\project\\.claude\\statusline.js\"",
    "padding": 0
  }
}

Note: The installer automatically uses absolute paths to ensure the statusline works correctly across all projects.

Troubleshooting

Statusline not showing

1. Check that .claude/statusline.js exists
2. Check that .claude/settings.json has the statusLine config
3. Restart Claude Code

Usage limits not showing

1. Check that you're logged in to Claude Code
2. Check that credentials exist in ~/.claude/.credentials.json (Linux/macOS) or %USERPROFILE%\.claude\.credentials.json (Windows)
3. The feature requires authentication with Anthropic API

Colors not working

Make sure your terminal supports ANSI colors. Most modern terminals do.

Uninstall

Remove the statusline configuration from .claude/settings.json:

# Or manually edit .claude/settings.json to remove statusLine config

License

MIT

Credits

• Inspired by codelynx.dev's statusline
• Built for the Claude Code community