cc-statusline

A configurable status line for Claude Code with gradient bars, burn-rate projection, and a widget-based architecture.

Features

• Gradient progress bar with truecolor shading (7 styles)
• Velocity-based burn-rate projection for rate limits
• Context compression detection
• Configurable timezone, thresholds, and bar styles
• Widget-based architecture (compatible with ccstatusline)
• SQLite usage logging for historical analysis
• Cross-platform (macOS, Linux)

Prerequisites

Requires Bun runtime (uses bun:sqlite for usage logging).

Installation

bun install -g cc-statusline

Configuration

Claude Code Setup

Add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "cc-statusline"
  }
}

Customization

Create ~/.config/cc-statusline/settings.json:

{
  "timezone": "America/New_York",
  "bar": {
    "style": "blocks",
    "width": 15,
    "shades": 8
  },
  "thresholds": {
    "warn": 75,
    "danger": 90
  }
}

See src/types/Settings.ts for the full configuration schema.

Development

bun install
just test          # Run tests
just check         # Run all quality checks
just build         # Build for distribution

Acknowledgments

cc-statusline's widget architecture follows the ccstatusline Widget interface by design. Widgets developed here are intended to be compatible with and contributed upstream to ccstatusline where applicable.

License

MIT