CCometixLine

A high-performance Claude Code statusline tool written in Rust with Git integration, usage tracking, interactive TUI configuration, and Claude Code enhancement utilities.

Screenshots

The statusline shows: Model | Directory | Git Branch Status | Context Window Information

Supported AI Agents

Works with multiple AI coding agents, not just Claude Code:

Agent	Integration	Notes
Claude Code	Native `statusLine` command	Full feature set (incl. transcript-based segments)
pi	Native `statusLine` command	Honors pi's `context_window` payload (correct limits + token breakdown)
Kimi Code CLI (K3 / K2.7)	`ccline --kimi` reads kimi-code sessions	No statusline hook upstream yet; also works via Claude Code + Moonshot endpoint
Codex CLI	`ccline --codex` reads rollout sessions	Codex has no external statusline hook; use in tmux / sidecar pane

Quick setup per agent

Claude Code — add to ~/.claude/settings.json:

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

pi — add to ~/.pi/agent/settings.json (requires the pi-statusline package):

{
  "packages": ["npm:pi-statusline"],
  "statusLine": { "type": "command", "command": "~/.claude/ccline/ccline" }
}

ccline automatically uses pi's context_window payload, so the context limit and token breakdown are exact for whatever model pi is running (Kimi K3 1M, GLM, etc.).

Kimi (K3 / K2.7) — the Kimi Code CLI has no statusline hook yet, so ccline pulls status from its session files, same as codex mode:

ccline --kimi                           # auto-detect: newest session, prefers current dir
ccline --kimi-session ~/.kimi-code/sessions/<wd>/<session>   # pin a session

# tmux popup example
bind C-k display-popup -w 90% -h 10 -E "while :; do clear; ~/.claude/ccline/ccline --kimi; sleep 5; done"

Model display name and context limit are read from kimi-code's own ~/.kimi-code/config.toml, so they stay correct when you switch models.

Alternatively run Kimi models through Claude Code via Moonshot's Anthropic-compatible endpoint; ccline then renders natively:

export ANTHROPIC_BASE_URL="https://api.moonshot.ai/anthropic"
export ANTHROPIC_AUTH_TOKEN="$MOONSHOT_API_KEY"
export ANTHROPIC_MODEL="kimi-k3"        # or kimi-k2.7-code
claude

Codex CLI — codex cannot run external statusline commands, so ccline pulls status from codex session files instead. Run it anywhere you like (tmux status bar, sidecar pane):

ccline --codex                          # auto-detect: newest session, prefers current dir
ccline --codex-session /path/to/rollout-....jsonl   # pin a specific session

# tmux status bar example
set -g status-interval 5
set -g status-right "#(cd #{pane_current_path} && ~/.claude/ccline/ccline --codex)"

# or a live sidecar pane
watch -n 5 '~/.claude/ccline/ccline --codex'

See docs/multi-agent.md for protocol details, payload dialects, and per-agent capability notes.

Features

Core Functionality

Git integration with branch, status, and tracking info
Model display with simplified Claude model names
Usage tracking based on transcript analysis
Directory display showing current workspace
Minimal design using Nerd Font icons

Interactive TUI Features

Interactive main menu when executed without input
TUI configuration interface with real-time preview
Theme system with multiple built-in presets
Segment customization with granular control
Configuration management (init, check, edit)

Claude Code Enhancement

Context warning disabler - Remove annoying "Context low" messages
Verbose mode enabler - Enhanced output detail
Robust patcher - Survives Claude Code version updates
Automatic backups - Safe modification with easy recovery

Installation

Quick Install (Recommended)

Install via npm (works on all platforms):

# Install globally
npm install -g @cometix/ccline

# Or using yarn
yarn global add @cometix/ccline

# Or using pnpm
pnpm add -g @cometix/ccline

Use npm mirror for faster download:

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

After installation:

✅ Global command ccline is available everywhere
⚙️ Follow the configuration steps below to integrate with Claude Code
🎨 Run ccline -c to open configuration panel for theme selection

Claude Code Configuration

Add to your Claude Code settings.json:

Cross-Platform (Recommended)

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

Note for Windows users: Starting from Claude Code v2.1.47+, Unix-style path parsing is supported on Windows. The ~ symbol is automatically expanded to your user home directory. Do not use %USERPROFILE% - it no longer works reliably in v2.1.47+.

Recommended: ~/.claude/ccline/ccline (works on all platforms)

Alternative: "ccline" (requires npm global installation)

Fallback (npm installation):

{
  "statusLine": {
    "type": "command",
    "command": "ccline",
    "padding": 0
  }
}

Use this if npm global installation is available in PATH

Update

npm update -g @cometix/ccline

Manual Installation (Click to expand)

Alternatively, download from Releases:

Linux

Option 1: Dynamic Binary (Recommended)

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

Requires: Ubuntu 22.04+, CentOS 9+, Debian 11+, RHEL 9+ (glibc 2.35+)

