CCometixLine Status Bar Plugin

Show model, Git branch, token usage, and other useful information in the Claude Code status bar.

Overview

CCometixLine, or ccline, is a Claude Code status-bar enhancement plugin written in Rust. After installation, the bottom status bar in Claude Code can show the current model name, Git branch state, token context usage percentage, and more. It also supports themes and custom configuration.

Supported Environment

• Windows 10 and later
• macOS 12 Monterey and later, both Intel and Apple Silicon
• Linux mainstream distributions

Prerequisite

Before using ccline, complete Claude Code deployment and make sure Claude Code works normally. ccline enhances Claude Code and cannot run as a standalone AI coding tool.

Links

Resource	URL
GitHub repository	https://github.com/Haleclipse/CCometixLine
npm package	@cometix/ccline
Downloads	Releases

Features

• Shows the current AI model name in real time, with simplified names such as Sonnet 4.6 for claude-sonnet-4-6
• Git branch name and state indicators, such as ● for changes, ⚠ for conflicts, and ↑↓ for remote sync state
• Token context-window usage percentage
• API cost tracking in USD
• Built-in themes: cometix, minimal, gruvbox, nord, and powerline-dark
• Interactive TUI configuration with live preview
• Powerline-style arrow separators

Install ccline

There are two installation methods: global npm install, which is recommended, and manual binary download.

Method 1: Global npm Install (Recommended)

Prerequisite

Node.js is required. If it is not installed, see Install Node.js.

npm install -g @cometix/ccline

If your network is slow, use a mirror registry:

npm install -g @cometix/ccline --registry https://registry.npmmirror.com

Other package managers are also supported:

# yarn
yarn global add @cometix/ccline

# pnpm
pnpm add -g @cometix/ccline

Method 2: Manual Binary Download

If you do not want to use npm, download a prebuilt binary.

Windows

New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\ccline"
Invoke-WebRequest -Uri "https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-windows-x64.zip" -OutFile "ccline-windows-x64.zip"
Expand-Archive -Path "ccline-windows-x64.zip" -DestinationPath "."
Move-Item "ccline.exe" "$env:USERPROFILE\.claude\ccline\"

macOS (Apple Silicon)

mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-macos-arm64.tar.gz
tar -xzf ccline-macos-arm64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/ccline

macOS (Intel)

mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-macos-x64.tar.gz
tar -xzf ccline-macos-x64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/ccline

Linux

mkdir -p ~/.claude/ccline
wget https://github.com/Haleclipse/CCometixLine/releases/latest/download/ccline-linux-x64.tar.gz
tar -xzf ccline-linux-x64.tar.gz
cp ccline ~/.claude/ccline/
chmod +x ~/.claude/ccline/ccline

Configure Claude Code to Use ccline

npm Install Users

After global npm installation, ccline automatically configures the Claude Code status bar. Reopen Claude Code to see the result.

Manual Install Users

If you manually downloaded the binary, edit Claude Code's settings.json and add the status-line configuration.

Where Is settings.json?

• macOS / Linux: ~/.claude/settings.json
• Windows: %USERPROFILE%\.claude\settings.json

Add this to settings.json:

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

Verify

Reopen Claude Code. The bottom status bar should show model name, Git branch, and other information. If not:

1. Fully close and reopen Claude Code
2. Run ccline in a terminal to confirm the command works
3. If manually installed, confirm the binary is executable with chmod +x

Themes and Customization

Switch Built-In Themes

ccline includes 5 themes:

ccline --theme cometix         # Default theme
ccline --theme minimal         # Minimal style
ccline --theme gruvbox         # Gruvbox colors
ccline --theme nord            # Nord colors
ccline --theme powerline-dark  # Dark Powerline style

Interactive Configuration

For detailed customization, open the TUI:

ccline --config

In the TUI you can:

• Choose and preview themes
• Toggle status-bar segments such as model, Git, and token usage
• Customize colors, icons, and separators
• Preview changes in real time

Config File Location

All settings are saved in ~/.claude/ccline/config.toml. You can also edit this file directly.

Advanced Features

Custom Model Display Names

If you use custom Xiaomai API models, edit ~/.claude/ccline/models.toml:

[[models]]
pattern = "claude-sonnet-4-6"
display_name = "Sonnet 4.6"
context_limit = 200000

[[context_modifiers]]
pattern = "[1m]"
display_suffix = " 1M"
context_limit = 1000000

Claude Code Enhancement Patch

ccline also provides an optional patch that can disable context-window warning popups and enable verbose mode:

ccline --patch /path/to/claude-code/cli.js

Note

The patch modifies Claude Code source files. After updating Claude Code, you may need to run it again. If you are unsure where cli.js is, locate it with:

which claude && ls -la $(which claude)

Update ccline

npm Install Users

npm update -g @cometix/ccline

Manual Install Users

Download the latest binary again and overwrite the old file in ~/.claude/ccline/.

FAQ

Status bar did not change after installation

1. Confirm the settings.json configuration was saved
2. Fully close and reopen Claude Code
3. Run ccline in a terminal to confirm it works
4. If manually installed, confirm the binary is executable with chmod +x

Status bar icons show as squares or garbled characters

ccline uses Nerd Fonts icons. Use a terminal font that supports Nerd Fonts:

• FiraCode Nerd Font
• JetBrainsMono Nerd Font

Git information is not shown

Make sure the current directory is a Git repository and Git 1.5+ is installed. Git 2.22+ is recommended.

More Questions

Read the FAQ or contact support.