Turn Claude Code’s Status Bar into a Customizable Dashboard with ccstatusline

Why Replace the Default Status Bar?

If you code with Claude Code, you have probably seen the plain, single‑line status bar at the bottom of the terminal. The default bar only shows "Claude Code 3.5 Sonnet" in white text.

ccstatusline transforms that bar into a highly customizable "dashboard". The project has earned over 10 k stars on GitHub, making it the most popular auxiliary tool in the Claude Code ecosystem.

What It Can Display

The plugin’s component system covers several dimensions:

Model and Usage : current model, context usage percentage, session usage, weekly usage, Extra quota balance, context window size.

Git Information : current branch, PR link, number of pending files, conflict count, comparison of forward and backward commits, SHA, upstream repository, and even detection of forked repositories.

Time and Timing : session timer, weekly reset countdown, precise millisecond‑level timing.

Session Information : automatic compression count, token input/output count, Claude account email, voice input status.

Each component can be individually styled with font color, background color, icons, and display format (plain text, icon, compact mode).

Key Features

Powerline Support : If you are familiar with Oh My Zsh’s Powerline theme, ccstatusline can render a segmented bar with arrow‑shaped separators, giving a seamless visual flow.

Gradient Colors : Both individual components and entire rows can use foreground gradients, with named presets, custom hex values, or TUI palette selection.

Automatic Usage Monitoring : Monthly‑paying users see current month’s over‑usage and remaining quota directly in the bar, avoiding surprise limits.

Responsive Layout : Overly long components automatically compress—full label → compact label → icon only → hidden—ensuring the bar never exceeds one line.

GitLab and Self‑Hosted Support : Not limited to GitHub; it can display PR/MR information from GitLab and self‑hosted Git services.

Multi‑Language Interface : The TUI configuration UI is localized, and the settings UI is Chinese‑friendly.

Simple Installation

# One‑line installation
npm install -g ccstatusline

After installing, enable the plugin in Claude Code or run the interactive installer with: npx ccstatusline Press Ctrl+P or type /settings to open the status‑bar configuration, where you can freely add, delete, and reorder components.

Who Should Use It

Heavy Claude Code Users – Spend hours in the terminal and want a more attractive workspace.

Users Who Need Usage Monitoring – See daily consumption at a glance to avoid end‑of‑month surprises.

Git Power Users – Get branch status, pending changes, and commit comparisons without running git status.

Terminal Tinkerers – Over 50 components can be mixed and matched for extensive DIY.

GitHub: https://github.com/sirmalloc/ccstatusline<br/>Stars: 10.6k+ | Language: TypeScript | Install: npm install -g ccstatusline