A Powerline-style status line for the Claude Code CLI. Show model, token usage, session time, and more at a glance.
npx -y ccstatusline@latest bunx ccstatusline@latest What it does
ccstatusline replaces Claude Code’s default status bar with a configurable Powerline-style line that surfaces the things you actually look at mid-session: active model, session token usage, time elapsed, git branch, and more.
Features
- Powerline-style segments — nerd-font icons, separators, colors
- Configurable widgets — show only what you need: model, tokens, cost, branch, session time
- Themeable — light, dark, and custom color schemes
- Low overhead — runs via
npx, no global install required
Installation
Works out of the box via npx — no config needed to get started. Run once and follow the interactive setup to pick widgets.
Use cases
- Configure themes, widgets, and colors interactively in the TUI.
- Monitor your 5-hour block consumption in real time via the token usage widget.
- See git branch, working directory, and session name at a glance.
Setup
Frequently Asked Questions
What is ccstatusline?
An independent CLI that replaces the Claude Code terminal status bar with a Powerline-style line, showing the model, token usage, git branch, session timer, and memory at a glance.
Where does it run?
It replaces the Claude Code status bar.
How do I install it?
Run `npx -y ccstatusline@latest` (or `bunx ccstatusline@latest`) to launch the interactive TUI and pick themes, widgets, and colors.
When is it most useful?
Configuring themes, widgets, and colors interactively in the TUI; monitoring 5-hour usage block consumption live; checking git branch, working directory, and session name from the status bar without breaking flow.