Claude Code Status Line

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.

Screenshot

What it shows

| 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%).

Installation

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.

Updating

When the status line shows a new release is available, ask Claude: