A community open-source project by sirmalloc (
sirmalloc/ccstatusline). This guide reflects v2.2.32.
Why replace the status bar?
Claude Code’s default status bar shows only the essentials. During long sessions you want token usage, active model, and git branch visible at a glance — context-switching to check those costs attention.
ccstatusline is an independent CLI that lets you configure those widgets interactively.
Install and first setup
npx -y ccstatusline@latest
# or, with Bun
bunx -y ccstatusline@latest
This opens an interactive TUI. Use arrow keys to navigate, Enter to select, ESC to back out.
When you install from the TUI, ccstatusline writes the statusLine field in ~/.claude/settings.json for you. Claude Code reloads settings automatically and runs the status line command as soon as the file is saved, so the new bar appears without restarting your session.
There are two ways to install:
- Pinned global install (default) — installs the version you are running globally with npm or Bun and writes
"command": "ccstatusline"tosettings.json. Claude Code stays on that version, and the runner’s package resolution is skipped on every repaint. Afterward, runccstatuslinedirectly to open the TUI. - Auto-updating — writes
npx -y ccstatusline@latestso the status line always follows@latest.
Configure widgets
Choose which widgets to display. The widget picker supports search with substring and fuzzy matching.
- Model — active Claude model (Opus 5.5, Sonnet 5.5, etc.)
- Usage — Block Usage (current 5-hour block), Weekly Usage, Weekly Sonnet/Opus/Fable Usage, and Block Timer (time elapsed in the current block)
- Git Branch — current branch, alongside other Git widgets such as Git PR and Git CI Status
- Session Clock — elapsed session time
- Memory Usage — system memory usage
- Context %, Context Length — current context window usage
- Claude Status, Cache Timer — Claude service status and time remaining before the prompt cache expires
Enable only the widgets you actually need. Cramming too many widgets in a narrow terminal causes truncation.
Themes and colors
ccstatusline ships several Powerline-style themes — preview them with arrow keys. Per-widget color is adjustable in the TUI’s color settings, so you can match your terminal theme.
Refresh interval
Claude Code re-runs the status line on events such as a new assistant message or /compact finishing. For time-based widgets like clocks and usage, set refreshInterval from the TUI’s Configure Status Line menu to re-run it every 1-60 seconds as well (Claude Code 2.1.97 or later).
Editing the config later
Run the TUI again (ccstatusline, or npx -y ccstatusline@latest) to load the existing config and edit it. Settings are saved to ~/.config/ccstatusline/settings.json, so there’s no need to hand-edit any file. To back up or move a configuration, use the TUI’s Export Config and import options.