Claude Code Stat Bar

English | 简体中文

A minimalist status bar for the Claude Code CLI.

Status bar fields:

Context usage ↑input tokens ↓output tokens | 5h usage reset countdown weekly usage reset countdown | Cost duration | Model name (context window) | Project > Branch

Note: usage information is only shown for Claude subscribers.

Requirements

• Node.js 18+
• Git

Installation and Configuration

Just configure Claude Code's settings.json. No file download is required:

{
  "statusLine": {
    "type": "command",
    "command": "npx cc-stat-bar@latest"
  }
}

If startup speed matters, install it globally first with npm install -g cc-stat-bar, then change command to cc-stat-bar.

Uninstall

1. Run this command in Claude Code:

/statusline delete

2. If you installed cc-stat-bar globally, you can uninstall it with npm uninstall -g cc-stat-bar.

Advanced Configuration

Customize displayed modules and order

By default, all information is shown. You can append arguments after the command path to choose which modules to display and in what order.

Available modules:

• context: context usage and token counts
• rateLimits: 5-hour / 7-day token usage and reset countdown
• cost: accumulated cost and session duration
• model: current model name and context window size
• workspace: project directory and Git branch

Theme Switching

Supports both dark (default) and light themes:

"command": "npx cc-stat-bar --theme light"

Configuration Examples

Example 1: Show only context and usage

"command": "npx cc-stat-bar context rateLimits"

Example 2: Custom order + light theme

"command": "npx cc-stat-bar --theme light model context cost"