ccstatusline: Custom Status Line for Claude Code

ccstatusline is a highly customizable status line formatter for Claude Code. Instead of writing your own shell script for Claude Code’s statusLine setting, you configure widgets in an interactive TUI: model name, git branch and PR, context percentage, context window, session and weekly usage bars, cost tracking, compaction counter, reset timers and more, with Powerline styling if you like it.

Who it is for

Claude Code users who want key session facts always visible, especially context fill and remaining usage, without leaving the conversation to run /usage or /context.

Install

Run the configuration TUI:

npx -y ccstatusline@latest

Or with Bun:

bunx -y ccstatusline@latest

From the TUI, install it to Claude Code. It writes something like this to your settings:

{
  "statusLine": {
    "type": "command",
    "command": "npx -y ccstatusline@latest",
    "padding": 0,
    "refreshInterval": 10
  }
}

refreshInterval is only written when your Claude Code version supports it.

Use cases

• Watch context percentage climb and compact or start fresh before quality drops.
• Keep weekly usage and reset time visible during heavy weeks.
• Show the current git branch and PR status when juggling worktrees.
• Track estimated session cost while experimenting with models.

Pros

• No scripting: a TUI with live preview and many widgets.
• Active project with frequent releases and security hardening.
• MIT licensed; works on macOS, Linux and Windows.

Cons and caveats

• @latest resolution adds repaint latency; prefer the pinned install.
• Widgets that call git, gh or usage APIs add small overhead per refresh.
• Settings imports can include shell commands; the TUI asks for confirmation, so read them.

Links

• Repo: sirmalloc/ccstatusline
• Related: Claude Code Usage Monitor, ccusage, context management guide