ccstatusline
A customizable status line for Claude Code showing model, git branch, token usage and more.
- Stars
- 13.5k
- Forks
- 604
- Licence
- MIT
- Language
- TypeScript
- Last update
- 4 days ago
- Type
- Dev tool
What it is
ccstatusline is a configurable status bar that appears in the Claude Code command-line tool. It shows information such as the model in use, the git branch, and token usage, and you can add, remove, reorder, and color these pieces through a terminal settings screen. It is aimed at people who use Claude Code daily and want more useful information on screen while they work.
- Show the current model and git branch in the status line while coding with Claude Code
- Track token usage and session cost during a Claude Code session
- Create several separate status lines with different widgets and colors
- Export a settings backup or import a shared configuration
Great for
- Developers who use Claude Code in the terminal every day
- People who want to see git branch or token usage while working
- Users comfortable editing settings through a terminal interface
- Those who like powerline-style status bars
Not ideal for
- People who do not use Claude Code, since it only works as a Claude Code status line
- Users who want a graphical app or a browser interface
- Anyone who needs a guaranteed fast startup, because the README notes that npx and bunx launches can be slow and suggests a pinned global install instead
How to get it
- 1
Install with a package manager
You'll need: Node.js or Bun, to run npx or bunx · Claude Code CLI
Run the configuration TUI with npm
npx -y ccstatusline@latestOr run with Bun
bunx -y ccstatusline@latest - 2
Run it
- Run npx -y ccstatusline@latest in your terminal to open the configuration TUI
- Choose the install option in the setup flow to write the status line command to Claude Code settings
- Open Claude Code and check that the status line appears
- Adjust widgets and colors in the TUI and preview the result
- 3
Get the most out of it
- Choose Pinned global install to avoid repeated package resolution on each repaint
- Set a refresh interval between 1 and 60 seconds if your Claude Code version supports it
- Set CLAUDE_CONFIG_DIR if your Claude configuration is in a non-standard location
- Use the HTTPS_PROXY and NO_PROXY settings if you work behind a proxy
Downloads
Strengths
- Setup is started with a single command and no permanent install is required at first
- Settings are configurable through an interactive terminal UI with a live preview
- Settings are saved to a local file that can be backed up and exported
Trade-offs
- Startup speed depends on the package runner and your platform, per the README
- Some features, such as Skills tracking, depend on specific command formats or Claude Code versions
- Requires familiarity with the terminal and Claude Code settings files
How it compares
| Project | Stars | Type | Level | Updated | Best for |
|---|---|---|---|---|---|
| ccstatusline (this) | 13.5k | Dev tool | beginner | 4 days ago | Developers who use Claude Code in the terminal every day |
| ai-website-cloner-template | 38.4k | App | intermediate | 17 days ago | Developers who want a working Next.js starting point for a site they already own |
| ECC | 295k | Dev tool | intermediate | 4 days ago | Developers who already use Claude Code and want a shared workflow for planning, testing and review |
| agentic-awesome-skills | 49k | Dev tool | intermediate | 4 days ago | Developers using Codex or Claude who want agent-chosen instructions for a project |
| codebase-memory-mcp | 48k | Dev tool | intermediate | 4 days ago | Developers who use an MCP-capable AI coding agent on a large codebase |
| opencodex | 18.2k | Dev tool | intermediate | 4 days ago | Developers who already use Codex or Claude Code and want to try other model providers |
Stats synced from GitHub. The assessment above was drafted with AI from the project's README on 2026-10-29 and may miss recent changes — check the README before relying on a command. MIT licence: free to use, modify and distribute, including commercially, as long as you keep the copyright notice.