statusline

Themeable status line provider for Claude Code.

Requires Bun.

Preview

Default Theme

Two-row layout with model, session, project directory, git status, and context usage:

Powerline Theme

Single-row powerline-style segments with muted dark backgrounds and arrow separators:

Wraps to multiple lines when segments exceed terminal width. Select with --theme powerline.

Install

bunx @nutthead/cc-statusline install

Then add to ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline"
  }
}

Use --overwrite to replace an existing installation.

Themes

Built-in themes: default (two-row), powerline (single-row with powerline arrows).

Use --theme powerline to select a built-in theme.

Custom Themes

Create a JS file that default-exports an async theme function (e.g. ~/.config/cc-statusline/theme.js):

export default async function theme(input) {
  if (!input) return "";
  const status = JSON.parse(input);
  return `${status.model.display_name} | ${status.workspace.current_dir}`;
}

Then point to it in ~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "~/.claude/statusline --theme-file ~/.config/cc-statusline/theme.js"
  }
}

Available Fields

The JSON object passed to your theme function contains these fields:

Field	Example
session_id	"f9abcdef-1a2b-..."
transcript_path	"/home/user/.claude/transcript"
cwd	"/home/user/project"
model.id	"claude-opus-4-6"
model.display_name	"Claude Opus 4.6"
workspace.current_dir	"/home/user/project"
workspace.project_dir	"/home/user/project"
version	"2.1.39"
output_style.name	"Explanatory"
context_window.total_input_tokens	12345
context_window.total_output_tokens	6789
context_window.context_window_size	200000
context_window.current_usage	{ ... } or null
context_window.current_usage.input_tokens	1024
context_window.current_usage.output_tokens	512
context_window.current_usage.cache_creation_input_tokens	256
context_window.current_usage.cache_read_input_tokens	128
context_window.used_percentage	42.5 or null
context_window.remaining_percentage	57.5 or null
context_window.vim.mode	"INSERT" or "NORMAL"
context_window.agent.name	"claude-code"
context_window.agent.type	"main"

See src/schema/statusLine.ts for the full schema.

Troubleshooting

Execution logs are stored in ~/.local/state/statusline/app.log.

License

MIT