A custom status line for Claude Code that displays model info, token usage, rate limits, and reset times in a single compact line. It runs as an external shell command, so it does not slow down Claude Code or consume any extra tokens.
This is a patched fork for Claude Max users: zero outbound calls, zero credential reads, reset shown as a remaining-time countdown. What changed vs. upstream
daniel3303/ClaudeCodeStatusLine(and the one-time supply-chain audit) is documented in LOCAL-PATCH.md.
One command. It clones/updates into ~/.claude/statusline, installs deps, self-tests, and merges only the statusLine key into your settings.json (other keys untouched). It aborts without touching settings.json if the self-test fails. Then restart Claude Code.
Linux / macOS
curl -fsSL https://raw.githubusercontent.com/simonliusm/ClaudeCodeStatusLine/main/install.sh | bashWindows (PowerShell)
irm https://raw.githubusercontent.com/simonliusm/ClaudeCodeStatusLine/main/install.ps1 | iexPrefer not to pipe to a shell? Clone first, then run the installer:
# Linux / macOS
git clone https://github.com/simonliusm/ClaudeCodeStatusLine ~/.claude/statusline 2>/dev/null || git -C ~/.claude/statusline pull --ff-only
bash ~/.claude/statusline/install.sh# Windows
$d="$env:USERPROFILE\.claude\statusline"; if (Test-Path "$d\.git") { git -C $d pull --ff-only } else { git clone https://github.com/simonliusm/ClaudeCodeStatusLine $d }
powershell -NoProfile -ExecutionPolicy Bypass -File "$d\install.ps1"The installer prints a final RESULT: os=… sha=… cmd=… line; paste that back if a CC ran it for you.
| Segment | Description |
|---|---|
| Model | Current model name (e.g., Opus 4.7) |
| CWD@Branch | Current folder name, git branch, and file changes (+/-) |
| Tokens | Used / total context window tokens (% used) |
| Effort | Reasoning effort level (low, med, high, xhigh) |
| 5h | 5-hour rate limit usage percentage and reset time |
| 7d | 7-day rate limit usage percentage and reset time |
| Extra | Extra usage credits spent / limit (if enabled) |
| Update | Appears when a new version is available (checked every 24h) |
Usage percentages are color-coded: green (<50%) → yellow (≥50%) → orange (≥70%) → red (≥90%).
Ask Claude Code:
Clone https://github.com/daniel3303/ClaudeCodeStatusLine to
~/.claude/statusline/(or%USERPROFILE%\.claude\statusline\on Windows) and configure it as my status bar by following its INSTALL.md.
Claude will clone the repo to that path, pick the right script for your OS, and update settings.json. Full step-by-step instructions Claude follows live in INSTALL.md.
Restart Claude Code after Claude saves the configuration.
When the status line shows a new release is available, ask Claude:
Find my installed status bar and update it.
Or update it yourself:
git -C ~/.claude/statusline pullNo settings.json changes are needed — the path stays valid across versions.
- Claude Code with OAuth authentication (Pro/Max subscription for rate-limit and extra-usage data)
gitinPATH- macOS / Linux:
jqandcurl - Windows: PowerShell 5.1+ (default on Windows 10/11)
Usage data from the Anthropic API is cached for 60 seconds at /tmp/claude/statusline-usage-cache-<hash>.json (or %TEMP%\claude\... on Windows). Release checks are cached for 24 hours. Both caches are shared across concurrent Claude Code instances to avoid rate limits.
The status line checks GitHub for new releases once every 24 hours. When a newer version is available, a second line appears below the status line. The check fails silently if the API is unreachable.
MIT
Daniel Oliveira
