CLI tool
sirmalloc/ccstatusline avatar
sirmalloc/ccstatusline

ccstatusline: a widget-based Claude Code status line where the launch command sets the cost

Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

13,602 stars609 forksTypeScriptMIT

At a glance

What is it?
sirmalloc/ccstatusline is an MIT-licensed TypeScript tool that configures and renders the Claude Code status line through a terminal UI. The widgets are the draw, but the decisions that matter are how Claude Code invokes it on every repaint, which settings it writes, and why the line can go blank in some folders.
Who is it for?
ccstatusline suits Claude Code users who want model, git, token and usage-limit information in the terminal and are willing to spend a few minutes in a TUI. Users who want zero per-repaint overhead should choose the Pinned global install rather than leave @latest in the command.
Can I use it commercially?
Yes. MIT is a permissive licence: you can use, modify and sell software built on it, as long as you keep its copyright and licence notices.
Is it still maintained?
Yes. The repository last received commits 6 days ago.
What is it written in?
Mainly TypeScript, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • sirmalloc/ccstatusline13,602 ★ · +1,510
Star history
Repository2026-07-292026-11-15
sirmalloc/ccstatusline12.1k13.6k

1,510 Stars in the last 109 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

One TUI, launched without installing anything

ccstatusline is a status line formatter for the Claude Code CLI. It shows model info, git branch, token usage and other metrics as widgets, and you arrange them in an interactive terminal UI rather than by hand-editing a script. Both package runners open the same TUI:

bash
# Run the configuration TUI with npm
npx -y ccstatusline@latest

# Or use bunx, Bun's alternative to npx
bunx -y ccstatusline@latest

From the TUI you can configure several separate status lines, add, remove and reorder widgets, set colors per widget, edit custom text widgets, preview the result live, and install or uninstall the line in Claude Code settings. You can also export JSON backups and preview an imported config before choosing to replace or merge. Your own settings are saved to ~/.config/ccstatusline/settings.json.

The status line command runs on every repaint

Installing from the TUI writes a statusLine object into Claude Code settings:

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

Claude Code runs that command once per repaint, so the cost of starting it is paid again and again. The project's own measurement, taken on Windows with a warm cache as the median of five runs of --version, shows why the specifier matters. Under Bun, bunx -y ccstatusline@latest took 633 ms while bunx -y [email protected] took 202 ms, because bunx re-resolves the latest dist-tag against the registry on every run. npx did not behave that way: the @latest and pinned forms measured 1082 ms and 1135 ms, so pinning bought nothing there. Startup time also varies with the runner, its cache and your platform.

Pinned global install trades automatic updates for speed

The way to avoid registry resolution on both runners is the Pinned global install option in the initial setup flow. The TUI installs the version you are currently running globally with npm or Bun and writes "command": "ccstatusline" to Claude Code settings. After that you can open the TUI by running ccstatusline directly. The cost is that Claude Code stays on that version instead of following @latest. Since the project ships often, with v2.2.31 and v2.2.32 tagged on the same day in October 2026 and v2.2.33 on 30 October, a pinned install will fall behind until you rerun the flow. The last push to main was on 2 November 2026.

refreshInterval depends on your Claude Code version

refreshInterval defaults to 10 seconds on fresh installs, but only when Claude Code supports it, which means version 2.1.97 or later. The TUI can set it anywhere from 1 to 60 seconds, or remove it if you leave the input empty. Reinstalling keeps an existing value even if the version check fails. On an older Claude Code the option is not offered, and widgets that change over time update only when Claude Code repaints for its own reasons. If Claude Code keeps its configuration somewhere non-standard, point ccstatusline at it before installing:

bash
export CLAUDE_CONFIG_DIR=/custom/path/to/.claude

A blank line in one folder is a workspace trust problem

The most confusing failure is a status line that works everywhere except one directory. Claude Code only runs the status line command in trusted workspaces, and since Claude Code 2.1.232 nested git repositories no longer inherit trust from their parent. A repository cloned inside another trusted repository can therefore show nothing at all, and nothing in ccstatusline can override that, because Claude Code never invokes the command. The fix is on the Claude Code side, by trusting that workspace; docs/USAGE.md has a section for this case.

Wrapper scripts break the Skills widget

Some users wrap the status line in their own shell script to add extra output. That works for most widgets, but the Skills widget will always show none. Skills relies on Claude Code hooks, and ccstatusline only adds those hooks when the status line command contains the string ccstatusline. A wrapper with a different name hides it. If you need a wrapper and the Skills widget, the wrapper's command line has to include ccstatusline.

Usage widgets make network requests, and the proxy rules are strict

Not every widget is local. Usage and Claude Status requests go over the network, and they honor only the uppercase HTTPS_PROXY variable, with exclusions read from both NO_PROXY and no_proxy. A lowercase https_proxy alone will not be picked up, so those widgets can fail behind a corporate proxy that other tools reach fine. Recent releases added Block Forecast and Block Limit Timer widgets that project 5-hour usage at reset and estimate time to the limit from your recent pace, and Spend Limit Usage and Spend Limit Amount widgets that show gateway-reported percentages and dollar amounts without an extra API request. Session Usage was renamed Block Usage with a 5h: label, so a saved layout may display differently after updating.

Built with Bun, shipped as a Node ESM bundle

Development uses Bun, but the published package targets Node. The build script runs bun build on src/ccstatusline.ts with --target=node, --format=esm and --target-version=14, writing to dist/, and only dist/ is published. The bin entry maps ccstatusline to ./dist/ccstatusline.js. Windows users have a separate guide in docs/WINDOWS.md covering PowerShell, fonts, WSL and Windows Terminal.

Editorial conclusion

ccstatusline suits Claude Code users who want model, git, token and usage-limit information in the terminal and are willing to spend a few minutes in a TUI. Users who want zero per-repaint overhead should choose the Pinned global install rather than leave @latest in the command. Before relying on it, check your Claude Code version against the refreshInterval and workspace trust notes, and set HTTPS_PROXY in uppercase if you sit behind a proxy.

Frequently asked questions

What is ccstatusline?

ccstatusline is a customizable status line formatter for the Claude Code CLI. It displays model info, git branch, token usage and other metrics as widgets you configure in a terminal UI.

How do I install ccstatusline?

No installation is needed to start: run npx -y ccstatusline@latest or bunx -y ccstatusline@latest to open the TUI, then install it to Claude Code settings from there. Choose Pinned global install if you want a fixed version run directly as ccstatusline.

How to set up ccstatusline in Claude Code?

The TUI writes a statusLine object with type command and a command such as npx -y ccstatusline@latest to Claude Code settings. Set CLAUDE_CONFIG_DIR first if your Claude Code configuration is in a non-standard location.

Is ccstatusline safe to use?

ccstatusline is MIT licensed, writes its own settings to ~/.config/ccstatusline/settings.json, and writes a statusLine command to Claude Code settings. Usage and Claude Status widgets make network requests that honor HTTPS_PROXY.

Official sources

  1. Official README
  2. Project repository
  3. Release notes
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/sirmalloc-ccstatusline.svg)](https://hysenlabs.com/projects/sirmalloc-ccstatusline)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/sirmalloc-ccstatusline.svg)](https://hysenlabs.com/projects/sirmalloc-ccstatusline)

Was this useful?