A customizable status line formatter for Claude Code CLI. Reads JSON session data from stdin, renders an ANSI-colored status line, and outputs to stdout.

• Single static binary with no runtime dependencies
• 44 configurable widgets (model, tokens, context, git, cost, rate limits, and more)
• Multi-line status line with flex separator layout
• ANSI 16-color support via fatih/color
• Configurable via ~/.config/ccstatus/settings.json
• Automatic Claude Code integration via install/uninstall commands

brew install moond4rk/tap/ccstatus

go install github.com/moond4rk/ccstatus/cmd/ccstatus@latest

# Generate default settings
ccstatus init

# Register in Claude Code (re-run anytime to update; --refresh N / --hide-vim-indicator optional)
ccstatus install

That's it. Claude Code will now display the status line after each assistant message.

ccstatus [flags]
ccstatus [command]

ccstatus init [--force]

Generates a default settings.json at ~/.config/ccstatus/settings.json. Use --force to overwrite an existing file.

ccstatus install

Registers ccstatus in Claude Code's ~/.claude/settings.json (or $CLAUDE_CONFIG_DIR/settings.json) by adding:

{
  "statusLine": {
    "type": "command",
    "command": "ccstatus",
    "padding": 0
  }
}

Optional flags:

• --refresh N — also re-run the status line every N seconds (writes refreshInterval). Useful when you use time-based widgets (session-clock, block-timer, api-duration) or git widgets that change while a background subagent works. Omit to run only on Claude Code's events.
• --hide-vim-indicator — suppress Claude Code's built-in -- INSERT -- line (writes hideVimModeIndicator). Set this if you use the vim-mode widget so the mode isn't shown twice.

ccstatus uninstall

Removes the ccstatus status line configuration from Claude Code's settings.

ccstatus validate

Checks settings.json for errors such as unknown widget types, missing IDs, or invalid color names.

ccstatus dump [--output FILE]

Reads JSON from stdin (same as normal mode), saves it to a file, and renders the status line. Default output: /tmp/ccstatus-dump.json. Useful for inspecting what Claude Code sends.

ccstatus widgets

Lists all registered widget types with their descriptions and default colors.

# Default: read JSON from stdin, render status line
echo '{"model":{"id":"claude-opus-4-7","display_name":"Opus"}}' | ccstatus

# Replay captured dump data
cat /tmp/ccstatus-dump.json | ccstatus

Settings are stored at ~/.config/ccstatus/settings.json. Edit manually to customize.

A lean 2-line layout. Widgets with nothing to show — effort, git-worktree, rate-limits — are dropped, so a plain session collapses to model | Ctx% | branch | +/- | $ over cwd | Session.

Line 1: model · effort | context % | git branch + worktree | lines +/- | session cost

Line 2: working directory | rate limits (5h/7d) | session clock

Opus 4.7 (1M context) · max | Ctx: 36% | main feat-x | +12 -3 | $0.34
~/dev/myproj | Limit 5h: 3% / 7d: 12% | Session: 2h15m

Sonnet | Ctx: 12% | main | +4 | $0.05
~/dev/myproj | Session: 30m

To customize, edit the lines array in settings.json — e.g. swap rate-limits for the per-window rate-limit-5h (metadata.display: bar/reset/full), or add cache-hit-rate. (If line 1 is getting truncated with ..., see terminalWidth below.)

{
  "version": 4,
  "colorLevel": 2,
  "flexMode": "full-until-compact",
  "compactThreshold": 90,
  "defaultSeparator": "|",
  "defaultPadding": " ",
  "inheritSeparatorColors": false,
  "globalBold": false,
  "lines": [
    [
      {"id": "1", "type": "model", "color": "cyan"},
      {"id": "2", "type": "separator"},
      {"id": "3", "type": "context-percentage", "color": "brightBlack"}
    ]
  ]
}

8 basic: black, red, green, yellow, blue, magenta, cyan, white

8 bright: brightBlack, brightRed, brightGreen, brightYellow, brightBlue, brightMagenta, brightCyan, brightWhite

Claude Code pipes JSON session data to stdin on each update (after assistant messages, permission changes, vim mode toggles). ccstatus parses the JSON, renders widgets according to the configured layout, and outputs ANSI-colored text to stdout.

Claude Code  --[JSON]--> ccstatus --[ANSI text]--> status line

For the full JSON schema, see the official documentation.

Use ccstatus dump to capture the raw JSON that Claude Code sends:

# Temporarily switch to dump mode in ~/.claude/settings.json:
# "command": "ccstatus dump"

# Then inspect the captured data:
cat /tmp/ccstatus-dump.json | jq .

# Replay captured data to test rendering:
cat /tmp/ccstatus-dump.json | ccstatus

• Claude Code Status Line Documentation
• ccstatusline - Original TypeScript implementation

Apache License 2.0