Transform your Claude Code terminal
cc-statusline enhances your Claude Code terminal with a beautiful, informative statusline that displays real-time information about your current session. Track your directory, git branch, AI model, context usage, costs, and session time - all at a glance.Quick start
Get up and running in under 60 seconds with one command
Installation
Detailed installation guide with prerequisites and setup
Configuration
Customize your statusline with powerful options
Troubleshooting
Common issues and their solutions
What you get
Enhance your Claude Code terminal with essential information displayed in a clean, colorful format:Core features
Directory display
Current working directory with
~ abbreviation for your home folderGit integration
Active git branch name for version control awareness
Model information
Shows which Claude model you’re using plus Claude Code version
Output style
Current output style setting (default, XML, JSON, etc.)
Advanced tracking
Context usage
Real-time context window usage with visual progress bars
Cost tracking
Live cost monitoring with burn rates ($/hour) for budget awareness
Session timer
Time remaining until usage limit resets with countdown
Token analytics
Token consumption and tokens per minute (TPM) metrics
Most features work out of the box. Advanced features like context tracking and session timer require
jq (a lightweight JSON processor).Example output
Modern 3-line layout
Compact mode
Why cc-statusline?
Fast
Optimized bash execution in under 100ms
Lightweight
Minimal memory footprint (~2MB)
Reliable
Graceful fallbacks when dependencies are missing
Customizable
Choose exactly which features you want
Secure
No network requests except ccusage integration
Zero config
Auto-installs and configures Claude Code settings
Performance
Built for speed with minimal resource impact:| Metric | Target | Typical |
|---|---|---|
| Execution time | <100ms | 45-80ms |
| Memory usage | <5MB | ~2MB |
| CPU impact | Negligible | <1% |
| Dependencies | Minimal | jq only |
Next steps
Quick start guide
Install and configure in under 60 seconds
Installation guide
Detailed prerequisites and installation options