Skip to main content

​
What cc-statusline Offers

cc-statusline transforms your Claude Code terminal into an informative dashboard with real-time project insights, git status, usage tracking, and more.

Directory Display

Current working directory with ~ home abbreviation

Git Integration

Active branch name and repository status

Model Information

Claude model name, version, and Claude Code version

Context Tracking

Real-time context window usage with visual progress bars

Cost Monitoring

Live cost tracking with hourly burn rate calculations

Session Timer

Time remaining until usage limit reset

Token Analytics

Token consumption and tokens-per-minute metrics

Color Themes

256-color palette support for beautiful terminals

​
Feature Categories

​
Core Features (Always Available)

These features work out of the box with minimal dependencies:
  • 📁 Directory Display - Shows your current working directory
  • 🌿 Git Branch - Displays active git branch (requires git)
  • 🤖 Model Information - Claude model and version details
  • 📟 Claude Code Version - Shows which version you’re running
  • 🎨 Output Style - Current output style setting

​
Advanced Features (Require jq)

Advanced features require jq for JSON parsing. Without jq, your statusline will have LIMITED functionality:
  • ❌ No context remaining percentage
  • ❌ No token statistics
  • ❌ No session timer
  • ⚠️ Basic fallback parser is used (less reliable)
Install jq to unlock:
  • 🧠 Context Usage - Real-time context window tracking with progress bars
  • 💰 Cost Tracking - Live cost monitoring with burn rates
  • 📊 Token Analytics - Token consumption and burn rate metrics
  • ⌛ Session Timer - Time until usage limit resets (also requires ccusage)

​
Example Output

​
Default 3-Line Layout

With all features enabled, you get a clean, informative 3-line display: 
📁 ~/Projects/cc-statusline  🌿 feature/context-usage  🤖 Sonnet 4  📟 v1.0.85  🎨 default
🧠 Context Remaining: 83% [========--]  ⌛ 3h 7m until reset at 01:00 (37%) [===-------]
💰 $49.00 ($16.55/h)  📊 14638846 tok (279900 tpm)

📁 ~/my-app  🌿 main  🤖 Claude Sonnet  📟 v1.0.85
🧠 Context Remaining: 95% [=========-]
💰 $2.48 ($12.50/h)

​
Installation Options

The fastest way to get started:
npx @chongdashu/cc-statusline@latest init
Answer a few questions and you’re done!

​
Feature Selection

During installation, you can customize which features to enable:
FeatureDescriptionExampleRequires
📁 DirectoryCurrent working directory~/my-project-
🌿 Git BranchActive git branchfeature/statuslinegit
🤖 ModelClaude model name & versionSonnet 4-
📟 Claude CodeClaude Code versionv1.0.85-
🎨 Output StyleCurrent output style settingdefault-
🧠 ContextRemaining context with progress bar83% [========--]jq
💰 CostLive costs with burn rate$49.00 ($16.55/h)jq
⌛ SessionTime until reset with progress3h 7m until resetjq + ccusage
📊 TokensToken consumption with burn rate14638846 tok (279900 tpm)jq
All features are pre-selected by default (v1.2.2+). Simply press Enter to accept or use arrow keys and Space to customize.

​
Performance Characteristics

cc-statusline is designed for speed:
MetricTargetTypical
Execution Time<100ms45-80ms
Memory Usage<5MB~2MB
CPU ImpactNegligible<1%
DependenciesMinimaljq only
Benchmarked on macOS with all features enabled

​
Next Steps

Directory & Git Features

Learn about directory display and git integration

Context Tracking

Understand context usage monitoring

Cost Monitoring

Track costs and burn rates in real-time

Customization

Customize colors, themes, and layouts

Build docs developers (and LLMs) love

Get started for freeTalk to us