claude-code-statusline

English 🇺🇸 · Português 🇧🇷

Status line for Claude Code: project and branch, context window, session time, usage limits.

1. project (branch) +added -removed
2. model context bar % · session time
3. 5h N% reset · 7d N% reset — hidden inside tmux when tmux-vitals already shows it

Install

Let Claude install it

Paste this into a Claude Code session:

Install https://github.com/k8adev/claude-code-statusline as my status line:
clone it into ~/.claude/claude-code-statusline, point statusLine in
~/.claude/settings.json at its statusline.sh, and check that jq is installed.

Manual

git clone https://github.com/k8adev/claude-code-statusline ~/.claude/claude-code-statusline

~/.claude/settings.json:

{
  "statusLine": {
    "type": "command",
    "command": "bash ~/.claude/claude-code-statusline/statusline.sh"
  }
}

Requires bash, jq, git, a truecolor terminal and a Nerd Font.

Options

All via environment variables.

Icons are Nerd Font glyphs, given here by codepoint since GitHub can't render them; the screenshot shows how they look.

Context thresholds are low on purpose: Anthropic's best practices say performance degrades as the window fills, and used_percentage counts input tokens only.

Colors follow the Anthropic palette (Clay, Olive, Kraft, Deep).

License

MIT © k8adev. See LICENSE.