Option 2: Static Binary (Universal Compatibility)

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

Works on any Linux distribution (static, no dependencies)

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

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

Windows

# Create directory and download
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\"

Build from Source

git clone https://github.com/Haleclipse/CCometixLine.git
cd CCometixLine
cargo build --release

# Linux/macOS
mkdir -p ~/.claude/ccline
cp target/release/ccometixline ~/.claude/ccline/ccline
chmod +x ~/.claude/ccline/ccline

# Windows (PowerShell)
New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\ccline"
copy target\release\ccometixline.exe "$env:USERPROFILE\.claude\ccline\ccline.exe"

Usage

Theme Override

# Temporarily use specific theme (overrides config file)
ccline --theme cometix
ccline --theme minimal
ccline --theme gruvbox
ccline --theme nord
ccline --theme powerline-dark

# Or use custom theme files from ~/.claude/ccline/themes/
ccline --theme my-custom-theme

Claude Code Enhancement

# Disable context warnings and enable verbose mode
ccline --patch /path/to/claude-code/cli.js

# Example for common installation
ccline --patch ~/.local/share/fnm/node-versions/v24.4.1/installation/lib/node_modules/@anthropic-ai/claude-code/cli.js

Default Segments

Displays: Directory | Git Branch Status | Model | Context Window

Git Status Indicators

Branch name with Nerd Font icon
Status: ✓ Clean, ● Dirty, ⚠ Conflicts
Remote tracking: ↑n Ahead, ↓n Behind

Model Display

Shows simplified Claude model names:

claude-3-5-sonnet → Sonnet 3.5
claude-4-sonnet → Sonnet 4

Context Window Display

Token usage percentage based on transcript analysis with context limit tracking.

Configuration

CCometixLine supports full configuration via TOML files and interactive TUI:

Configuration file: ~/.claude/ccline/config.toml
Interactive TUI: ccline --config for real-time editing with preview
Theme files: ~/.claude/ccline/themes/*.toml for custom themes
Automatic initialization: ccline --init creates default configuration

Available Segments

All segments are configurable with:

Enable/disable toggle
Custom separators and icons
Color customization
Format options

Supported segments: Directory, Git, Model, Usage, Time, Cost, OutputStyle

Model Configuration (`models.toml`)

Location: ~/.claude/ccline/models.toml (auto-created on first run)

This file configures how model IDs are displayed and their context window limits. Claude models (Sonnet, Opus, Haiku) are automatically recognized with version extraction — you only need this file for overrides or third-party models.

# Model entries: simple substring matching on the model ID
# These take priority over built-in Claude model recognition
[[models]]
pattern = "glm-4.5"
display_name = "GLM-4.5"
context_limit = 128000

[[models]]
pattern = "kimi-k2"
display_name = "Kimi K2"
context_limit = 128000

# Context modifiers: matched independently and composable with model entries
# Overrides context_limit and appends display_suffix to the display name
# e.g., model "Opus 4" + modifier " 1M" = "Opus 4 1M"
[[context_modifiers]]
pattern = "[1m]"
display_suffix = " 1M"
context_limit = 1000000

Requirements

Git: Version 1.5+ (Git 2.22+ recommended for better branch detection)
Terminal: Must support Nerd Fonts for proper icon display
- Install a Nerd Font (e.g., FiraCode Nerd Font, JetBrains Mono Nerd Font)
- Configure your terminal to use the Nerd Font
Claude Code: For statusline integration

Development

# Build development version
cargo build

# Run tests
cargo test

# Build optimized release
cargo build --release

Roadmap

Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.

Related Projects

tweakcc - Command-line tool to customize your Claude Code themes, thinking verbs, and more.

License

This project is licensed under the MIT License.

Name		Name	Last commit message	Last commit date
Latest commit History 105 Commits
.github/workflows		.github/workflows
assets		assets
docs		docs
npm		npm
src		src
.gitignore		.gitignore
CHANGELOG.md		CHANGELOG.md
Cargo.lock		Cargo.lock
Cargo.toml		Cargo.toml
README.md		README.md
README.zh.md		README.zh.md
cliff.toml		cliff.toml
lefthook.yml		lefthook.yml

Folders and files

Latest commit

History

Repository files navigation

CCometixLine

Screenshots

Supported AI Agents

Quick setup per agent

Features

Core Functionality

Interactive TUI Features

Claude Code Enhancement

Installation

Quick Install (Recommended)

Claude Code Configuration

Update

Linux

Option 1: Dynamic Binary (Recommended)

Option 2: Static Binary (Universal Compatibility)

macOS (Intel)

macOS (Apple Silicon)

Windows

Build from Source

Usage

Theme Override

Claude Code Enhancement

Default Segments

Git Status Indicators

Model Display

Context Window Display

Configuration

Available Segments

Model Configuration (models.toml)

Requirements

Development

Roadmap

Contributing

Related Projects

License

Star History

About

Resources

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Model Configuration (`models.toml`)

Packages