ClaudeCodeStatusLine

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

Usage percentages are color-coded: green ( 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:
Find my installed status bar and update it.

Or update it yourself:

No settings.json changes are needed — the path stays valid across versions.

Requirements

- Claude Code with OAuth authentication (Pro/Max subscription for rate-limit and extra-usage data)
- git in PATH
- macOS / Linux: jq and curl
- Windows: PowerShell 5.1+ (default on Windows 10/11)

Caching

Usage data from the Anthropic API is cached for 60 seconds at /tmp/claude/statusline-usage-cache-.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.

Update Notifications

The status line checks GitHub for new releases once every 24 hours via an outbound HTTP request to api.github.com. When a newer version is available, a second line appears below the status line. The check fails silently if the API is unreachable.

To disable the update check entirely (no network…