CCometixLine

English | 中文

A fast, composable status line for Claude Code, written in Rust, with a full-screen configurator.

Highlights

• Your session at a glance: model and effort, directory, git, context use, prompt cache countdown and hit ratio, the 5-hour and weekly limits with your pace against the clock, cost, PR and more: 30+ metrics in all.
• Any metric, any form: each item can be text, a progress bar, a gauge, a sparkline or a pace bar, with three text templates for when room runs short.
• Fits the terminal: lines wrap between items when the terminal is narrow; a right-hand group stays flush right.
• Looks: four skins (plain, bracket, pill, powerline), 13 palettes that follow your terminal's colors or bring their own, Nerd Font, Unicode or ASCII glyphs, and color depth from truecolor down to none.
• Eight presets to start from, and your own saved alongside them.
• A configurator that edits everything with a live preview of sample sessions, and points Claude Code at ccline for you.
• Accurate for third-party models: a model registry fixes names and context windows Claude Code can't know.
• Background tasks: the same binary draws the line under each running subagent.
• Light: a render costs a few milliseconds over process start; git runs in the background, never on the render path.

Install

npm install -g @cometix/ccline

yarn global add @cometix/ccline
pnpm add -g @cometix/ccline
npm install -g @cometix/ccline --registry https://registry.npmmirror.com

The package puts the binary at ~/.claude/ccline/ccline and the ccline command on your PATH. To update later: npm update -g @cometix/ccline.

Download the archive for your platform from Releases and put the binary at ~/.claude/ccline/ccline (ccline.exe on Windows).

Platform	Archive
Linux x64 (glibc 2.35+)	ccline-linux-x64.tar.gz
Linux x64, static	ccline-linux-x64-static.tar.gz
Linux arm64	ccline-linux-arm64.tar.gz
Linux arm64, static	ccline-linux-arm64-static.tar.gz
macOS Intel	ccline-macos-x64.tar.gz
macOS Apple Silicon	ccline-macos-arm64.tar.gz
Windows x64	ccline-windows-x64.zip

mkdir -p ~/.claude/ccline
tar -xzf ccline-macos-arm64.tar.gz
mv ccline ~/.claude/ccline/ && chmod +x ~/.claude/ccline/ccline

git clone https://github.com/Haleclipse/CCometixLine.git
cd CCometixLine
cargo build --release
mkdir -p ~/.claude/ccline
cp target/release/ccometixline ~/.claude/ccline/ccline

Set up Claude Code

Run ccline in a terminal. The first run walks you through checking your font, picking a preset and pointing Claude Code at ccline; the Claude Code page shows the change to settings.json before writing it, and keeps a backup.

Or edit ~/.claude/settings.json yourself:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/ccline/ccline",
    "padding": 0
  },
  "subagentStatusLine": {
    "type": "command",
    "command": "~/.claude/ccline/ccline"
  }
}

subagentStatusLine is optional: it draws ccline's line under each background task. ~ works on Windows too (Claude Code 2.1.47+); with a global npm install, "command": "ccline" also works.

Presets

Preset	Lines	Look	What it shows
cometix (default)	1	plain, terminal colors	Classic look: model, directory, git, context and cache
minimal	1	plain, no icons	Model, context, cache and cost
dashboard	3	pill, Catppuccin Mocha	Identity and git; context, its trend, 5-hour pace and cache; code activity
budget	2	plain, Tokyo Night	5-hour and weekly limits with pace and run-out, spend rates; context, compaction and cache
cache-aware	2	plain, Rosé Pine	The usual line; cache countdown bar, hit ratio, misses and their cause
focus	2	plain, Unicode	A wide context gauge, growth per turn, room before compaction, cache
zen	1	ASCII, no color	Works in any terminal
powerline	1	powerline, Tokyo Night	Powerline segments with a 5-hour gauge

Apply one in the configurator: all of it, only its layout, or only its look. Save your own setup as a preset with N on the Presets page; it is a file in ~/.claude/ccline/presets/.

The configurator

Run ccline (or ccline -c). Six pages, switched with 1–6; every change shows at once in the preview bar, drawn by the same code as the real status line.

Page	What it does
1 Home	Checks your setup (Claude Code version, its status line settings, config.toml, models.toml, updates) with a key to fix each problem, and shows your line with your last real session
2 Presets	The gallery, each card rendered live
3 Layout	Pick metrics from the library, arrange them on lines and sides, and tune the selected item: form, bar glyphs and cells, templates, icon, colors, thresholds
4 Style	Skin, palette, glyphs, color depth, fill, and color overrides on top of the palette
5 Models	The model registry: unrecognized ids from recent sessions, your rules with hit counts, and a tester
6 Claude Code	statusLine, subagentStatusLine and refreshInterval, update checks, the companion mod

The icon picker covers all 10,617 icons of Nerd Fonts 3.5.1, searchable by name, class (md-, fa-, cod- …), codepoint or a pasted glyph.

Keys everywhere: ^S save, ^Z / ^Y undo and redo, ^P command palette, [ ] sample session, - + preview width, { color depth, } glyphs, ? help, q quit.

This is the beginning of the README. Read the rest at the original. Read the full README ↗