Claude Code status line
Claude Statusline
One bash script for the Claude Code statusline: dir, branch, model, context window, and 5h / 7d / Fable rate-limit bars.
Install
git clone https://github.com/alp82/claude-statusline.gitFrom the README
claude-statusline Are you spending faster than the clock? One bash script. Each limit bar shows two things: how much you have used, and how much time has passed. If usage is ahead of time, drop an effort level. If it is behind, you can raise it. Your folder, branch, model, effort and context window sit on the same line, under the prompt. See it in motion → alp82.github.io/claude-statusline 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. Claude reads the installer before it runs it and tells you what changed. Or run the installer yourself The same script without the agent. It installs the statusline, and updates it if you already have it: It puts statusline.sh and subagent-statusline.sh into ~/.claude/, makes them executable, and points settings.json at them. It copies anything it replaces to .bak first. Run it again to upgrade. --no-settings installs the scripts only. --help lists all options. Or install it by hand Two files, nothing else: Then add this to ~/.claude/settings.json: refreshInterval re-runs the line every five seconds on top of the usual event-driven updates. Without it the file and line counts go stale whenever a subagent writes to the tree while the session is idle, and the ↻ countdowns only move when something else happens. Raise it on a large repository, where git status is the slowest part of a render. Uninstall The same prompt in reverse: Or run it yourself It removes both scripts from ~/.claude/, the statusLine and subagentStatusLine entries in settings.json, and the cache under ~/.claude/cache/. It backs up the scripts…
How status lines work
- A status line is a command Claude Code runs to draw the bar under the prompt. It gets the session as JSON on stdin (model, folder, cost, context) and prints one or more lines.
- Point the statusLine setting in ~/.claude/settings.json at it: { "statusLine": { "type": "command", "command": "<the command from the README>" } }.
- Or run /statusline inside Claude Code and describe what you want.
Details
- Repository
- alp82/claude-statusline
- Type
- Status lines
- Language
- TypeScript
- License
- MIT
- Last updated
- 2 September 2026
FAQ
What is Claude Statusline?
One bash script for the Claude Code statusline: dir, branch, model, context window, and 5h / 7d / Fable rate-limit bars. It is a status line for Claude Code, from alp82/claude-statusline on GitHub.
How do I install Claude Statusline?
Clone alp82/claude-statusline from GitHub and follow the setup steps in its README.
Is Claude Statusline popular?
alp82/claude-statusline has 27 GitHub stars and 3 forks. It was last updated on 2 September 2026.
More status lines
Termagitchi
18TevvvB/termagitchi
A creature for every git worktree, living in your coding agent's status line. Deterministic species, rarity bands, and one view across every live session.
Claude Statusbar
29vbcherepanov/claude-statusbar
A rich, two-line status bar for Claude Code CLI — real-time model, context usage, tokens, cost, duration, git branch, cache stats and more in your terminal
Ccsidekick
31krayong/ccsidekick
A Claude Code status line with a reactive character plus cost, git, and usage widgets. Zero token spend, local-first, MIT.
Capybara Toolbox
32dvwinck/capybara-toolbox
Five Claude Code plugins, Python stdlib + git. ar-board: judge agent proposals one by one on a local board; the agent keeps your reasons. publish-check: scan a repo's history for personal data before it goes public. tidy-board: delete stale branches, worktrees, and stashes only on approval. Plus doc, handoff, and TODO tools, and a status line.
UI Themes
27yugal1107/ui-themes
Switchable UI themes for Claude Code: padded message boxes, themed markdown, matching status line
Claude Statusline
27hell0github/claude-statusline
A Lightweight Statusline plugin for Claude Code CLI to track context, cost usage and session reset time
Browse the most popular Claude Code mods, all status lines, or the skills and MCP server directories.