A statusline for Claude Code.

One bash script. It shows your folder, branch, model, and effort, how full the context window is, and your 5-hour, 7-day, and Fable limits as bars under the prompt.

The prompt for Claude Code

> Install or update the statusline from https://github.com/alp82/claude-statusline for me.
  Run: curl -fsSL https://alp82.github.io/claude-statusline/install.sh | bash
  Then check that bash, jq and curl are present, confirm ~/.claude/settings.json
  points statusLine at ~/.claude/statusline.sh and subagentStatusLine at
  ~/.claude/subagent-statusline.sh, and tell me what to do next.

Paste it into Claude Code and press return. The same prompt installs it, and updates it later. Install it by hand GitHub ↗

Usage against time

The top half of the bar shows usage. The bottom half shows elapsed time. When the bar turns red, lower the effort level.

The row under the bar shows the effort level for each tenth of the window.

bar color · usage vs time quota to spare: raise model or effort on pace: keep as is runs out early: lower model or effort number color · usage under 50% 50–80% over 80%

Context window

The bar turns yellow at 25% and red at 50%. Start a new session at yellow. Answers get worse as the window fills.

The agent panel

Each subagent shows its own context bar, model, and effort.

The Fable window

Fable has its own weekly quota. The limit is usually lower than for other models, so it gets a glance instead of a track: two columns, your usage beside the week’s clock, and the exact number in the percentage.

Repo and git state

The first row answers what you are working on and what you have done to it: the folder and the branch on the left, then how many files changed by kind and how many lines, pushed right so its edge lands where the second row ends. Long folder and branch names are cut to fit.

Context and limits

The second row is the instrument panel: how full the context window is, then the 5-hour limit and the 7-day and Fable windows.

Install or update

One prompt does both. Paste it into Claude Code the first time to install the statusline, and paste the same prompt again any time you want the latest version. Claude installs or replaces the scripts, updates the settings, and checks the result.

01Paste this into Claude Code

> Install or update the statusline from https://github.com/alp82/claude-statusline for me.
  Run: curl -fsSL https://alp82.github.io/claude-statusline/install.sh | bash
  Then check that bash, jq and curl are present, confirm ~/.claude/settings.json
  points statusLine at ~/.claude/statusline.sh and subagentStatusLine at
  ~/.claude/subagent-statusline.sh, and tell me what to do next.

Claude reads the installer before it runs it and tells you what changed.

02Or run the installer yourself

$ curl -fsSL https://alp82.github.io/claude-statusline/install.sh | bash

The same script without the agent, and the same either way: it puts statusline.sh and subagent-statusline.sh into ~/.claude/ and points settings.json at them, with a backup of anything it replaces. Run it again whenever you want the latest version. --no-settings installs the scripts only. --help lists all options.

03Or install it by hand

$ curl -fsSL https://raw.githubusercontent.com/alp82/claude-statusline/HEAD/statusline.sh \
    -o ~/.claude/statusline.sh
$ curl -fsSL https://raw.githubusercontent.com/alp82/claude-statusline/HEAD/subagent-statusline.sh \
    -o ~/.claude/subagent-statusline.sh
$ chmod +x ~/.claude/statusline.sh ~/.claude/subagent-statusline.sh

Two files, nothing else. Then add the settings below yourself.

04Point Claude Code at it

// ~/.claude/settings.json
{ "statusLine": { "type": "command",
    "command": "~/.claude/statusline.sh" },
  "subagentStatusLine": { "type": "command",
    "command": "~/.claude/subagent-statusline.sh" } }

The prompt and the installer write this for you. You need it only after a manual install or --no-settings.

Needs bash, jq and curl. Claude Code sends the data on stdin. The script fetches only the Fable number itself, in the background, at most every ten minutes.

The same prompt in reverse. It removes both scripts and their settings entries, and leaves a backup of each.

01Paste this into Claude Code

> Uninstall the statusline from https://github.com/alp82/claude-statusline for me.
  Run: curl -fsSL https://alp82.github.io/claude-statusline/install.sh | bash -s -- --uninstall
  Then confirm ~/.claude/statusline.sh and ~/.claude/subagent-statusline.sh are gone,
  confirm ~/.claude/settings.json has no statusLine or subagentStatusLine entry,
  and show me which .bak files it left behind.

Claude runs it and tells you where the backups are.

02Or run it yourself

$ curl -fsSL https://alp82.github.io/claude-statusline/install.sh | bash -s -- --uninstall

Removes both scripts from ~/.claude/, the statusLine and subagentStatusLine entries in settings.json, and the cached usage numbers. It backs up the scripts and settings.json as .bak first. It changes nothing else, and it leaves an entry alone if it points at another statusline. --no-settings removes the scripts only.

The only other state is the cached Fable number under ~/.claude/cache/, and the uninstall removes it too. Delete the .bak files when you no longer need them.

MIT alp82/claude-statusline @alperortac

⟩

⏵⏵ bypass permissions on (shift+tab to cycle) · ← for agents