Claude Code's terminal got a dashboard obsession

What it does

ccstatusline is a status-line formatter for the Claude Code CLI. It reads the editor’s live JSON status stream and renders a customizable bar of widgets—model name, token usage, git branch, PR links, session timers, even your current vim mode—directly in the terminal. It installs as a global npm package and configures through a TUI.

The interesting bit

The depth of widget specificity is almost comical: separate weekly usage trackers for Sonnet vs. Opus, a compaction counter for context window shrinkage, token speedometers with configurable rolling windows, and Git helpers that pass --no-optional-locks to avoid index.lock races. Someone really sat in Claude Code long enough to notice these papercuts.

Key highlights

• 40+ widgets spanning model info, token/account usage, git internals (SHA, worktrees, ahead/behind, PR/MR links for GitHub and GitLab), and Claude-specific state like thinking effort and voice mode
• Powerline-style themes with color continuity across multiple status lines, plus a global minimalist mode that strips all labels
• Persistent git cache under ~/.cache/ccstatusline/git-cache with mtime-based invalidation to cut subprocess spam
• Version-pinned global installs with npm provenance attestations; auto-updating installs are being phased out
• CCSTATUSLINE_WIDTH override for nested PTYs or wrapper processes where terminal width detection fails

Caveats

• Widgets depend on Claude Code’s internal statusline JSON format, so breakage is possible on CLI updates (the project tracks live JSON changes and /effort command behavior, but it’s an arms race)
• Some features like statusLine.refreshInterval config require Claude Code >=2.1.97
• Windows support exists but has needed specific fixes (empty c:\dev\null files, hidden helper processes)

Verdict

Worth it if you spend hours daily in Claude Code and want ambient awareness of token burn rate, context pressure, and git state without leaving the terminal. Skip it if you treat the CLI as a quick in-and-out tool—this is for the terminal-dwellers.