ccstatusline logo

ccstatusline

Free

🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.

Personal AssistantFreeFree tier
#TypeScript
Type
Open Source

About ccstatusline

ccstatusline is a highly customizable status line formatter for the Claude Code CLI. It displays model information, git branch details, token usage, and other metrics directly in the terminal. The tool supports Powerline-style separators, multiple themes, and a wide range of widgets including prompt cache timer, GitHub CI status, sandbox status, current directory with custom glyphs, and composable compaction metrics. It offers configurable padding, alignment, dim styling, and safer settings recovery. The project is open source and actively maintained with frequent updates.

Key Features

Powerline support with flex mode and selective alignment
Display model info, git branch, token usage, and other metrics
Prompt cache timer with live HOT state and TTL countdown
GitHub CI status widget summarizing checks for current branch PR
Sandbox status widget with glyph, text, and Nerd Font formats
One-sided default padding controls
Per-widget dim styling for entire widget or parenthesized text
Git widget width limits with ellipsis-safe truncation
Current directory glyphs with optional custom glyph
Configurable context fallback via environment variable

Pros & Cons

Pros
  • Highly customizable with numerous widgets and layout options
  • Supports Powerline-style separators and themes
  • Actively maintained with frequent updates and new features
  • Open source and free to use
  • Safe settings handling with invalid-config recovery
Cons
  • Limited to use with Claude Code CLI only
  • Requires Node.js and npm/bun to install
  • May have a learning curve for advanced customization
  • Documentation may be scattered across GitHub README and issues

Best For

Customizing the Claude Code CLI terminal status lineMonitoring token usage and context window during coding sessionsViewing git branch and status information inlineTracking CI check statuses for the current pull requestDisplaying sandbox security level in the terminal

Alternatives to ccstatusline