Skip to content

danjdewhurst/cc-status-line

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 

Repository files navigation

Claude Code Status Line

A Catppuccin Frappe-themed status line for Claude Code

Install License

Opus 4.6 │ feat/my-branch● │ my-project │ ▓▓▓░░░░░░░ 15k/200k │ $0.03 │ v2.1.52

Model · Git branch (with dirty indicator) · Project folder · Context usage (visual bar + tokens) · Session cost (auto-converting currency) · CLI version


Install

mkdir -p ~/.claude/scripts && \
  curl -fsSL https://raw.githubusercontent.com/danjdewhurst/cc-status-line/main/status-line.sh \
  -o ~/.claude/scripts/status-line.sh && \
  chmod +x ~/.claude/scripts/status-line.sh
Or with wget
mkdir -p ~/.claude/scripts && \
  wget -qO ~/.claude/scripts/status-line.sh \
  https://raw.githubusercontent.com/danjdewhurst/cc-status-line/main/status-line.sh && \
  chmod +x ~/.claude/scripts/status-line.sh

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/scripts/status-line.sh"
  }
}

Restart Claude Code or start a new session.

Requirements

  • Terminal with 24-bit true colour support (iTerm2, Ghostty, Kitty, WezTerm, Alacritty)
  • jq and bc
  • curl (optional — for exchange rate API, falls back to manual rate)
  • git (optional — for branch display)

Customisation

Change currency

Exchange rates are fetched from the Frankfurter API and cached for 24 hours at ~/.cache/cc-status-line/exchange-rate.json.

Edit the variables at the top of the script:

CURRENCY='£'
CURRENCY_CODE='GBP'
EXCHANGE_RATE=0.79    # Fallback if API unavailable

Supports any ISO 4217 currency code (EUR, JPY, AUD, etc.).

Change context bar threshold

The bar turns red when usage exceeds 60%. Adjust in the script:

[ "$pct" -gt 60 ] && COLOR="$RED" || COLOR="$BLUE"
Change bar characters

Replace and with alternatives:

Style Filled Empty
Default
Circles
Blocks
Thin
Change branch truncation

Branch names are truncated at 20 characters. Adjust in the script:

if [ "${#branch}" -gt 20 ]; then
    branch="${branch:0:19}"
fi

Colour Palette

All colours are from Catppuccin Frappe:

Element Colour RGB
Model Lavender 186, 187, 241
Branch Mauve 202, 158, 230
Folder Teal 129, 200, 190
Context (low) Blue 140, 170, 238
Context (high) Red 231, 130, 132
Dirty indicator Peach 239, 159, 118
Cost Green 166, 209, 137
Separators Overlay 0 115, 121, 148
Version / secondary Subtext 0 165, 173, 206

Testing

echo '{"model":{"display_name":"Opus 4.6"},"workspace":{"current_dir":"/Users/you/project"},"context_window":{"context_window_size":200000,"used_percentage":25},"cost":{"total_cost_usd":0.05}}' | ./status-line.sh

Licence

MIT

About

Claude Code status line with Catppuccin Frappe theme

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages