ccstatusline
🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.
Adds a customizable status bar to your terminal when using Claude Code, showing live data like the active AI model, token usage, context fill percentage, and git branch.
ccstatusline is a customizable status bar display for the Claude Code command-line tool. Claude Code is an AI coding assistant that runs in a terminal, and ccstatusline adds an information bar at the bottom of the terminal session showing live data about what Claude Code is doing. Without this tool, the terminal shows minimal feedback; with it, you can see at a glance which AI model is active, how many tokens have been used in the session, how much of the available context window is filled, git branch information, and other metrics.
The display is built around widgets: small pieces of information you choose and arrange. Each widget shows one thing, such as the current git branch, the number of staged files, how fast tokens are being generated, or a timer for the current billing block. You configure which widgets appear and in what order through a text-based menu that runs in the terminal itself.
The tool supports Powerline styling, which is a visual style where the status bar uses arrow-shaped separators between sections to create a layered appearance. Various built-in themes control colors and separator styles, and there is a minimalist mode that strips labels and shows only raw values for a cleaner look. Nerd Font icons are optional for users whose terminal fonts support them.
In recent versions the project added widgets for tracking weekly model usage across different Claude tiers, GitLab merge request support alongside GitHub pull requests, voice input status, context compaction counters, and more git detail widgets covering staged files, conflicts, and upstream relationships.
ccstatusline is installed via npm and is licensed under the MIT license. It targets developers already using Claude Code who want more visibility into token consumption and session state while working.
Where it fits
- See at a glance how many tokens you have used and how full the context window is while working with Claude Code in a terminal.
- Display your current git branch, staged file count, and upstream status alongside your AI session info in one status bar.
- Track weekly model usage across different Claude subscription tiers directly in your terminal session.
- Customize which information widgets appear and in what order using a built-in text-based configuration menu.