Skip to content

m5d215/claude-statusline

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

claude-statusline

A Powerline-style status line for Claude Code, written as a single jq-jit program.

Segments

catalog

Segment Description
Model Claude model name and context window size
Directory Current working directory (~/src/github.com/ and ~/src/gitlab.com/ are shortened with icons)
Git branch Current branch (hidden when not in a git repo)
Context % Context window usage — green → yellow → red as it fills
Rate limits 5-hour and 7-day usage with reset time (hidden when no data)

Requirements

  • macOS (Linux is not currently supported)
  • jq-jit — a jq interpreter with exec/execv builtins
  • Nerd Font — for Powerline and icon glyphs
  • Claude Code

Installation

Homebrew (recommended)

brew install m5d215/tap/claude-statusline

This pulls in jq-jit automatically and installs the script as claude-statusline on your PATH.

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

{
  "statusLine": {
    "type": "command",
    "command": "claude-statusline",
    "padding": 0
  }
}

Manual

1. Install jq-jit (via Homebrew, cargo install, or a release binary).

2. Download the script

curl -o ~/.claude/statusline.sh https://raw.githubusercontent.com/m5d215/claude-statusline/main/statusline.sh
chmod +x ~/.claude/statusline.sh

3. Configure Claude Code

Add to your ~/.claude/settings.json:

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

License

MIT

About

Powerline-style status line for Claude Code

Topics

Resources

License

Stars

Watchers

Forks

Contributors

Languages