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@latest

Restart Claude Code. The statusline appears at the bottom.

From source

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

The project scripts are package-manager agnostic. You can use npm, pnpm, or bun as long as dependencies are installed.

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)
• Token generation speed (tok/s)
• Context window token usage (used/total)
• 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, tokenSpeed, contextUsage, 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

• Node.js >= 18
• Claude Code >= 2.0
• macOS or Linux

Removal

npx @whallysson/claude-status@latest --uninstall

Removes the statusline config from Claude Code settings.

License

MIT