Skip to content

claude-code-statusline

TypeScript

Beautiful status line for Claude Code.

Highly customizable status line with granular control over every element. Shows project name, git branch, framework, runtime, commit status, git indicators, and current Claude model. Zero dependencies in your project.

claude-code statusline cli

[features]

Project Info

Project name, git branch, framework, runtime

Git Status

Commits ahead/behind, staged, modified, untracked

Model Display

Current Claude model

Customizable

Toggle elements, change colors, swap icons

[install]

npm create claude-statusline

# Or with other package managers:
npx create-claude-statusline
pnpm dlx create-claude-statusline
bunx create-claude-statusline

[usage]

# What you get:
[ ◈ my-project on ⎇ main via ◉ React (node) | ↑ 2 / + 1 / ~ 3 / ? 2 | ⌘ Sonnet 4.5 ]

# Uninstall:
rm -rf .claude/scripts/statusline*.cjs
# Then remove "statusLine" from .claude/settings.local.json

[customization]

// Edit .claude/scripts/statusline-config.cjs

FEATURES: {
  SHOW_PROJECT: true,
  SHOW_GIT_BRANCH: true,
  SHOW_FRAMEWORK: true,
  SHOW_RUNTIME: true,
  SHOW_GIT_AHEAD: true,
  SHOW_GIT_STAGED: true,
  SHOW_GIT_MODIFIED: true,
  SHOW_GIT_UNTRACKED: true,
  SHOW_MODEL: true,
}

ICONS: {
  PROJECT: '◈',
  BRANCH: '⎇',
  GIT_AHEAD: '↑',
  GIT_STAGED: '+',
  GIT_MODIFIED: '~',
  GIT_UNTRACKED: '?',
  MODEL: '⌘'
}

[license]

This project is licensed under the MIT license.

[links]