Skip to content

Status Line

Jump to bottom
Falco Schmutz edited this page Jul 7, 2026 · 1 revision

Claude Code status line

A condensed, one-line usage view rendered under the Claude Code prompt — the same numbers as the panels, without leaving your terminal.

Context ▌░░░░░ 8%  Session █▌░░░░ 26% 59m  Week █▌░░░░ 24%  Fable █▊░░░░ 29% 1d18h

Each limit gets a compact severity-colored gauge (green / yellow / red) plus a reset countdown; the context-window usage Claude Code passes on stdin gets its own gauge. It shares the read-only data model of the GNOME extension and the macOS app (token from ~/.claude/.credentials.json or the macOS Keychain).

Install

cd claude-code
./install.sh

install.sh copies the script into ~/.claude and merges a statusLine entry into ~/.claude/settings.json without clobbering other settings (idempotent). Open a new session or run /statusline to see it. Needs only Node.js (already present — Claude Code runs on it) and a Claude Code login.

Behavior

  • Caching: successful responses are cached for ~2 minutes; a failed fetch (e.g. HTTP 429) keeps the last good data and backs off, so the rate-limited endpoint is not re-hit on every render.
  • Fallback: fresh cache → live fetch → stale cache → the Session/Week rate_limits Claude Code passes on stdin → a sign-in hint.
  • Safe: never writes credentials, EPIPE-safe, 4s fetch timeout.

Details

See claude-code/README.md.

Clone this wiki locally