Ccvitals

ccvitals

The vital signs of your Claude Code session — usage quota, context window, cost, git status and more, right in your terminal. Pure bash, zero Node, never blocks your prompt.

Why ccvitals

Install

Install ccvitals as a Claude Code plugin — no cloning or manual config required:

/ccvitals:setup asks which modules you want, writes the config, and wires up settings.json automatically. Then restart Claude Code.

To reconfigure modules or switch to a two-line layout later:

Homebrew

After brew upgrade ccvitals, run ccvitals --force once to relink. Remove with ccvitals uninstall.

Manual install (alternative)

If you prefer a git-clone workflow (symlinked install, instant git pull updates):

The installer shows an interactive menu where you pick which modules to enable:

Then restart Claude Code.

Install options

The interactive installer also asks, after you pick your modules, which of
them should drop to a second line (enter their numbers, or press Enter for a
single line).

Update

Because the script is symlinked, git pull updates the statusline instantly —
no reinstall needed. Restart Claude Code to see the new version.

Change modules later

Run /ccvitals:configure (plugin install) or re-run the installer with --force. You can also edit ~/.claude/.statusline-config.json directly:

Remove any module from the array to hide it.

Two-line layout

Add an optional modules_line2 array to render those modules on a second row. Modules stay in modules for line 1; anything in modules_line2 drops to line 2. Omit modules_line2 entirely for a single line.

Renders as:

Module order

Add an optional module_order array to control the left-to-right display order of modules. Any enabled module not listed is appended after the listed ones in the default order — so you can pin…