ccstatusline

_        _             _ _
  _ _ _| |_  _| |_ _   _ _| (_)_    _
 / / / | / _ | | | | / | | | '_ \ / _ \
| (_| (\ \ || (_| | |_| |_| \ \ | | | | |  /
 \_\_|_/\\,_|\|\,_|_/_|_|_| |_|\_|

ccstatusline

🎨 A highly customizable status line formatter for Claude Code CLI
*Display model info, git branch, token usage, and other metrics in your terminal*

📚 Table of Contents

- Recent Updates
- Features
- Localizations
- Quick Start
- Windows Support
- Usage
- Development
- Contributing
- License
- Related Projects

🚀 Quick Start

No installation needed! Use directly with npx or bunx:

Startup time can vary with the package runner (npx or bunx), its cache, and your platform. If repeated status line launches are slow, consider the Pinned global install option described below to run ccstatusline directly.

Both commands launch the same TUI. During the initial setup flow, choose Pinned global install if you want Claude Code to stay on the ccstatusline version you are running instead of following @latest; the TUI will install that version globally with npm or Bun and write the pinned ccstatusline command to Claude Code settings. After a pinned install, you can run ccstatusline directly to launch the TUI in the future.

Configure ccstatusline

The interactive configuration tool provides a terminal UI where you can:
- Configure multiple separate status lines
- Add/remove/reorder status line widgets
- Customize colors for each widget
- Configure Claude Code status line refresh interval when supported
- Edit custom text widgets
- Export JSON backups and preview imported configs before replacing or merging settings
- Install/uninstall to Claude Code settings
- Preview your status line in real-time
💡 Tip: Your settings are automatically saved to…