claude-status

A statusline for Claude Code that shows model, context usage, rate limits, cost, git info, and more.

Zero runtime dependencies. Secure. Fully configurable.

Installation

npx @whallysson/claude-status

Restart Claude Code. The statusline appears at the bottom.

From source

git clone https://github.com/whallysson/claude-status.git
cd claude-status
bun install
bun run build
bun run install-status

What it shows

• Model name with plan tier (Max, Pro, Free)
• Context window usage with progress bar
• Git branch and dirty state
• Session cost (USD) and duration
• Rate limits (current and weekly, Pro/Max only)
• Lines added/removed
• Cumulative tokens (in/out)
• Thinking mode indicator
• Vim mode (NORMAL/INSERT)
• Active agent name
• Animated mascot (idle blink, active jumping jacks)

Changing the theme

Create ~/.config/claude-status/config.json:

{
  "theme": "catppuccin"
}

Available themes:

| Theme | Style | |-------|-------| | default | Balanced colors, good contrast | | catppuccin | Soft pastels, easy on the eyes | | tokyonight | Cool blues and purples | | minimal | Muted, text-based icons | | neon | Vibrant, high saturation | | none | No colors |

Restart Claude Code after changing the theme.

Hiding components

Don't want to see tokens or vim mode? Disable them:

{
  "components": {
    "tokens": { "enabled": false },
    "vimMode": { "enabled": false }
  }
}

Changing the layout

Control which components appear on each line:

{
  "layout": {
    "lines": [
      {
        "components": ["model", "context", "workspace", "session"],
        "separator": " | "
      },
      {
        "components": ["rateLimit"],
        "separator": " | "
      }
    ]
  }
}

Available components: model, context, workspace, session, linesChanged, thinking, vimMode, agent, rateLimit, tokens, contextWarning, mascot

Rate limits

Rate limit data comes directly from Claude Code via stdin (available since v2.1.80). No API tokens or external calls are needed.

This feature is only available for Pro and Max subscribers. On Free plans, the rate limit line is simply omitted.

Requirements

• Bun >= 1.0.0 (or Node.js >= 18)
• Claude Code >= 2.0
• macOS or Linux

Removal

npx @whallysson/claude-status --uninstall

Removes the statusline config from Claude Code settings.

License

MIT