This project provides a Chinese-localized version of ccstatusline, a highly customizable status bar formatter for the Claude Code CLI. It targets users who prefer a Chinese interface for managing real-time metrics like model information, Git status, and token usage within their development workflow, offering enhanced usability and accessibility.

How It Works

ccstatusline-zh is a direct fork of the upstream ccstatusline project, synchronized to version v2.2.16. Its core innovation lies in translating all user-visible interface elements—component names, descriptions, menu labels, and prompts—into Chinese. Internally, it maintains compatibility with the upstream's configuration files (settings.json) by preserving English identifiers for widgets and settings, ensuring a seamless transition for users familiar with the original tool while providing a fully localized experience.

Quick Start & Requirements

• Installation: Install globally via npm (npm install -g ccstatusline-zh) or Bun (bun install -g ccstatusline-zh).
• Prerequisites: Node.js (>= 14.0.0) or Bun (>= 1.0) for installation and execution.
• Configuration: Integrate with Claude Code by adding a statusLine configuration to ~/.claude/settings.json (or %USERPROFILE%\.claude\settings.json on Windows) pointing to ccstatusline-zh as the command.
• Setup: Launch the interactive Text-based User Interface (TUI) for configuration using ccstatusline-zh setup.
• Links: Upstream API Documentation: https://github.com/sirmalloc/ccstatusline

Highlighted Details

• Extensive Customization: Supports over 50 components for displaying model details, Git status (including branches, PRs, file changes), token usage, context, session information, costs, and more.
• Interactive TUI: A visual setup interface (ccstatusline-zh setup) allows easy addition, removal, arrangement, and configuration of components, themes, and styles.
• Powerline & Theming: Offers built-in Powerline themes, custom separators, and supports theme color continuity across lines.
• Localization: All user-facing text is translated into Chinese, enhancing usability for Chinese-speaking developers.
• Cross-Platform: Fully functional on macOS, Linux, and Windows.

Maintenance & Community

The project is a fork of sirmalloc/ccstatusline. Development activity and community interaction are primarily channeled through GitHub issues and stars for this repository.

Licensing & Compatibility

Licensed under the MIT License, permitting broad use, modification, and distribution, including for commercial purposes, with attribution. Configuration files are compatible with the upstream ccstatusline.

Limitations & Caveats

While feature-complete with its upstream at v2.2.16, the primary value proposition is localization; it does not introduce new core functionalities beyond those already present in the upstream version. Users requiring the absolute latest upstream features not yet merged into this fork would need to await synchronization.