https://github.com/m5d215/claude-statusline
A Powerline-style status line for Claude Code, written as a single jq-jit program
https://github.com/m5d215/claude-statusline
claude-code claude-code-statusline jq powerline
Last synced: about 1 month ago
JSON representation
A Powerline-style status line for Claude Code, written as a single jq-jit program
- Host: GitHub
- URL: https://github.com/m5d215/claude-statusline
- Owner: m5d215
- License: mit
- Created: 2026-03-28T09:21:56.000Z (3 months ago)
- Default Branch: main
- Last Pushed: 2026-05-01T12:06:37.000Z (about 2 months ago)
- Last Synced: 2026-05-01T14:09:35.675Z (about 2 months ago)
- Topics: claude-code, claude-code-statusline, jq, powerline
- Language: Shell
- Homepage:
- Size: 187 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# claude-statusline
A Powerline-style status line for [Claude Code](https://claude.ai/code), written as a single [jq-jit](https://github.com/m5d215/jq-jit) program.
## Segments
| 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](https://github.com/m5d215/jq-jit) — a jq interpreter with `exec`/`execv` builtins
- [Nerd Font](https://www.nerdfonts.com/) — for Powerline and icon glyphs
- [Claude Code](https://claude.ai/code)
## Installation
### Homebrew (recommended)
```sh
brew install m5d215/tap/claude-statusline
```
This pulls in [jq-jit](https://github.com/m5d215/jq-jit) automatically and installs the script as `claude-statusline` on your `PATH`.
Then add to your `~/.claude/settings.json`:
```json
{
"statusLine": {
"type": "command",
"command": "claude-statusline",
"padding": 0
}
}
```
### Manual
**1. Install [jq-jit](https://github.com/m5d215/jq-jit)** (via Homebrew, `cargo install`, or a release binary).
**2. Download the script**
```sh
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`:
```json
{
"statusLine": {
"type": "command",
"command": "~/.claude/statusline.sh",
"padding": 0
}
}
```
## License
MIT