A highly customizable status line formatter for Claude Code CLI with Powerline support, themes, and real-time metrics.
ccstatusline is a customizable status line formatter for the Claude Code CLI that displays real-time metrics and information in your terminal. It solves the problem of cluttered terminal interfaces by providing a clean, informative status bar that shows model details, git status, token usage, session duration, and other relevant metrics during Claude Code sessions.
Developers using Claude Code CLI who want enhanced terminal visibility and customization of their status line display. It's particularly useful for those who work with git repositories, track token usage, or want Powerline-style aesthetics in their terminal.
Developers choose ccstatusline for its deep integration with Claude Code, extensive widget library, and beautiful Powerline support. Unlike basic status displays, it offers an interactive TUI for configuration, cross-platform compatibility, and real-time metrics without requiring global installation.
🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.
Open-Awesome is built by the community, for the community. Submit a project, suggest an awesome list, or help improve the catalog on GitHub.
Seamlessly pulls real-time metrics like model details, token usage, and session costs directly from Claude Code sessions, with over 30 widgets including custom commands and links for extensive customization.
Features a built-in terminal UI using React/Ink that lets users add, reorder, and customize widgets with live previews, eliminating manual JSON editing for settings.
Offers beautiful Powerline-style rendering with arrow separators, auto-alignment, and custom font support, including automatic font installation with user consent for aesthetic terminals.
Works on Windows, macOS, and Linux with Bun or Node.js, with specific fixes like UTF-8 piped output on Windows and smart path handling for diverse environments.
Entirely dependent on Claude Code CLI's JSON output and ecosystem; if Anthropic discontinues or changes the tool, ccstatusline becomes obsolete without a fallback.
For optimal Powerline rendering, users must manually install Nerd Fonts or compatible fonts, a noted barrier in Windows troubleshooting that adds setup complexity.
The sheer number of widgets and options (e.g., rolling windows for speed widgets) can overwhelm users, and reliance on JSONL parsing with cached metrics in ~/.cache/ may introduce delays or inaccuracies.
READMe acknowledges issues like session cost tracking not updating properly with `/resume` due to Claude Code limitations, and some widgets require specific Claude Code versions for accuracy.