Claude Code status line: context + 5h/7d rate limit bars with reset times, clickable repo/branch/ticket/MR links (jq only; optional glab)

A developer created a custom status line for Claude Code that displays context usage, rate limit bars with reset times, and clickable links to the repository, branch, and tickets. The script uses jq and optionally glab, and supports OSC 8 hyperlinks for terminals like iTerm2 and kitty.

| /bin/bash | | | Claude Code status line — two lines, subscription-focused rate limits, no cost . | | | | | | ● my-project · ✦ Fable 5 · ⚡high · 🧠 · 🏷 ACME-123 feature/ACME-123-fix · 🔀 42 | | | ██████░░░░ 62% 124k/200k · 5h ████░░░░░░ 41% →17:00 · 7d ██░░░░░░░░ 23% →Wed · ⏱ 34m | | | | | | Features | | | - Context bar: tokens used vs window, green/yellow/red at 70/90% | | | - Rate limits: 5-hour + weekly windows as matching bars, with reset time | | | clock time for 5h, weekday for 7d . Claude.ai Pro/Max only; hidden otherwise. | | | - Clickable OSC 8 project name - repo, branch - tree, Jira/GitLab ticket | | | parsed from the branch name, open MR badge via glab cached, non-blocking | | | - Effort + thinking badges, session duration, subdir indicator | | | | | | Requirements: jq. Optional: glab MR badge , git. macOS + Linux. | | | Terminals with OSC 8 support iTerm2, Ghostty, WezTerm, kitty get clickable | | | links; others just show plain text. | | | | | | Install: | | | 1. Save as ~/.claude/statusline.sh && chmod +x ~/.claude/statusline.sh | | | 2. In ~/.claude/settings.json: | | | "statusLine": { "type": "command", "command": "~/.claude/statusline.sh" } | | | | | | ── config ───────────────────────────────────────────────────────────────── | | | Jira links are per-project: map each Jira project-key PREFIX to its base URL. | | | Only prefixes listed here get a clickable link; an unknown prefix shows the | | | ticket ID as plain text never a wrong link . Add one line per project. | | | GitLab/GitHub issue + repo links need NO config built from the git origin . | | | jira base for { | | | case "$1" in | | | ACME printf 'https://acme.atlassian.net' ;; | | | printf '' ;; | | | esac | | | } | | | GIT CACHE TTL=5 seconds; branch lookup is cached per session to keep renders fast | | | ─────────────────────────────────────────────────────────────────────────── | | | input=$ cat | | | One jq call: floors numerics, defaults nulls, -1 sentinel for absent rate limit. | | | 0x1F unit separator delimiter: non-whitespace, so read keeps empty fields | | | instead of collapsing consecutive ones the tab/whitespace-IFS gotcha . | | | IFS=$'\037' read -r MODEL PROJECT CURDIR PCT WIN TOKENS DURATION MS EFFORT THINK SID RHOST ROWNER RNAME RATE5 RATE7 RESET5 RESET7 < < | | | printf '%s' "$input" | jq -r ' | | | .model.display name // "?" , | | | .workspace.project dir // .workspace.current dir // "." , | | | .workspace.current dir // "." , | | | .context window.used percentage // 0 | floor , | | | .context window.context window size // 200000 , | | | .context window.total input tokens // 0 , | | | .cost.total duration ms // 0 | floor , | | | .effort.level? // "" , | | | .thinking.enabled // false , | | | .session id // "default" , | | | .workspace.repo.host? // "" , | | | .workspace.repo.owner? // "" , | | | .workspace.repo.name? // "" , | | | .rate limits.five hour.used percentage // -1 | floor , | | | .rate limits.seven day.used percentage // -1 | floor , | | | .rate limits.five hour.resets at // -1 | floor , | | | .rate limits.seven day.resets at // -1 | floor | | | | map tostring | join "�" ' | | | | | | Guard PCT so the integer comparisons below never crash on empty/non-numeric. | | | case "$PCT" in ''| 0-9 PCT=0 ;; esac | | | "$PCT" -gt 100 && PCT=100 | | | ── colors literal ESC so we can printf '%s' ───────────────────────────── | | | ESC=$'\033' | | | CYAN="${ESC} 36m"; GREEN="${ESC} 32m"; YELLOW="${ESC} 33m"; RED="${ESC} 31m" | | | MAGENTA="${ESC} 35m"; BLUE="${ESC} 34m"; DIM="${ESC} 2m"; BOLD="${ESC} 1m"; RESET="${ESC} 0m" | | | BEL=$'\a'; OSC="${ESC} 8;;" | | | OSC 8 hyperlink: hlink <url <text | | | hlink { printf '%s%s%s%s%s%s' "$OSC" "$1" "$BEL" "$2" "$OSC" "$BEL"; } | | | ── context bar pure bash; tr corrupts in C locale ─────────────────────── | | | if "$PCT" -ge 90 ; then BAR COLOR="$RED" | | | elif "$PCT" -ge 70 ; then BAR COLOR="$YELLOW" | | | else BAR COLOR="$GREEN"; fi | | | FILLED=$ PCT / 10 ; EMPTY=$ 10 - FILLED | | | bar { local n=$1 ch=$2 o=; while "$n" -gt 0 ; do o="$o$ch"; n=$ n - 1 ; done; printf '%s' "$o"; } | | | BAR="$ bar "$FILLED" '█' $ bar "$EMPTY" '░' " | | | fmt k { awk -v n="$1" 'BEGIN{if n =1000000 printf "%.1fM",n/1000000;else if n =1000 printf "%dk",n/1000;else printf "%d",n}'; } | | | TOK H=$ fmt k "$TOKENS" ; WIN H=$ fmt k "$WIN" | | | MINS=$ DURATION MS / 60000 | | | ── git branch + origin remote cached per session ──────────────────────── | | | mtime { stat -f %m "$1" 2 /dev/null || stat -c %Y "$1" 2 /dev/null; } | | | CACHE="${TMPDIR:-/tmp}/cc sl branch ${SID}" | | | NOW=$ date +%s | | | if -f "$CACHE" && $ NOW - $ mtime "$CACHE" -lt "$GIT CACHE TTL" ; then | | | IFS=$'\037' read -r BRANCH GREMOTE < "$CACHE" | | | else | | | GITDATA=$ cd "$CURDIR" 2 /dev/null && printf '%s\037%s' \ | | | "$ git symbolic-ref --short -q HEAD 2 /dev/null " \ | | | "$ git remote get-url origin 2 /dev/null " 2 /dev/null | | | printf '%s' "$GITDATA" "$CACHE" 2 /dev/null | | | IFS=$'\037' read -r BRANCH GREMOTE <<< "$GITDATA" | | | fi | | | ── repo web URL from the git origin handles nested GitLab groups, where | | | the JSON's workspace.repo.owner/name would drop the subgroup ; JSON is fallback. | | | REPO URL="" | | | if -n "$GREMOTE" ; then | | | REPO URL=$ printf '%s' "$GREMOTE" | sed -E \ | | | -e 's ^git@ ^: + : https://\1/ ' \ | | | -e 's ^ssh://git@ ^/ + / https://\1/ ' \ | | | -e 's ^https:// ^@/ @ https:// ' \ | | | -e 's \.git$ ' | | | elif -n "$RHOST" ; then | | | REPO URL="https://${RHOST}/${ROWNER}/${RNAME}" | | | fi | | | RWEB HOST="${REPO URL https://}"; RWEB HOST="${RWEB HOST%%/ }" | | | ── ticket from branch Jira key, else GitLab issue number ───────────────── | | | TICKET=""; TICKET URL="" | | | jira re=' A-Z {2,}- 0-9 + ' | | | gl re='^ 0-9 + - / ' | | | if "$BRANCH" =~ $jira re ; then | | | TICKET="${BASH REMATCH 1 }" | | | base="$ jira base for "${TICKET%%- }" " prefix before the dash - Jira host | | | -n "$base" && TICKET URL="${base}/browse/${TICKET}" | | | elif "$BRANCH" =~ $gl re ; then | | | num="${BASH REMATCH 1 }" | | | TICKET=" ${num}" | | | -n "$REPO URL" && TICKET URL="${REPO URL}/-/issues/${num}" | | | fi | | | Branch name links to its page on the remote GitLab tree, or GitHub tree . | | | BRANCH DISP="$BRANCH" | | | if -n "$REPO URL" && -n "$BRANCH" ; then | | | case "$RWEB HOST" in | | | github TREE URL="${REPO URL}/tree/${BRANCH}" ;; | | | TREE URL="${REPO URL}/-/tree/${BRANCH}" ;; | | | esac | | | BRANCH DISP="$ hlink "$TREE URL" "$BRANCH" " | | | fi | | | ── open merge request for this branch GitLab via glab ──────────────────── | | | A network call, so the result is cached MR TTL and refreshed by a detached | | | background job: renders never block, showing the last-known value meanwhile. | | | An anti-stampede attempt file caps spawns to one per ~20s while a fetch runs. | | | Needs glab authed to the origin host; if glab is missing/unauthed the MR | | | segment just stays empty no error . | | | MR IID=""; MR URL=""; MR DRAFT=""; MR TTL=90 | | | if -n "$BRANCH" && -n "$REPO URL" ; then | | | MRCACHE="${TMPDIR:-/tmp}/cc sl mr ${SID}"; ATT="${MRCACHE}.attempt" | | | if -f "$MRCACHE" ; then | | | IFS=$'\037' read -r cb MR IID MR URL MR DRAFT < "$MRCACHE" | | | "$cb" = "$BRANCH" || { MR IID=""; MR URL=""; MR DRAFT=""; } | | | fi | | | fresh=0 | | | -f "$MRCACHE" && "$cb" = "$BRANCH" && $ NOW - $ mtime "$MRCACHE" -lt "$MR TTL" && fresh=1 | | | if "$fresh" = 0 && command -v glab /dev/null 2 &1 \ | | | && { -f "$ATT" || $ NOW - $ mtime "$ATT" -ge 20 ; }; then | | | : "$ATT" 2 /dev/null | | | | | | cd "$CURDIR" 2 /dev/null || exit | | | out=$ glab mr list -s "$BRANCH" -F json 2 /dev/null \ | | | | jq -r ' . 0 // {} | .iid // "" |tostring , .web url // "" , .draft // false |tostring | join "�" ' 2 /dev/null | | | printf '%s\037%s\n' "$BRANCH" "$out" "${MRCACHE}.tmp" 2 /dev/null | | | mv -f "${MRCACHE}.tmp" "$MRCACHE" 2 /dev/null | | | /dev/null 2 &1 & | | | fi | | | fi | | | MR SEG="" | | | if -n "$MR IID" ; then | | | if "$MR DRAFT" = "true" ; then MC="$DIM"; else MC="$MAGENTA"; fi | | | if -n "$MR URL" ; then MR DISP="$ hlink "$MR URL" " ${MR IID}" "; else MR DISP=" ${MR IID}"; fi | | | MR SEG=" · ${MC}🔀 ${MR DISP}${RESET}" | | | fi | | | ── working / idle status ────────────────────────────────────────────────── | | | if -n "$BRANCH" ; then | | | STATUS="${GREEN}●${RESET}" | | | else | | | STATUS="${DIM}○${RESET}" | | | fi | | | ── project name linked to repo + relative dir segment ─────────────────── | | | PROJECT NAME="${PROJECT /}" | | | if -n "$REPO URL" ; then | | | PROJ DISP="$ hlink "$REPO URL" "$PROJECT NAME" " | | | else | | | PROJ DISP="$PROJECT NAME" | | | fi | | | At root the project name is already on line 1 status badge ; only show 📁 once | | | you've navigated into a subdir/submodule, so it reads as a "you moved" signal. | | | if "$CURDIR" = "$PROJECT" ; then | | | DIRSEG="" | | | else | | | REL="${CURDIR "$PROJECT"/}" | | | if "$REL" = "$CURDIR" ; then DIRSEG="📁 ${CURDIR /}"; else DIRSEG="📁 › ${REL}"; fi | | | fi | | | ── badges ───────────────────────────────────────────────────────────────── | | | EFFORT BADGE="" | | | if -n "$EFFORT" ; then | | | case "$EFFORT" in | | | low EC="$DIM" ;; medium EC="$GREEN" ;; high EC="$YELLOW" ;; | | | xhigh|max EC="$RED" ;; EC="$RESET" ;; | | | esac | | | EFFORT BADGE=" · ${EC}⚡${EFFORT}${RESET}" | | | fi | | | THINK BADGE="" | | | "$THINK" = "true" && THINK BADGE=" · ${MAGENTA}🧠${RESET}" | | | work segment: ticket+branch when working, dim "idle" otherwise | | | if -n "$BRANCH" ; then | | | if -n "$TICKET" ; then | | | if -n "$TICKET URL" ; then TKT DISP="$ hlink "$TICKET URL" "$TICKET" "; else TKT DISP="$TICKET"; fi | | | WORK SEG=" · 🏷 ${TKT DISP} ${DIM} ${BRANCH DISP} ${RESET}${MR SEG}" | | | else | | | WORK SEG=" · ${DIM} ${BRANCH DISP} ${RESET}${MR SEG}" | | | fi | | | else | | | WORK SEG=" · ${DIM}idle${RESET}" | | | fi | | | ── rate limits Claude.ai Pro/Max; absent for API-key users ────────────── | | | rate bars: same glyphs/colors/width as the context bar | | | rate bar { | | | local p=$1 c | | | if "$p" -ge 90 ; then c="$RED" | | | elif "$p" -ge 70 ; then c="$YELLOW" | | | else c="$GREEN"; fi | | | local f=$ p / 10 ; "$f" -gt 10 && f=10 | | | printf '%s%s%s%s' "$c" "$ bar "$f" '█' " "$ bar $ 10 - f '░' " "$RESET" | | | } | | | fmt epoch <epoch <format : BSD date first, GNU date fallback | | | fmt epoch { date -r "$1" "$2" 2 /dev/null || date -d "@$1" "$2" 2 /dev/null; } | | | reset markers: 5h window resets within hours clock time , 7d within days weekday | | | R5=""; R7="" | | | "$RESET5" -gt 0 2 /dev/null && R5=" ${DIM}→$ fmt epoch "$RESET5" +%H:%M ${RESET}" | | | "$RESET7" -gt 0 2 /dev/null && R7=" ${DIM}→$ fmt epoch "$RESET7" +%a ${RESET}" | | | RATE SEG="" | | | "$RATE5" -ge 0 2 /dev/null && RATE SEG=" · 5h $ rate bar "$RATE5" ${RATE5}%${R5}" | | | "$RATE7" -ge 0 2 /dev/null && RATE SEG="${RATE SEG} · 7d $ rate bar "$RATE7" ${DIM}${RATE7}%${RESET}${R7}" | | | ── render ───────────────────────────────────────────────────────────────── | | | printf '%s %s · ✦ %s%s%s%s%s\n' \ | | | "$STATUS" "$PROJ DISP" "${CYAN}${MODEL}${RESET}" "$EFFORT BADGE" "$THINK BADGE" "$WORK SEG" "" | | | DIR PREFIX=""; -n "$DIRSEG" && DIR PREFIX="${DIRSEG} · " | | | printf '%s%s%s%s %s%% %s %s/%s %s%s · ⏱ %sm\n' \ | | | "$DIR PREFIX" "$BAR COLOR" "$BAR" "$RESET" "$PCT" "$DIM" "$TOK H" "$WIN H" "$RESET" "$RATE SEG" "$MINS" |