Repolode
Submit
sirmalloc

sirmalloc/ccstatusline

A customizable status line for Claude Code CLI that shows model, git branch, token usage, usage limits and more, with Powerline support and themes.

View on GitHub
Stars
13,335
Forks
667
Open issues
173
Last commit
10 hours ago

What is it?

ccstatusline is a status line formatter for Claude Code, the terminal coding agent from Anthropic. It renders a configurable bar at the bottom of the Claude Code interface, showing items such as the model name, git branch and status, token counts and speed, session cost, session duration, context usage, and Claude usage limits. Each element is a widget that can be added, reordered, colored, or hidden through an interactive terminal UI built with React and Ink.

The project supports standard and Powerline-style layouts with arrow separators, caps, and flex alignment, along with built-in themes and per-widget or line-wide gradient colors. Multiple independent status lines are supported, and settings can be exported to JSON and imported with a preview step. Configuration is stored in a settings file under the user's config directory, and the Claude Code config location can be changed with an environment variable.

The tool runs through npx or bunx without a global install, and can also be pinned to a specific version. It works on Linux, macOS, and Windows, and can run under either Node.js or Bun.

Key features

  • 01Displays model, git, token, cost, context and usage-limit widgets in the Claude Code status line.
  • 02Interactive terminal UI for adding, reordering and coloring widgets.
  • 03Powerline-style rendering with arrow separators, caps and flex alignment.
  • 04Multiple independent status lines with built-in themes and gradient colors.
  • 05Export and import of settings as JSON with a preview before replacing or merging.
  • 06Runs via npx or bunx, with optional pinned global installs.

Use cases

  • Keeping git branch, PR status and dirty-file counts visible while coding with Claude Code.
  • Tracking token usage, session cost and weekly usage limits during long agent sessions.
  • Sharing a consistent status line configuration across machines via exported JSON.

Things to know

  • Built for the Claude Code CLI, so it only works as a status line inside that tool.
  • Some widgets, such as Git PR and CI status, depend on the GitHub CLI (gh) and can be slow without its cached data.
  • Usage and Claude Status widgets make network requests to external services.

Topics

#claude-code#cli#terminal#statusline#git#powerline#developer-tools#ai-tools#statusbar#themeing

FAQ

What is ccstatusline?
A customizable status line for Claude Code CLI that shows model, git branch, token usage, usage limits and more, with Powerline support and themes. ccstatusline is a status line formatter for Claude Code, the terminal coding agent from Anthropic. It renders a configurable bar at the bottom of the Claude Code interface, showing items such as the model name, git branch and status, token counts and speed, session cost, session duration, context usage, and Claude usage limits. Each element is a widget that can be added, reordered, colored, or hidden through an interactive terminal UI built with React and Ink.
Is ccstatusline free to use? What license does it have?
ccstatusline is open source under the MIT license. Check the license terms before using it in commercial products.
Is ccstatusline still maintained?
Actively maintained. The last commit to ccstatusline was on Oct 19, 2026.
What can I use ccstatusline for?
Keeping git branch, PR status and dirty-file counts visible while coding with Claude Code. Tracking token usage, session cost and weekly usage limits during long agent sessions. Sharing a consistent status line configuration across machines via exported JSON.
Where can I get ccstatusline?
The source code and installation instructions are on GitHub: https://github.com/sirmalloc/ccstatusline

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects