claude-code-status-line

README

Claude Code Status Line

A custom status line hook for Claude Code that displays rich session information with colorized output in your terminal.

Features

Displays the following information when Claude Code starts or updates:

• User and directory: Current username and working directory
• Git status: Current branch with dirty indicator (*)
• Model info: Active Claude model name
• Usage metrics: Context window usage percentage and total cost
• Token counts: Input and output tokens

Installation

Option 1: Using go install

go install github.com/0xys/claude-code-status-line@latest

The binary will be installed to your $GOPATH/bin directory (typically ~/go/bin).

Option 2: Build from source

git clone https://github.com/0xys/claude-code-status-line.git
cd claude-code-status-line
go build -o bin/claude-code-status-line main.go

Usage

Configure Claude Code to use this command by editing ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "claude-code-status-line <my_username>"
  }
}

• <my_username> is an optional argument. If no argument is provided, it uses your system username.

• Gray: username and directory
• Orange: git branch and status
• Light Blue: model name
• Yellow: usage percentage and cost
• Light Red: input/output token counts (input ➜]..[➜ output)

Requirements

• Go 1.24 or later
• Git (for git status detection)
• Claude Code CLI

Development

Build

$ mise run build

Display Sample Output

$ mise run sample
<my_username>:~/code/personal/project main* 👾 Claude Sonnet 4.5 used 45.23% $1.25 8912 ➜]..[➜ 15234

See CLAUDE.md for architecture details and development guidance.

License

MIT