sirmalloc/ccstatusline

★ 9,180TypeScriptAudience · developerComplexity · 2/5LicenseSetup · easy

Mindmap

mindmap
  root((ccstatusline))
    What it does
      Terminal status bar
      Claude Code add-on
      Live session info
    Widgets
      Token usage
      Context fill
      Git branch
      Model name
    Customization
      Widget order
      Powerline styling
      Themes
    Audience
      Claude Code users
      Terminal developers

mindmap root((ccstatusline)) What it does Terminal status bar Claude Code add-on Live session info Widgets Token usage Context fill Git branch Model name Customization Widget order Powerline styling Themes Audience Claude Code users Terminal developers

Click or tap to explore — scroll the page freely

Things people build with this

USE CASE 1

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.

USE CASE 2

Display your current git branch, staged file count, and upstream status alongside your AI session info in one status bar.

USE CASE 3

Track weekly model usage across different Claude subscription tiers directly in your terminal session.

USE CASE 4

Customize which information widgets appear and in what order using a built-in text-based configuration menu.

Tech stack

TypeScriptNode.jsnpm

Getting it running

Difficulty · easy Time to first run · 5min

Requires Claude Code to already be installed, installed via npm.

Use freely for any purpose including commercial, as long as you keep the copyright notice.

In plain English

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.

Copy-paste prompts

Prompt 1

Help me write a custom ccstatusline widget in TypeScript that shows the current time in ISO format next to the existing token count.

Prompt 2

Show me how to install ccstatusline and configure it to display only the model name, context fill percentage, and git branch, nothing else.

Prompt 3

I want ccstatusline to use Powerline arrow separators with a dark color theme. Walk me through the theme configuration options available.

Prompt 4

Which npm command installs ccstatusline and what do I need to add to my Claude Code setup to make the status bar appear?

Open on GitHub → Explain another repo

← sirmalloc on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.