ccstatusline
🚀 Beautiful highly customizable statusline for Claude Code CLI with powerline support, themes, and more.
ccstatusline is a highly customizable status line formatter for Claude Code CLI that displays real-time session metrics directly in your terminal. It shows model information, token usage, Git status, session costs, context window usage, weekly API limits, and dozens of other metrics through a flexible widget system. The plugin supports Powerline-style rendering with themes, gradients, and interactive configuration through a terminal UI. Developers can mix and match widgets, apply custom colors, and create multi-line status displays tailored to their workflow.
Key Features
Use Cases
- 01Monitor token consumption and session costs in real-time during long Claude Code sessions
- 02Track Git repository state (branch, PRs, staged files, conflicts) without leaving the terminal
- 03Visualize context window usage and cache efficiency to optimize prompt design
- 04Display weekly API usage across Sonnet, Opus, and Fable models to stay within limits
- 05Create themed Powerline status bars that match your terminal aesthetic
- 06Track block timer progress and compaction events to understand session boundaries
Related Plugins
View moreandrej-karpathy-skills
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
claude-mem
Persistent Context Across Sessions for Every Agent – Captures everything your agent does during sessions, compresses it with AI, and injects relevant context back into future sessions. Works with Claude Code, OpenClaw, Codex, Gemini, Hermes, Copilot, OpenCode + More
Understand-Anything
Graphs that teach > graphs that impress. Turn any code into an interactive knowledge graph you can explore, search, and ask questions about. Works with Claude Code, Codex, Cursor, Copilot, Gemini CLI, and more.
rtk
CLI proxy that reduces LLM token consumption by 60-90% on common dev commands. Single Rust binary, zero dependencies
ccstatusline — FAQ
What is ccstatusline?+
ccstatusline is a Claude Code plugin that replaces the default status line with a customizable display showing real-time metrics like token usage, Git status, session costs, context window usage, and API limits through a flexible widget system.
How do I install ccstatusline?+
Run 'npx -y ccstatusline@latest' or 'bunx -y ccstatusline@latest' to launch the configuration TUI, then choose 'Pinned global install' to install it globally and write the command to your Claude Code settings. No separate installation is needed for quick testing.
Which clients does ccstatusline work with?+
ccstatusline is designed specifically for Claude Code CLI (version 1.0.85 or later recommended for full feature support). It integrates via the statusLine configuration in Claude Code's settings.json.
Do I need API keys or special prerequisites?+
No API keys are required. Usage widgets automatically read your Claude API token from Claude Code's configuration. Optional features like Git PR/MR links require 'gh' (GitHub CLI) or 'glab' (GitLab CLI) installed.
Is ccstatusline free?+
Yes, ccstatusline is open source under the MIT license and completely free to use. It's available on npm and can be run without installation via npx or bunx.
How do I customize the status line widgets and colors?+
Run 'ccstatusline' (after installation) or 'npx -y ccstatusline@latest' to open the interactive TUI, where you can add/remove/reorder widgets, configure colors with basic/256-color/truecolor/gradient support, and preview changes in real-time before saving.
How do I install ccstatusline?+
Open the source repository on GitHub and follow its README. ccstatusline is a plugin — MCP Agents Market links you directly to the official repo.
Is ccstatusline free?+
ccstatusline is an open-source project hosted on GitHub. Check the repository for its license and any usage requirements.