statusline

A status line for Claude Code and Google Antigravity (agy) that shows which model is answering, how much context window you have used, and how much of your plan budget is left.

• The model that is answering. A mid-session model switch, such as a fallback when a weekly window runs out, moves the field on the new model's first reply.
• Budget left, not just tokens spent. Percent left and a countdown to reset for every window the account reports.
• Context window in tokens and percent of the window in use.

Percentages are colored by how much is used: green below 70%, orange to 90%, red above.

Session cost in USD shows for API key, Bedrock and Vertex usage, and is hidden when the account reports plan rate limits. CC_STATUSLINE_COST=1 forces it, =0 hides it.

A native PowerShell version (statusline.ps1) is provided for Windows users so it runs without needing Bash or jq.

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Y-T-G/statusline/main/install.ps1" -OutFile "$env:TEMP\install.ps1"; & "$env:TEMP\install.ps1"

Invoke-WebRequest -Uri "https://raw.githubusercontent.com/Y-T-G/statusline/main/install.ps1" -OutFile "$env:TEMP\install.ps1"; $env:CLAUDE_CONFIG_DIR = "$env:USERPROFILE\.gemini\antigravity-cli"; & "$env:TEMP\install.ps1"

To install in full mode or with usage-api, append the flags to either command above:

& "$env:TEMP\install.ps1" -Mode full -UsageApi

Needs bash and jq.

curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | bash

To install in full mode or with usage-api:

curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | bash -s -- full usage-api

This status line natively parses the distinct quota schema used by agy. To install it, point the installer to the Antigravity config directory:

curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | CLAUDE_CONFIG_DIR=~/.gemini/antigravity-cli bash

(You can also append -s -- full to install full mode).

The installer downloads the statusline script to your config directory and adds a statusLine entry to settings.json, keeping a backup at .bak. To safely remove it:

Windows (PowerShell):

& "$env:TEMP\install.ps1" -Uninstall

Linux/macOS (Bash):

# For Claude Code:
curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | bash -s -- --uninstall

# For Antigravity (agy):
curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | CLAUDE_CONFIG_DIR=~/.gemini/antigravity-cli bash -s -- --uninstall

To wire it by hand instead:

{
  "statusLine": {
    "type": "command",
    "command": "bash \"/path/to/statusline/statusline.sh\" minimal",
    "refreshInterval": 30
  }
}

refreshInterval redraws the countdown. The host CLI redraws on its own when token usage or the model changes, and the usage fetch below is gated by its cache, so the interval does not change how many requests go out.

In Claude Code, the payload carries the session and overall weekly windows only. A separately metered model, today Fable, has its own bar in /usage, which comes from the account usage endpoint. Pass usage-api to read it too:

curl -fsSL https://raw.githubusercontent.com/Y-T-G/statusline/main/install.sh | bash -s -- minimal usage-api

Each window is labeled with its own name and shown only while the account reports it.

This reads the OAuth token from ~/.claude/.credentials.json (or $CLAUDE_CONFIG_DIR/.credentials.json) and calls GET /api/oauth/usage, so it needs a subscription login with the token in a file. It does not work with an API key, or on macOS where the credentials live in the Keychain.

The answer is cached in ~/.cache/statusline/ and refreshed in the background, so no redraw waits on the network. At most one request is in flight per machine and the ceiling is 12 an hour, dropping to none while the session is idle. A failed fetch keeps the old cache and pauses further attempts.

The host CLI passes a JSON payload to the status line command on stdin. This script reads:

The budget numbers are the same ones /usage reports. Fields the payload does not carry are skipped, so an API key session (in Claude Code) shows context and cost only.

If ~/.claude/statusline-extra.sh (or $CLAUDE_CONFIG_DIR/statusline-extra.sh) exists, it is run with the same JSON on stdin and its output is appended. On Windows, the PowerShell script looks for statusline-extra.ps1 instead.

Example that adds the git branch:

Linux / macOS (Bash):

#!/usr/bin/env bash
git branch --show-current 2>/dev/null

Windows (PowerShell):

git branch --show-current 2>$null

The screenshots above are generated from real output with assets/render.py, which needs cairosvg.

MIT