This project provides a highly customizable status line for the Claude Code CLI, enhancing user experience by displaying real-time metrics like model information, Git status, and token usage. It targets Claude Code users seeking to monitor their sessions and integrate useful information directly into their terminal interface.

How It Works

The tool leverages Node.js and the Ink framework to create an interactive terminal UI for configuration. It dynamically renders status information using a modular widget system, supporting Powerline-style separators and advanced color customization. The approach allows for flexible arrangement and styling of various data points, including custom commands and text.

Quick Start & Requirements

• Install/Run: npx ccstatusline@latest or bunx ccstatusline@latest
• Prerequisites: Bun (v1.0+) or Node.js (18+).
• Setup: No installation required for basic use; configuration is done via an interactive TUI.
• Docs: Awesome Claude Code

Highlighted Details

• Powerline support with customizable separators and themes.
• Real-time metrics: model name, Git branch/changes, token usage, session duration, block timer.
• Extensible with custom text and shell command widgets.
• Interactive TUI for easy configuration and preview.
• Smart terminal width detection and truncation.

Maintenance & Community

• Actively maintained with recent updates including a Block Timer widget and Powerline support.
• Discussions and issue reporting are available on GitHub.

Licensing & Compatibility

• MIT License.
• Compatible with commercial use and closed-source linking.

Limitations & Caveats

VSCode integrated terminal users may experience color rendering issues due to contrast ratio settings; adjustments or using a standalone terminal are recommended for accurate color display. Custom commands should be optimized for quick execution to prevent status line delays.