claude-code-tips

Claude Code Scripts

context-bar.sh

A two-line status line script for Claude Code that shows model, directory, git branch, uncommitted file count, sync status with origin, context usage, and your last message.

Example output:

Opus 4.5 | 📁claude-code-tips | 🔀main (scripts/context-bar.sh uncommitted, synced 12m ago) | ██░░░░░░░░ 18% of 200k tokens
💬 This is good. I don't think we need to change the documentation as long as we don't say that the default color is orange el...

Installation

Copy the script to your Claude scripts directory:

mkdir -p ~/.claude/scripts
cp context-bar.sh ~/.claude/scripts/
chmod +x ~/.claude/scripts/context-bar.sh

Update your ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/scripts/context-bar.sh"
  }
}

That’s it!

Color Themes

The script supports optional color themes for the model name and progress bar. Edit the COLOR variable at the top of the script:

# Color theme: gray, orange, blue, teal, green, lavender, rose, gold, slate, cyan
COLOR="orange"

Preview all options by running bash scripts/color-preview.sh:

Color preview options

Requirements

jq (for JSON parsing)
bash
git (optional, for branch display)
Claude Code 2.0.65+ (verified to work; older versions may not have the required JSON fields - check earlier commits for older versions)

How it works

Claude Code passes session metadata to status line commands via stdin as JSON, including:

model.display_name - The model name
cwd - Current working directory
context_window.total_input_tokens - Total input tokens used
context_window.total_output_tokens - Total output tokens used
context_window.context_window_size - Maximum context window size
transcript_path - Path to the session transcript JSONL file

The script uses these JSON fields to calculate context usage (input + output tokens), showing percentage of the context window. Use /context for precise token breakdown.

This site is open source. Improve this page.