Claude Code Usage Status Line

Auto-detected project

Displays the name of the current directory (leaf of the path). You always know which project you are working on, without cluttering the line with the full path.

Active model

See which model is being used — Opus, Sonnet, Haiku, or GLM — directly in the status bar. The provider is automatically detected.

Usage percentages

Session, all models, Sonnet and Opus separated with colored indicators: green, yellow, red.

Countdown

Know exactly when your limits reset. The countdown ↻ appears next to each relevant metric.

Context Window

Monitor your context window usage to avoid hitting the limit mid-conversation.

z.ai / GLM Support

New: display your z.ai account balance (Bal: 9.88$) with automatic conversion to your currency of choice (EUR, GBP, CAD…).

Stale Data Indicator

A prefix ~ before a value indicates that the cache has expired but the API is unavailable (backoff 429). You always know what you are reading.

Smart Cache & Backoff

1-minute cache per provider to spare the APIs. In case of 429, automatic backoff of 5 minutes to avoid blowing the rate limits.

Zero Configuration (Claude)

Run the installer and that's it. Reads your Claude credentials automatically from ~/.claude/.credentials.json (and the Keychain on macOS).

Step 1: Retrieve the JWT

1. Open z.ai/manage-apikey/billing in your usual browser
2. Log in (and solve the captcha if prompted)
3. Open DevTools with F12, go to the Network tab
4. Refresh the page with F5
5. Click on the request named accountBalance
6. In Headers, copy the value of Authorizationwithout the prefix Bearer  (the token starts with eyJhbGciOiJIUzUxMiJ9)

Step 2: Save the JWT

A companion binary ClaudeUsageStatusline.ZaiRefresh is provided with the installation. It validates the token format and writes it to ~/.claude/.zai-credentials.json.

Windows:

&
  "$env:LOCALAPPDATA\ClaudeUsageStatusLine\ClaudeUsageStatusline.ZaiRefresh.exe"

Linux / macOS :

~/.local/bin/ClaudeUsageStatusline.ZaiRefresh

Step 3 (optional) : display currency

The balance is returned in USD by default. To display it in EUR (or any other currency), edit appsettings.json next to the executable :

{
    "Zai": {
      "NativeCurrency": "USD",
      "DisplayCurrency": "EUR",
      "ExchangeRateCacheHours": 24
    }
  }

The rates are retrieved once a day from a free API and cached locally.

When to refresh the JWT ?

The session JWT does not have an explicit expiration date — its lifespan is controlled by the z.ai servers. It will eventually be invalidated after a period of inactivity or an explicit logout.

Signs that it needs to be renewed :

• The statusline displays Bal: error
• The prefix ~Bal: (stale data) persists
• The logs contain 401 Unauthorized

Just restart ZaiRefresh and paste a fresh JWT.