ccstatusline
A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets
Install
npx -y ccstatusline@latestOpens the setup UI. bunx -y ccstatusline@latest works too.
This is third-party code. Review the repository files before installing.
What it does
ccstatusline renders a status line at the bottom of Claude Code from widgets you pick in an interactive terminal UI. Widgets include model, git branch and conflicts, context fill, tokens, weekly and five-hour limits, a prompt cache timer, PR CI status and Claude service health. You can set up several lines, order, colors, separators and Powerline mode. The installer writes the command into Claude Code settings, and config can be exported and imported.
Who it is for. For Claude Code users who want to see context, limits and repository state without leaving the session.
Good fit when
- You want to track context fill and subscription limits
- You want branch and CI status inside Claude Code
- The default status line is too sparse
Not a fit when
- You do not use Claude Code
- Minimal repaint latency matters on a slow machine
Example request
Set up the Claude Code status line with model, git branch and context percentageLimitations
Works only with Claude Code. The command runs on every repaint, and npx with @latest adds latency, so the README suggests a pinned global install. Usage widgets call the Anthropic API, which may be unreachable from Russia without a VPN. Powerline glyphs need a suitable font.
How to disable. Uninstall the status line from the ccstatusline UI or remove the statusLine block from Claude Code settings.json.
Security check
- Only reads session and git data and changes only the status line setting
README in short
The README opens with per-version changes and the widget list. Running via npx or bunx without install opens a terminal setup UI that offers a pinned global install. It shows the statusLine block format for Claude Code settings and latency measurements for different launch methods. Separate docs cover Windows and usage. MIT licensed.
FAQ
Where are settings stored?
In ~/.config/ccstatusline/settings.json.
What if Claude Code config is in a custom folder?
Set the CLAUDE_CONFIG_DIR environment variable to that path.
Related
A CLI for every Google Workspace API with JSON output and agent skills: Drive, Gmail, Calendar, Sheets and more
Local search over Markdown notes, docs and meeting transcripts: keywords, semantic search and reranking, with an MCP server
A task manager for AI-driven development: breaks a PRD into dependent tasks and guides the agent through them via MCP or CLI
Anthropic's official plugins for knowledge work roles: sales, support, product, marketing, legal, finance, data and enterprise search