patyearone · February 13, 2026 01:56
diff --git a/claude-code-statusline-guide.md b/claude-code-statusline-guide.md
diff --git a/statusline-command.sh b/statusline-command.sh
 #!/bin/bash

 # Read Claude Code context from stdin
 input=$(cat)

 # Extract information from Claude Code context
 model_name=$(echo "$input" | jq -r '.model.display_name // "Claude"')
 current_dir=$(echo "$input" | jq -r '.workspace.current_dir // ""')
 output_style=$(echo "$input" | jq -r '.output_style.name // "default"')
 context_pct=$(echo "$input" | jq -r '.context_window.used_percentage // 0' | cut -d. -f1)

 # Get username and hostname
 user=$(whoami)
 host=$(hostname -s)

 # Get current working directory basename for display
 if [ -n "$current_dir" ]; then
    dir_name=$(basename "$current_dir")
 else
    dir_name=$(basename "$(pwd)")
 fi

 # Get git status if we're in a git repo
 git_info=""
 if git rev-parse --git-dir > /dev/null 2>&1; then
    branch=$(git branch --show-current 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
    if [ -n "$branch" ]; then
        if ! git diff --quiet || ! git diff --cached --quiet || [ -n "$(git ls-files --others --exclude-standard)" ]; then
            git_info=" ${branch}*"
        else
            git_info=" ${branch}"
        fi
    fi
 fi

 # Get current time in 12-hour format (no seconds)
 current_time=$(date '+%I:%M %p')

 # Bar with optional target marker (│) showing where even pacing would be
 # Usage: make_bar <pct> [target_pct] [color_code]
 make_bar() {
    local pct=$1 target=${2:-} color=${3:-} width=10
    local filled=$((pct * width / 100))
    [ "$filled" -gt "$width" ] && filled=$width
    local target_pos=-1
    if [ -n "$target" ] && [ "$target" -ge 0 ] 2>/dev/null && [ "$target" -le 100 ]; then
        target_pos=$((target * width / 100))
        [ "$target_pos" -gt "$width" ] && target_pos=$width
    fi
    local bar=""
    for ((i=0; i<width; i++)); do
        if [ "$i" -eq "$target_pos" ]; then
            bar="${bar}\033[38;5;199m│\033[0m${color}"
        elif [ "$i" -lt "$filled" ]; then
            bar="${bar}▓"
        else
            bar="${bar}░"
        fi
    done
    printf "%s" "$bar"
 }

 color_for_pct() {
    local pct=$1
    if [ "$pct" -ge 80 ]; then
        printf "\033[91m"  # bright red
    elif [ "$pct" -ge 50 ]; then
        printf "\033[33m"  # yellow
    else
        printf "\033[32m"  # green
    fi
 }

 CTX_COLOR=$(color_for_pct "$context_pct")
 CTX_BAR=$(make_bar "$context_pct" "" "$CTX_COLOR")

 # --- Usage limits (5-hour and 7-day) from Anthropic API ---
 USAGE_CACHE="/tmp/claude-statusline-usage.json"
 USAGE_CACHE_AGE=60  # refresh every 60 seconds

 fetch_usage() {
    local creds token response
    creds=$(security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null) || return 1
    token=$(echo "$creds" | jq -r '.claudeAiOauth.accessToken') || return 1
    [ -z "$token" ] || [ "$token" = "null" ] && return 1
    response=$(curl -s --max-time 3 "https://api.anthropic.com/api/oauth/usage" \
        -H "Authorization: Bearer $token" \
        -H "anthropic-beta: oauth-2025-04-20" \
        -H "Content-Type: application/json" 2>/dev/null) || return 1
    # Check for errors
    if echo "$response" | jq -e '.error' >/dev/null 2>&1; then
        return 1
    fi
    echo "$response" > "$USAGE_CACHE"
 }

 # Refresh cache if stale or missing
 if [ ! -f "$USAGE_CACHE" ] || [ $(($(date +%s) - $(stat -f%m "$USAGE_CACHE" 2>/dev/null || echo 0))) -gt $USAGE_CACHE_AGE ]; then
    fetch_usage 2>/dev/null
 fi

 # Read cached usage data and calculate pacing targets
 usage_5h=""
 usage_7d=""
 target_5h=""
 target_7d=""
 if [ -f "$USAGE_CACHE" ]; then
    usage_5h=$(jq -r '.five_hour.utilization // empty' "$USAGE_CACHE" 2>/dev/null | cut -d. -f1)
    usage_7d=$(jq -r '.seven_day.utilization // empty' "$USAGE_CACHE" 2>/dev/null | cut -d. -f1)

    # Calculate pacing targets: how far through each window are we?
    NOW_EPOCH=$(date +%s)

    # 5-hour window target
    resets_5h=$(jq -r '.five_hour.resets_at // empty' "$USAGE_CACHE" 2>/dev/null)
    if [ -n "$resets_5h" ]; then
        reset_epoch=$(date -juf "%Y-%m-%dT%H:%M:%S" "$(echo "$resets_5h" | cut -d. -f1 | sed 's/+.*//')" +%s 2>/dev/null || date -d "$resets_5h" +%s 2>/dev/null)
        if [ -n "$reset_epoch" ]; then
            window_secs=$((5 * 3600))
            start_epoch=$((reset_epoch - window_secs))
            elapsed=$((NOW_EPOCH - start_epoch))
            [ "$elapsed" -lt 0 ] && elapsed=0
            [ "$elapsed" -gt "$window_secs" ] && elapsed=$window_secs
            target_5h=$((elapsed * 100 / window_secs))
            resets_5h_label=$(date -r "$reset_epoch" '+%-l%p' | tr '[:upper:]' '[:lower:]' | tr -d ' ')
        fi
    fi

    # 7-day window target
    resets_7d=$(jq -r '.seven_day.resets_at // empty' "$USAGE_CACHE" 2>/dev/null)
    if [ -n "$resets_7d" ]; then
        reset_epoch=$(date -juf "%Y-%m-%dT%H:%M:%S" "$(echo "$resets_7d" | cut -d. -f1 | sed 's/+.*//')" +%s 2>/dev/null || date -d "$resets_7d" +%s 2>/dev/null)
        if [ -n "$reset_epoch" ]; then
            window_secs=$((7 * 86400))
            start_epoch=$((reset_epoch - window_secs))
            elapsed=$((NOW_EPOCH - start_epoch))
            [ "$elapsed" -lt 0 ] && elapsed=0
            [ "$elapsed" -gt "$window_secs" ] && elapsed=$window_secs
            target_7d=$((elapsed * 100 / window_secs))
            resets_7d_label=$(date -r "$reset_epoch" '+%a, %-l%p' | tr '[:upper:]' '[:lower:]' | sed 's/ //2')
        fi
    fi
 fi

 # Build usage parts
 usage_parts=""
 if [ -n "$usage_5h" ]; then
    U5_COLOR=$(color_for_pct "$usage_5h")
    U5_BAR=$(make_bar "$usage_5h" "$target_5h" "$U5_COLOR")
    reset_label=""
    [ -n "$resets_5h_label" ] && reset_label=" (${resets_5h_label})"
    usage_parts="${U5_COLOR}5hr${reset_label} ${U5_BAR} ${usage_5h}%\033[0m"
 fi
 if [ -n "$usage_7d" ]; then
    U7_COLOR=$(color_for_pct "$usage_7d")
    U7_BAR=$(make_bar "$usage_7d" "$target_7d" "$U7_COLOR")
    reset_7d_label_str=""
    [ -n "$resets_7d_label" ] && reset_7d_label_str=" (${resets_7d_label})"
    [ -n "$usage_parts" ] && usage_parts="${usage_parts}\033[2m │ \033[0m"
    usage_parts="${usage_parts}${U7_COLOR}wk${reset_7d_label_str} ${U7_BAR} ${usage_7d}%\033[0m"
 fi

 # Single line output
 line="\033[2m\033[96m${dir_name}\033[0m\033[2m${git_info} │ ${model_name} │ ${current_time} │ ${CTX_COLOR}ctx ${CTX_BAR} ${context_pct}%\033[0m"
 if [ -n "$usage_parts" ]; then
    line="${line}\033[2m │ \033[0m${usage_parts}"
 fi
 echo -e "$line"
Element	Current	Code
Directory	Light cyan	`\033[96m`
Pacing marker	Hot pink	`\033[38;5;199m`
Good (<50%)	Green	`\033[32m`
Warning (50-80%)	Yellow	`\033[33m`
Danger (>80%)	Bright red	`\033[91m`
Field	Description
`model.display_name`	Current model name
`model.id`	Model identifier
`context_window.used_percentage`	Context window usage
`context_window.total_input_tokens`	Cumulative input tokens
`context_window.total_output_tokens`	Cumulative output tokens
`cost.total_cost_usd`	Session cost
`cost.total_duration_ms`	Total session time
`cost.total_lines_added`	Lines added
`cost.total_lines_removed`	Lines removed
`workspace.current_dir`	Current directory
`output_style.name`	Output style
`vim.mode`	Vim mode (if enabled)
Problem	Cause	Fix
No status line at all	Script crashes with non-zero exit	Run the diagnostic above — step 7 shows the error
No usage data (only ctx shows)	Keychain token expired or missing	Run diagnostic steps 2-6, then delete entry + restart CC
Usage shows 0% with bar at far left	Stale cache from a previous window	`rm /tmp/claude-statusline-usage.json` to force a fresh fetch
Pacing marker at far left (wrong)	UTC timezone not handled in date parsing	Ensure `-u` flag: `date -juf` not `date -jf`
`printf: invalid format character`	ANSI escape codes in printf variable	Use `echo -e` for final output, not `printf`
Token scope error (`user:profile`)	Used `claude setup-token`	That token only has `user:inference`. Delete keychain entry, restart CC for browser OAuth
Keychain has only `mcpOAuth` key	Ran `/login` inside CC	`/login` is for MCP servers, not CC auth. Delete entry, restart CC
Status line wraps to next line	Output too wide for terminal	Shorten labels (`wk` not `weekly`), drop `user@host`, drop seconds from time
`jq: command not found`	jq not installed	`brew install jq`
Keychain access popup/prompt	macOS asking permission	Click "Always Allow" — the script reads keychain on every cache refresh
Usage data is stale / not updating	Cache file not refreshing	Check `ls -la /tmp/claude-statusline-usage.json` — if mod time is old, token is probably expired
Script works manually but not in CC	`disableAllHooks: true` in settings	Remove that setting from `~/.claude/settings.json`
Git branch slow in large repos	`git diff` and `git ls-files` scanning	Cache git info to a file with a 5-second TTL
	#!/bin/bash

	# Read Claude Code context from stdin
	input=$(cat)

	# Extract information from Claude Code context
	model_name=$(echo "$input" \| jq -r '.model.display_name // "Claude"')
	current_dir=$(echo "$input" \| jq -r '.workspace.current_dir // ""')
	output_style=$(echo "$input" \| jq -r '.output_style.name // "default"')
	context_pct=$(echo "$input" \| jq -r '.context_window.used_percentage // 0' \| cut -d. -f1)

	# Get username and hostname
	user=$(whoami)
	host=$(hostname -s)

	# Get current working directory basename for display
	if [ -n "$current_dir" ]; then
	dir_name=$(basename "$current_dir")
	else
	dir_name=$(basename "$(pwd)")
	fi

	# Get git status if we're in a git repo
	git_info=""
	if git rev-parse --git-dir > /dev/null 2>&1; then
	branch=$(git branch --show-current 2>/dev/null \|\| git rev-parse --short HEAD 2>/dev/null)
	if [ -n "$branch" ]; then
	if ! git diff --quiet \|\| ! git diff --cached --quiet \|\| [ -n "$(git ls-files --others --exclude-standard)" ]; then
	git_info=" ${branch}*"
	else
	git_info=" ${branch}"
	fi
	fi
	fi

	# Get current time in 12-hour format (no seconds)
	current_time=$(date '+%I:%M %p')

	# Bar with optional target marker (│) showing where even pacing would be
	# Usage: make_bar <pct> [target_pct] [color_code]
	make_bar() {
	local pct=$1 target=${2:-} color=${3:-} width=10
	local filled=$((pct * width / 100))
	[ "$filled" -gt "$width" ] && filled=$width
	local target_pos=-1
	if [ -n "$target" ] && [ "$target" -ge 0 ] 2>/dev/null && [ "$target" -le 100 ]; then
	target_pos=$((target * width / 100))
	[ "$target_pos" -gt "$width" ] && target_pos=$width
	fi
	local bar=""
	for ((i=0; i<width; i++)); do
	if [ "$i" -eq "$target_pos" ]; then
	bar="${bar}\033[38;5;199m│\033[0m${color}"
	elif [ "$i" -lt "$filled" ]; then
	bar="${bar}▓"
	else
	bar="${bar}░"
	fi
	done
	printf "%s" "$bar"
	}

	color_for_pct() {
	local pct=$1
	if [ "$pct" -ge 80 ]; then
	printf "\033[91m" # bright red
	elif [ "$pct" -ge 50 ]; then
	printf "\033[33m" # yellow
	else
	printf "\033[32m" # green
	fi
	}

	CTX_COLOR=$(color_for_pct "$context_pct")
	CTX_BAR=$(make_bar "$context_pct" "" "$CTX_COLOR")

	# --- Usage limits (5-hour and 7-day) from Anthropic API ---
	USAGE_CACHE="/tmp/claude-statusline-usage.json"
	USAGE_CACHE_AGE=60 # refresh every 60 seconds

	fetch_usage() {
	local creds token response
	creds=$(security find-generic-password -s "Claude Code-credentials" -w 2>/dev/null) \|\| return 1
	token=$(echo "$creds" \| jq -r '.claudeAiOauth.accessToken') \|\| return 1
	[ -z "$token" ] \|\| [ "$token" = "null" ] && return 1
	response=$(curl -s --max-time 3 "https://api.anthropic.com/api/oauth/usage" \
	-H "Authorization: Bearer $token" \
	-H "anthropic-beta: oauth-2025-04-20" \
	-H "Content-Type: application/json" 2>/dev/null) \|\| return 1
	# Check for errors
	if echo "$response" \| jq -e '.error' >/dev/null 2>&1; then
	return 1
	fi
	echo "$response" > "$USAGE_CACHE"
	}

	# Refresh cache if stale or missing
	if [ ! -f "$USAGE_CACHE" ] \|\| [ $(($(date +%s) - $(stat -f%m "$USAGE_CACHE" 2>/dev/null \|\| echo 0))) -gt $USAGE_CACHE_AGE ]; then
	fetch_usage 2>/dev/null
	fi

	# Read cached usage data and calculate pacing targets
	usage_5h=""
	usage_7d=""
	target_5h=""
	target_7d=""
	if [ -f "$USAGE_CACHE" ]; then
	usage_5h=$(jq -r '.five_hour.utilization // empty' "$USAGE_CACHE" 2>/dev/null \| cut -d. -f1)
	usage_7d=$(jq -r '.seven_day.utilization // empty' "$USAGE_CACHE" 2>/dev/null \| cut -d. -f1)

	# Calculate pacing targets: how far through each window are we?
	NOW_EPOCH=$(date +%s)

	# 5-hour window target
	resets_5h=$(jq -r '.five_hour.resets_at // empty' "$USAGE_CACHE" 2>/dev/null)
	if [ -n "$resets_5h" ]; then
	reset_epoch=$(date -juf "%Y-%m-%dT%H:%M:%S" "$(echo "$resets_5h" \| cut -d. -f1 \| sed 's/+.*//')" +%s 2>/dev/null \|\| date -d "$resets_5h" +%s 2>/dev/null)
	if [ -n "$reset_epoch" ]; then
	window_secs=$((5 * 3600))
	start_epoch=$((reset_epoch - window_secs))
	elapsed=$((NOW_EPOCH - start_epoch))
	[ "$elapsed" -lt 0 ] && elapsed=0
	[ "$elapsed" -gt "$window_secs" ] && elapsed=$window_secs
	target_5h=$((elapsed * 100 / window_secs))
	resets_5h_label=$(date -r "$reset_epoch" '+%-l%p' \| tr '[:upper:]' '[:lower:]' \| tr -d ' ')
	fi
	fi

	# 7-day window target
	resets_7d=$(jq -r '.seven_day.resets_at // empty' "$USAGE_CACHE" 2>/dev/null)
	if [ -n "$resets_7d" ]; then
	reset_epoch=$(date -juf "%Y-%m-%dT%H:%M:%S" "$(echo "$resets_7d" \| cut -d. -f1 \| sed 's/+.*//')" +%s 2>/dev/null \|\| date -d "$resets_7d" +%s 2>/dev/null)
	if [ -n "$reset_epoch" ]; then
	window_secs=$((7 * 86400))
	start_epoch=$((reset_epoch - window_secs))
	elapsed=$((NOW_EPOCH - start_epoch))
	[ "$elapsed" -lt 0 ] && elapsed=0
	[ "$elapsed" -gt "$window_secs" ] && elapsed=$window_secs
	target_7d=$((elapsed * 100 / window_secs))
	resets_7d_label=$(date -r "$reset_epoch" '+%a, %-l%p' \| tr '[:upper:]' '[:lower:]' \| sed 's/ //2')
	fi
	fi
	fi

	# Build usage parts
	usage_parts=""
	if [ -n "$usage_5h" ]; then
	U5_COLOR=$(color_for_pct "$usage_5h")
	U5_BAR=$(make_bar "$usage_5h" "$target_5h" "$U5_COLOR")
	reset_label=""
	[ -n "$resets_5h_label" ] && reset_label=" (${resets_5h_label})"
	usage_parts="${U5_COLOR}5hr${reset_label} ${U5_BAR} ${usage_5h}%\033[0m"
	fi
	if [ -n "$usage_7d" ]; then
	U7_COLOR=$(color_for_pct "$usage_7d")
	U7_BAR=$(make_bar "$usage_7d" "$target_7d" "$U7_COLOR")
	reset_7d_label_str=""
	[ -n "$resets_7d_label" ] && reset_7d_label_str=" (${resets_7d_label})"
	[ -n "$usage_parts" ] && usage_parts="${usage_parts}\033[2m │ \033[0m"
	usage_parts="${usage_parts}${U7_COLOR}wk${reset_7d_label_str} ${U7_BAR} ${usage_7d}%\033[0m"
	fi

	# Single line output
	line="\033[2m\033[96m${dir_name}\033[0m\033[2m${git_info} │ ${model_name} │ ${current_time} │ ${CTX_COLOR}ctx ${CTX_BAR} ${context_pct}%\033[0m"
	if [ -n "$usage_parts" ]; then
	line="${line}\033[2m │ \033[0m${usage_parts}"
	fi
	echo -e "$line"