Claude Code Statusline: Setup, Config, and Usage Limits

#!/usr/bin/env bash
# ~/.claude/statusline.sh
# Requires: bash, jq. Compatible with macOS and Linux.

# Read complete JSON payload passed via stdin from Claude Code
input=$(cat)

# 1. Model display name (shortened)
model=$(echo "$input" | jq -r '.model.display_name // .model.id // "Claude"')
model_short=$(echo "$model" | sed -E 's/Claude ([0-9.]+) ([A-Za-z]+)/\2 \1/; s/Claude //')

# 2. Workspace directory basename and optional git branch
dir=$(echo "$input" | jq -r '.workspace.current_dir // empty')
dir_base=""
if [ -n "$dir" ]; then
  dir_base=$(basename "$dir" 2>/dev/null)
fi
[ -z "$dir_base" ] && dir_base="workspace"

git_branch=""
if git rev-parse --is-inside-work-tree >/dev/null 2>&1; then
  branch=$(git branch --show-current 2>/dev/null || git rev-parse --short HEAD 2>/dev/null)
  [ -n "$branch" ] && git_branch=" (${branch})"
fi

# ANSI color codes
RESET="\033[0m"
BOLD="\033[1m"
GRAY="\033[90m"
GREEN="\033[32m"
YELLOW="\033[33m"
RED="\033[31m"

# Format percentage values with presentation color thresholds:
# green < 70%, yellow 70-89%, red >= 90%. Missing or null values render as "n/a".
format_pct() {
  local raw="$1"
  if [ -z "$raw" ] || [ "$raw" = "null" ]; then
    printf "${GRAY}n/a${RESET}"
    return
  fi

  local val
  val=$(printf "%.0f" "$raw" 2>/dev/null)
  if [ -z "$val" ]; then
    printf "${GRAY}n/a${RESET}"
    return
  fi

  local color="$GREEN"
  if [ "$val" -ge 90 ] 2>/dev/null; then
    color="$RED"
  elif [ "$val" -ge 70 ] 2>/dev/null; then
    color="$YELLOW"
  fi

  printf "${color}%d%%${RESET}" "$val"
}

# 3. Context window used percentage
ctx_raw=$(echo "$input" | jq -r '.context_window.used_percentage // empty')
ctx_disp=$(format_pct "$ctx_raw")

# 4. Five-hour and seven-day rate-limit percentages
limit_5h_raw=$(echo "$input" | jq -r '.rate_limits.five_hour.used_percentage // empty')
limit_7d_raw=$(echo "$input" | jq -r '.rate_limits.seven_day.used_percentage // empty')

disp_5h=$(format_pct "$limit_5h_raw")
disp_7d=$(format_pct "$limit_7d_raw")

# 5. Optional: Format 5-hour local reset time if available
reset_5h_epoch=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at // empty')
reset_5h_str=""
if [ -n "$reset_5h_epoch" ] && [ "$reset_5h_epoch" != "null" ]; then
  # Format epoch timestamp to local 12-hour clock (e.g., 03:15 PM) via jq built-in strflocaltime
  local_time=$(echo "$input" | jq -r '.rate_limits.five_hour.resets_at | strflocaltime("%I:%M %p")' 2>/dev/null)
  if [ -n "$local_time" ]; then
    reset_5h_str=" ${GRAY}(resets ${local_time})${RESET}"
  fi
fi

# 6. Output single compact terminal line
printf "${BOLD}[%s]${RESET} %s%s ${GRAY}|${RESET} Ctx: %b ${GRAY}|${RESET} 5h: %b%b ${GRAY}|${RESET} 7d: %b\n" \
  "$model_short" "$dir_base" "$git_branch" "$ctx_disp" "$disp_5h" "$reset_5h_str" "$disp_7d"