Ccsidekick

A Claude Code status line with a character that reacts to your session. Full cost, git, and usage at a glance, at zero token spend.

What you get

- A character that reacts. It notices what Claude is doing (tests passing, builds breaking,
  commits landing, a struggle and then a recovery) and comments in character, warming to you across
  sessions through familiarity tiers.
- A real status line. 33 toggleable widgets: directory, model, git (branch, ahead/behind,
  staged/unstaged/untracked, uncommitted changes, stash, worktree, conflicts), token context, cost,
  usage limits, PR state, burn rate, and more. Threshold-colored.
- 75+ built-in themes. Dark, high-contrast, and retro palettes (Dracula, Nord,
  Catppuccin, Tokyo Night, Gruvbox, Rosé Pine, Synthwave '84, and dozens more), including one tuned
  to each character pack.
- Cost at a glance. Chat, per-project, and all-time spend, read straight from your Claude Code
  transcripts. No token spend and nothing extra to install.
- Character spinner verbs. The active character rewrites Claude Code's spinner verbs, so even
  the loading text stays in persona.

Install

Running ccsidekick in a terminal opens the setup UI. On a first run it walks you through a short
guided wizard (character → theme → comments); later runs open the full dashboard to change
config or view stats, and either view can switch to the other with Ctrl+W / Ctrl+D. It wires
everything into Claude Code's settings.json (backing the file up first). Run
npx ccsidekick --help for every command, including a clean uninstall.

Prefer no TTY? npx ccsidekick setup --character spiderman --theme houston --mode fixed configures
and wires everything from flags. See Non-interactive setup.

From inside Claude Code

The repo is its own plugin marketplace, so you can…