statusline

ccr statusline

Display a customizable status bar showing real-time information about your Claude Code session, including workspace, Git branch, model, token usage, and more.

Overview

The ccr statusline command reads JSON data from stdin and renders a beautifully formatted status bar in your terminal. It's designed to integrate with Claude Code's hook system to display real-time session information.

Usage

Basic Usage

ccr statusline

The command expects JSON data via stdin, typically piped from a Claude Code hook:

echo '{"hook_event_name":"...","session_id":"...","..."}' | ccr statusline

Hook Integration

Configure in your Claude Code settings:

{
  "hooks": {
    "postResponse": {
      "command": "ccr statusline",
      "input": "json"
    }
  }
}

Available Themes

Default Theme

A clean, minimal theme with Nerd Font icons and colored text:

 󰉋 my-project   main  󰚩 claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

Powerline Theme

A vim-powerline inspired style with colored backgrounds and arrow separators:

 󰉋 my-project   main  󰚩 claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

Activate by setting currentStyle: "powerline" in your config.

Simple Theme

Fallback theme without icons for terminals that don't support Nerd Fonts:

my-project  main  claude-3-5-sonnet-20241022  ↑ 12.3k  ↓ 5.2k

Automatically used when USE_SIMPLE_ICONS=true or on unsupported terminals.

Available Modules

Status line modules display different types of information:

Module	Description	Variables
workDir	Current working directory name	{{workDirName}}
gitBranch	Current Git branch	{{gitBranch}}
model	Model being used	{{model}}
usage	Token usage (input/output)	{{inputTokens}}, {{outputTokens}}
context	Context window usage	{{contextPercent}}, {{contextWindowSize}}
speed	Token processing speed	{{tokenSpeed}}, {{isStreaming}}
cost	API cost	{{cost}}
duration	Session duration	{{duration}}
lines	Code changes	{{linesAdded}}, {{linesRemoved}}
script	Custom script output	Dynamic