Haleclipse/CCometixLine

# CCometixLine [English](README.md) | [中文](README.zh.md) 一款使用 Rust 编写的高性能 Claude Code 状态栏工具，具备 Git 集成、用量追踪、交互式 TUI 配置以及 Claude Code 增强功能。   ## 截图  状态栏显示：Model | Directory | Git Branch Status | Context Window Information ## 功能特性 ### 核心功能 - **Git 集成**：显示分支、状态和追踪信息 - **Model 显示**：简化的 Claude model 名称 - **用量追踪**：基于 transcript 分析 - **Directory 显示**：展示当前工作区 - **极简设计**：使用 Nerd Font 图标 ### 交互式 TUI 功能 - 无输入时显示 **交互式主菜单** - 带 **实时预览的 TUI 配置界面** - 支持 **多内置预设的主题系统** - 支持细粒度控制的 **Segment 自定义** - **配置管理**（初始化、检查、编辑） ### Claude Code 增强 - **Context 警告禁用器** - 移除烦人的 "Context low" 消息 - **Verbose 模式启用器** - 增强输出详情 - **健壮的 Patcher** - 可在 Claude Code 版本更新后存活 - **自动备份** - 安全修改，轻松恢复 ## 安装 ### 快速安装（推荐） 通过 npm 安装（支持所有平台）： ``` # 全局安装 npm install -g @cometix/ccline # 或使用 yarn yarn global add @cometix/ccline # 或使用 pnpm pnpm add -g @cometix/ccline ``` 使用 npm 镜像加速下载： ``` npm install -g @cometix/ccline --registry https://registry.npmmirror.com ``` 安装完成后： - ✅ 全局命令 `ccline` 可在任意位置使用 - ⚙️ 按照下方配置步骤与 Claude Code 集成 - 🎨 运行 `ccline -c` 打开配置面板选择主题 ### Claude Code 配置 将以下内容添加到你的 Claude Code `settings.json`： **Linux/macOS:** ``` { "statusLine": { "type": "command", "command": "~/.claude/ccline/ccline", "padding": 0 } } ``` **Windows:** ``` { "statusLine": { "type": "command", "command": "%USERPROFILE%\\.claude\\ccline\\ccline.exe", "padding": 0 } } ``` **Fallback（npm 安装）：** ``` { "statusLine": { "type": "command", "command": "ccline", "padding": 0 } } ``` *当 npm 全局安装路径在 PATH 中时使用此项* ### 更新 ``` npm update -g @cometix/ccline ```

手动安装（点击展开）

或者从 [Releases](https://github.com/Haleclipse/CCometixLine/releases) 下载： #### Linux #### 方式 1：动态二进制（推荐） ``` 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 ``` *需要：Ubuntu 22.04+, CentOS 9+, Debian 11+, RHEL 9+ (glibc 2.35+)* #### 方式 2：静态二进制（通用兼容） ``` 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 ``` *适用于任何 Linux 发行版（静态编译，无依赖）* #### 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 ``` # 创建目录并下载 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\" ```

### 从源码构建 ``` 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" ``` ## 用法 ### 配置管理 ``` # 初始化配置文件 ccline --init # 检查配置有效性 ccline --check # 打印当前配置 ccline --print # 进入 TUI 配置模式 ccline --config ``` ### 主题覆盖 ``` # 临时使用特定主题（覆盖配置文件） ccline --theme cometix ccline --theme minimal ccline --theme gruvbox ccline --theme nord ccline --theme powerline-dark # 或使用来自 ~/.claude/ccline/themes/ 的自定义主题文件 ccline --theme my-custom-theme ``` ### Claude Code 增强 ``` # 禁用上下文警告并启用详细模式 ccline --patch /path/to/claude-code/cli.js # 常见安装示例 ccline --patch ~/.local/share/fnm/node-versions/v24.4.1/installation/lib/node_modules/@anthropic-ai/claude-code/cli.js ``` ## 默认 Segment 显示：`Directory | Git Branch Status | Model | Context Window` ### Git 状态指示器 - 带有 Nerd Font 图标的分支名 - 状态：`✓` 干净, `●` 有改动, `⚠` 有冲突 - 远程追踪：`↑n` 领先, `↓n` 落后 ### Model 显示 显示简化的 Claude model 名称： - `claude-3-5-sonnet` → `Sonnet 3.5` - `claude-4-sonnet` → `Sonnet 4` ### Context Window 显示 基于 transcript 分析的 token 使用百分比，并追踪 context 限制。 ## 配置 CCometixLine 支持通过 TOML 文件和交互式 TUI 进行完整配置： - **配置文件**：`~/.claude/ccline/config.toml` - **交互式 TUI**：`ccline --config` 带预览的实时编辑 - **主题文件**：`~/.claude/ccline/themes/*.toml` 用于自定义主题 - **自动初始化**：`ccline --init` 创建默认配置 ### 可用 Segment 所有 Segment 均可配置： - 启用/禁用开关 - 自定义分隔符和图标 - 颜色自定义 - 格式选项 支持的 Segment：Directory, Git, Model, Usage, Time, Cost, OutputStyle ## 环境要求 - **Git**：版本 1.5+（推荐 Git 2.22+ 以获得更好的分支检测） - **终端**：必须支持 Nerd Fonts 才能正确显示图标 - 安装 [Nerd Font](https://www.nerdfonts.com/)（如 FiraCode Nerd Font, JetBrains Mono Nerd Font） - 配置你的终端使用 Nerd Font - **Claude Code**：用于状态栏集成 ## 开发 ``` # 构建开发版本 cargo build # 运行测试 cargo test # 构建优化 release cargo build --release ``` ## 路线图 - [x] TOML 配置文件支持 - [x] TUI 配置界面 - [x] 自定义主题 - [x] 交互式主菜单 - [x] Claude Code 增强工具 ## 相关项目 - [tweakcc](https://github.com/Piebald-AI/tweakcc) - 用于自定义 Claude Code 主题、thinking 动词等的命令行工具。 ## 许可证 本项目基于 [MIT License](LICENSE) 授权。 ## Star 历史 [](https://star-history.com/#Haleclipse/CCometixLine&Date)

标签：AI 编程, Claude Code, CLI, Git 集成, LLM 工具, Nerd Font, npm 包, Python安全, Rust, Statusline, TUI, WiFi技术, 上下文管理, 主题系统, 交互式配置, 代码增强, 使用量追踪, 可视化界面, 命令行界面, 大模型辅助, 威胁情报, 开发者工具, 性能优化, 检测绕过, 状态栏工具, 生产力工具, 终端用户界面, 终端美化, 网络流量审计, 通知系统