A clean statusline for Claude Code with accurate token tracking, visual progress bar, and color-coded context warnings.

• 🤖 Model Display: Shows current Claude model (e.g., Opus 4.5, Sonnet 4)
• 📁 Current Directory: Displays the basename of your working directory
• 🌿 Git Integration: Shows current git branch when in a git repository
• 🧠 Context Usage: Color-coded percentage with visual progress bar
  • 🟢 Green: < 50% used
  • 🟡 Yellow: 50-80% used
  • 🔴 Red: > 80% used
• 📝 Output Style: Shows your active Claude Code output style

• Simplified Display: Removed cost and cache metrics for a cleaner statusline
• Accurate Context Tracking: Uses used_percentage field for precise context usage after compaction
• Visual Progress Bar: 5-block bar (█████) shows context usage at a glance
• Color-Coded Warnings: Percentage changes color as you approach context limits

Latest stable version (recommended):

bash <(curl -fsSL https://raw.githubusercontent.com/bishnubista/cc-statusline/main/scripts/install.sh)

Specific version:

VERSION=v3.1.0 bash <(curl -fsSL https://raw.githubusercontent.com/bishnubista/cc-statusline/main/scripts/install.sh)

Then restart Claude Code!

# Download the statusline script
curl -fsSL https://raw.githubusercontent.com/bishnubista/cc-statusline/main/scripts/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

# Configure Claude Code (create or update ~/.claude/settings.json)
cat > ~/.claude/settings.json << 'EOF'
{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline.sh",
    "padding": 0
  }
}
EOF

# Restart Claude Code

Example in action:

Full example:

🤖 Opus 4.5 | 📁 cc-statusline | 🌿 main | 🧠 25% █░░░░ (72.3k) | 📝 Explanatory

Breakdown of each section:

Context usage at different levels:

Low usage:    🧠 15% ░░░░░ (12.3k)   ← Green
Medium usage: 🧠 65% ███░░ (89.2k)   ← Yellow
High usage:   🧠 92% ████░ (156.4k)  ← Red (warning!)

This statusline focuses on context awareness:

• Accurate Percentage: Uses Claude Code's used_percentage field which accounts for context compaction and sub-agent runs
• Visual Feedback: Progress bar and color coding let you see context state at a glance
• Git Branch: Avoid making changes on the wrong branch
• Clean & Minimal: Shows only what you need without clutter

cc-statusline/
├── scripts/
│   ├── statusline.sh    # Main statusline script
│   ├── install.sh       # One-command installer
│   └── uninstall.sh     # One-command uninstaller
├── assets/
│   └── statusline-example.png  # Screenshot
├── CHANGELOG.md         # Version history
├── README.md            # This file
├── INSTALLATION.md      # Detailed setup guide
└── settings.json        # Example configuration

• Claude Code 2.0+ (uses newer JSON fields)

• jq (JSON processor) - Install before running the installer:

  # macOS
  brew install jq
  
  # Ubuntu/Debian
  sudo apt-get install jq

• curl or wget (for installation only, usually pre-installed)

• bash (pre-installed on macOS/Linux)

• Git (optional, for branch display)

One-Command Uninstall:

bash <(curl -fsSL https://raw.githubusercontent.com/bishnubista/cc-statusline/main/scripts/uninstall.sh)

Manual Uninstall:

rm ~/.claude/statusline.sh
# Then manually remove the statusLine section from ~/.claude/settings.json

The statusline is configurable by editing ~/.claude/statusline.sh after installation:

# In the color_pct() function, adjust thresholds:
if [ "$pct" -lt 50 ]; then      # Green threshold
    ...
elif [ "$pct" -lt 80 ]; then    # Yellow threshold
    ...

# In the progress_bar() function:
local width=5    # Change to 10 for a wider bar

The script receives this JSON from Claude Code:

{
  "model": { "display_name": "Opus 4.5" },
  "workspace": { "current_dir": "/path/to/project" },
  "output_style": { "name": "Explanatory" },
  "context_window": {
    "used_percentage": 28.5,
    "remaining_percentage": 71.5,
    "context_window_size": 200000,
    "total_input_tokens": 45000,
    "total_output_tokens": 12000
  }
}

Current version: v3.1.0

See CHANGELOG.md for detailed release history and changes.

See INSTALLATION.md for detailed troubleshooting steps.

Common issues:

• Statusline not appearing: Check ~/.claude/settings.json syntax
• "jq: command not found": Install jq via your package manager
• Git branch not showing: Make sure you're in a git repository
• Colors not showing: Your terminal may not support ANSI colors

1. Claude Code calls statusline.sh and passes JSON data via stdin
2. Script extracts model, directory, and token data from JSON
3. Uses used_percentage for accurate context window state (handles compaction)
4. Calculates visual progress bar and applies color coding
5. Checks if the current directory is a git repository
6. Returns formatted statusline string with ANSI color codes

MIT License - Feel free to modify and distribute

Issues and pull requests welcome! This is a personal project, so feel free to fork and customize for your needs.

Built for the Claude Code community. Not affiliated with Anthropic.