claudekit / tools / ccstatusline
[ Tool · Claude Code Utilities ]

ccstatusline

A Powerline-style status line for the Claude Code CLI. Show model, token usage, session time, and more at a glance.

sirmalloc/ccstatusline ·updated
$ npx -y ccstatusline@latest copy

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

  1. Configure themes, widgets, and colors interactively in the TUI.
  2. Monitor your 5-hour block consumption in real time via the token usage widget.
  3. See git branch, working directory, and session name at a glance.

Setup

ccstatusline setup screen

§ 6

See also

same category · curated
[01]
[Tool] Herdr · A terminal-native agent multiplexer in a single Rust binary. Herdr combines tmux-style session persistence and pane splits with agent awareness — a sidebar that shows whether each pane's agent is idle, working, blocked, or done — for Claude Code and other CLI agents. The direct Claude Code integration (`herdr integration install claude`) adds full state detection, semantic state forwarding over a local socket API, and agent-session restoration after a server restart.
tool · claudekit.io / tools / herdr
[02]
[Tool] CC Workflow Studio · Design workflows on a canvas in VS Code and export them as Markdown your AI agent already understands — skills, commands, and agents for Claude Code, Cursor, Copilot, and more. An MCP server runs in the background so you can refine workflows in natural language with 'Edit with AI'.
tool · claudekit.io / tools / cc-wf-studio
[03]
[Skill] Find Skills · A meta-skill that activates when users ask "how do I do X" or "is there a skill that can…", then searches the open agent skills ecosystem and walks the user through installation.
tool · claudekit.io / tools / find-skills
§ 7

Frequently Asked Questions

frequently asked
§ 7.1
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.
§ 7.2
Where does it run?
It replaces the Claude Code status bar.
§ 7.3
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.
§ 7.4
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.