claude-statusline

Configurable status line for Claude Code.

Installation

With Homebrew:

brew install felipeelias/tap/claude-statusline

Or with Go:

go install github.com/felipeelias/claude-statusline@latest

Setup

Add to your Claude Code settings (.claude/settings.json or global settings):

{
  "statusLine": {
    "type": "command",
    "command": "claude-statusline prompt"
  }
}

Generate a starter config:

claude-statusline init

Preview with mock data:

claude-statusline test
claude-statusline themes

Commands

Global flags: --config / -c to override config path, --version.

Configuration

Config file location: ~/.config/claude-statusline/config.toml

Works with zero config. The default format is:

format = "$directory | $git_branch | $model | $cost | $context"

Presets

Presets are inspired by Starship presets. Each preset defines the layout, separators, colors, and module configuration.

preset = "catppuccin"

Preview all presets: claude-statusline themes

Built-in presets

Overriding preset defaults

Presets set the format string and module configs, but you can override any field:

preset = "catppuccin"

# Override just one module
[model]
format = " {{.DisplayName}} "
style = "fg:#11111b bg:#cba6f7 bold"

Modules

Enabling modules

To enable a disabled module, set disabled = false and add it to the format string:

format = "$directory | $git_branch | $model | $cost | $context | $session_timer"

[session_timer]
disabled = false

Model module

Template fields:

[model]
format = "{{.Short}}"
style = "bold"

Usage module

The usage module shows your Claude plan usage limits (5-hour rolling window and 7-day). Requires Claude Code 2.1.80+ which provides rate_limits in the status line payload.

format = "$directory | $git_branch | $model | $cost | $context | $usage"

[usage]
disabled = false

Template fields:

To only show usage when it exceeds a threshold (e.g. 5-hour block above 70%, weekly above 80%):

[usage]
disabled = false
format = '{{if ge .BlockPct 70.0}}{{.BlockBar}} {{printf "%.0f" .BlockPct}}%{{end}}{{if ge .WeeklyPct 80.0}} W:{{printf "%.0f" .WeeklyPct}}%{{end}}'

The module renders empty if rate_limits is not present in the Claude Code payload (older versions).

Vim mode module

The vim_mode module shows the current vim editor mode when vim mode is enabled in Claude Code.

format = "$vim_mode | $directory | $git_branch | $model | $cost | $context"

[vim_mode]
disabled = false

Template fields:

The module renders empty if vim mode is not enabled or the mode string is empty.

Clickable hyperlinks (OSC 8)

Modules can wrap their output in OSC 8 terminal hyperlinks, making text clickable in supported terminals.

git_branch

When enabled, the branch name becomes a clickable link to the branch page on the remote. The base URL is auto-detected from git remote get-url origin, and the branch path pattern is selected based on the host:

• GitHub (default): /tree/<branch>
• GitLab (hosts containing "gitlab"): /-/tree/<branch>
• Bitbucket (hosts containing "bitbucket"): /src/<branch>

Branch names are percent-encoded so characters like # don't break the URL.

[git_branch]
hyperlink = true
# hyperlink_base_url = "https://github.com/owner/repo"  # override auto-detection

directory

When enabled, the directory text links to the path using a configurable URL template. The default opens file:// URLs with properly encoded paths; set hyperlink_url_template for VS Code or other editors.

Template fields:

• {{.AbsPathEncoded}} — percent-encoded absolute path (use for URLs)
• {{.AbsPath}} — raw absolute path (use for schemes that handle raw paths, like vscode://)

[directory]
hyperlink = true
# hyperlink_url_template = "file://{{.AbsPathEncoded}}"  # default
# hyperlink_url_template = "vscode://file{{.AbsPath}}"   # open in VS Code

Style system

Modules support a style field that accepts several formats:

Alternatives

Other statusline tools from the awesome-claude-code list:

• claude-powerline
• CCometixLine
• claudia-statusline
• ccstatusline

Contributors

• @sammcj

License

MIT