Add a Super‑Cool Status Bar to Claude Code for Instant Visual Feedback

Problem

When using Claude Code for extended periods, users cannot see the current model, token consumption, estimated cost, or Git branch without issuing separate commands.

Solution – ccstatusline

ccstatusline is an open‑source status‑line tool for the Claude Code CLI that aggregates model name, Git branch, token usage, context occupancy, cost estimate, and real‑time speed, displaying them continuously at the bottom of the terminal.

Repository stars exceed 9 k, current version is v2.2.19, and updates are frequent.

Core Features

Token and cost monitoring : Shows input tokens, output tokens, total tokens, and session cost in USD. Includes a token‑speed component (tokens per second) configurable with a sliding window from 0 s (average over the whole session) to 120 s (recent speed).

Context visualization : Provides length, percentage, progress bar, and a Compaction Counter that records how many times Claude performed context compaction.

Git information : Displays branch name, staged/unstaged file counts, conflict count, ahead/behind status, commit SHA, PR details (GitHub/GitLab), added/deleted lines, and can render the branch as a clickable link.

Powerline themes : Multiple themes with arrow separators and gradient colors, supporting 16‑color, 256‑color, and true‑color modes.

Interactive TUI configuration : A terminal UI allows adding, removing, reordering, and styling up to 70 components without editing JSON manually; includes fuzzy search for components.

Installation

Via Claude Code : Provide the GitHub URL to Claude Code, then run ccstatusline-zh setup to configure.

Manual install (global) : npm install -g ccstatusline-zh Manual install (non‑global) : npx -y ccstatusline@latest Note: npx may incur network latency on slow connections.

Configuration

Edit the Claude Code settings file ( ~/.claude/settings.json on Unix or %USERPROFILE%\.claude\settings.json on Windows) and add the following snippet:

{
  "statusLine": {
    "type": "command",
    "command": "ccstatusline-zh",
    "padding": 0,
    "refreshInterval": 10
  }
}

Restart Claude Code to activate the status bar. The refreshInterval accepts values from 1 to 60 seconds; versions prior to 2.1.97 ignore this field.

Custom Configuration

Run ccstatusline-zh setup to launch the TUI configuration interface. Users can select any of the supported components, arrange their order, adjust colors, and switch themes. The interface includes fuzzy search to locate components among the 70 available.

Repository URLs

Original repository: https://github.com/sirmalloc/ccstatusline

Chinese fork: https://github.com/huangguang1999/ccstatusline-zh