claude-statusline

A status line for Claude Code that renders one compact line at the bottom of your session:

🤖 Opus 4.8 ● high | 🧠 ████████░░░░░░░░░░░░░░░░░ 32% | 📂 my-repo/src | 🌿 main !2 ⇡1

Repo: github.com/tyler-yukich/claude-statusline (MIT). Original status line by Joseph Brandon Gopiao; packaged for reuse.

Segments

• Model: the active model, with a reasoning-effort dot (● high, ◑ medium, ◔ low) when effort is set.
• Context meter: a 25-cell bar that fills green to yellow to red as the conversation consumes the context window, plus the numeric percentage and a (!) marker at 75% and above.
• Directory: the repo name plus your path within it.
• Git: branch and working-tree state with shape-coded symbols that survive without color: ? untracked, + staged, ! modified, ✘ deleted, » renamed, $ stashed, ⇡/⇣/⇕ ahead/behind/diverged.

Accessibility is designed in: bar length and the percentage are color-independent, git symbols carry meaning by shape, light terminals are detected via COLORFGBG, and the high-usage marker is never color-only.

Install

mkdir -p ~/.claude
curl -fsSL https://raw.githubusercontent.com/tyler-yukich/claude-statusline/main/statusline.sh -o ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

Then merge this into ~/.claude/settings.json and start a new session:

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

Requires bash, jq, and git; a truecolor terminal gets the smooth gradient and everything degrades gracefully without one. You can also point Claude Code at the repo and say "Read the README and install this status line."