CC Statusline

Customizable status line formatter for Claude Code CLI with real-time metrics and visual enhancements

Overview

CC Statusline transforms your Claude Code CLI experience with highly customizable status lines that display real-time metrics and session information. Built with React and Ink, it provides an interactive Terminal UI for configuration and supports Powerline-style rendering with advanced customization options.

Monitor your Claude Code sessions with beautiful, informative status bars that show model information, token usage, git status, session timing, and custom widgets—all while maintaining terminal performance and visual appeal.

CC Statusline terminal interface showing customizable status bar with Powerline styling, real-time metrics, and interactive configuration options

Features

Real-Time Metrics Display - Show model name, git branch, token usage, session cost, and timing information
Powerline-Style Rendering - Beautiful arrow separators and customizable color themes
Multi-Line Configuration - Support for up to 3 independent status lines with different layouts
Interactive Terminal UI - User-friendly configuration interface with live preview
Custom Widgets & Commands - Add personalized text, execute custom commands, and display results
Block Timer Tracking - Monitor Claude's 5-hour conversation blocks with visual indicators
Smart Truncation - Automatic text truncation to prevent line wrapping and maintain clean display
Cross-Platform Support - Works with both Node.js and Bun runtime environments

Installation

Quick Start (Recommended)

npx ccstatusline@latest

Alternative Package Managers

# Using Bun (fastest)
bunx ccstatusline@latest

# Global Installation
npm install -g ccstatusline
ccstatusline

Usage

Interactive Configuration

# Launch configuration UI
npx ccstatusline@latest

# Follow the interactive prompts to customize your status line

Available Widgets

Core Metrics

Model Name - Current Claude model being used
Git Branch - Active git branch
Session Clock - Current session duration
Session Cost - Estimated session cost
Block Timer - Time remaining in 5-hour block

System Information

Current Directory - Working directory path
Token Usage - Input/output token counts
Custom Text - Static text display
Custom Command - Execute and display command output

Configuration Management

Status line is automatically applied to Claude Code CLI
Configuration persists across sessions
Customize colors, layout, and widget positioning through TUI

For advanced configuration options and widget customization, see the official documentation.

Integration with Claude Code

CC Statusline seamlessly integrates with your existing Claude Code setup, requiring no additional configuration beyond initial setup.

Enhanced Workflow

Real-time visibility into session metrics and costs
Visual confirmation of active model and git context
Block timer awareness for managing long development sessions
Professional terminal appearance that matches modern development environments

Terminal Enhancement

CC Statusline addresses a common developer need for visual session feedback in CLI environments. The Powerline-style formatting provides professional-grade terminal aesthetics while maintaining practical utility for monitoring Claude Code usage patterns.

CC Statusline is developed by Matthew Breedlove as a community project. For technical support and updates, please refer to the official GitHub repository.