claude-statusline

A custom status line for Claude Code CLI showing model, context usage, rate limits, effort level, and more. Fork of @kamranahmedse/claude-statusline with Catppuccin Mocha colors, compact mode, and session-aware effort detection.

Install

Add to your Claude Code settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bunx @zynoo/claude-statusline --bar-style shade --usage-style compact"
  }
}

Requirements

• jq — for parsing JSON
• git — for branch info

On macOS:

brew install jq

CLI Arguments

| Argument | Values | Default | Description | |----------|--------|---------|-------------| | --bar-style | diamond, block, dot, arrow, square, shade | diamond | Progress bar character style | | --usage-style | default, compact | default | Multi-line or single-line usage | | --time-style | remaining, absolute | remaining | 1h·4m left vs 12:00am | | --minimal | flag | off | Model, context % and effort only |

Each has an environment variable equivalent (CLAUDE_STATUSLINE_BAR_STYLE, CLAUDE_STATUSLINE_USAGE_STYLE, CLAUDE_STATUSLINE_TIME_STYLE, CLAUDE_STATUSLINE_MINIMAL); CLI arguments win.

Bar Styles

| Value | Preview | |-------|---------| | diamond (default) | ▰▰▰▱▱▱▱▱▱▱ | | block | ████░░░░░░ | | shade | ▓▓▓░░░░░░░ | | dot | ●●●○○○○○○○ | | arrow | ▸▸▸▹▹▹▹▹▹▹ | | square | ■■■□□□□□□□ |

Usage Styles

default — multi-line with rate limit details:

Opus 4.6 (1M context) │ ✍️ 12% │ my-project (main) │ ⏱ 1h30m │ max
current ▓▓▓▓░░░░░░  44% (1h·4m left)
weekly  ▓▓░░░░░░░░  21% (2d·14h left)

compact — single-line usage:

Opus 4.6 (1M context) │ ✍️ 12% │ my-project (main) │ ⏱ 1h30m │ max
Usage ▓▓▓▓░░░░░░░░ 44% (1h·4m left) │ ▓▓░░░░░░░░░░ 21% (2d·14h left)

--minimal — one line, no rate limits:

Opus 4.6 (1M context) │ ✍️ 12% │ max

Minimal mode exits before touching cwd, git or rate limits, so it also skips the git status call that dominates the render time in a large repo.

Effort Level Detection

Effort level comes from the effort.level field Claude Code (2.1.263+) passes on stdin, which updates the moment /effort runs. Older versions fall back to the effort field Claude Code writes on each assistant turn in the session transcript, then to ~/.claude/settings.json. Supports ultracode, max, xhigh, high, medium, low; ultracode is picked up separately from /effort output since it reports as xhigh. The level is rendered as plain text, colored by tier:

| Level | Color | |-------|-------| | ultracode | Teal | | max | Yellow | | xhigh | Pink | | high | Mauve | | medium | Sapphire | | low | Dim |

Color Scheme

All colors use the Catppuccin Mocha palette:

| Element | Color | |---------|-------| | Model name | Peach #fab387 | | Directory | Sky #89dceb | | Git branch | Green #a6e3a1 | | 5h usage bar | Green #a6e3a1 | | 7d usage bar | Blue #89b4fa | | Empty bar | Surface 0 #313244 |

Credits

Based on claude-statusline by Kamran Ahmed. Thanks for the great work!

License

MIT — see LICENSE for details.