claude-statusline CLI
A Claude Code status line showing model, effort level, context fill, git branch and the 5-hour and weekly limits.
- 1,402 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The script reads Claude Code JSON and git repository state, and the installer edits `~/.claude/settings.json`.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add cli/claude-statuslineDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The script reads Claude Code JSON and git repository state, and the installer edits `~/.claude/settings.json`.
This is third-party code. Review the repository files before installing.
What it does
The `npx @kamranahmedse/claude-statusline` command places a script at `~/.claude/statusline.sh` and registers it in Claude Code settings. The installer keeps your old status line in a backup. The script receives JSON from Claude Code and draws one line: model name, effort level, how many context tokens are used, current directory, git branch and a mark for uncommitted changes. Separate indicators show how much of the five-hour and weekly limits is used and when they reset, with colors shifting from green to red as usage grows. The bash script uses jq, curl and git. Uninstalling restores the previous line from the backup.
Who it is for. Claude Code subscribers who want to see remaining limits and context fill without opening separate commands.
Good fit when
- The five-hour limit runs out unexpectedly and you want the percentage right in the terminal.
- A session approaches the context limit and you must decide when to compact history.
- Work spans several branches and a hint about a dirty git tree is useful.
- You want a ready status line without writing your own script.
Not a fit when
- jq is missing: the script parses JSON with it, and on macOS it comes from brew.
- You already tuned a status line by hand and must not touch it: the installer replaces the settings entry.
- You use a plan without five-hour limits: those indicators will not show.
Example request
Install the claude-statusline status line and show which fields it prints in my repository right now.Limitations
jq, curl and git are required. The installer edits `~/.claude/settings.json` and copies the script to `~/.claude/statusline.sh`, so a previous status line is switched to the new one, and the `--uninstall` flag restores it. Limit data comes from the Claude Code JSON, and if the subscription does not provide it the indicators stay empty. The author built the project for personal use and ships a minimal set of fields without display settings. The last commit dates from November 2026.
How to disable. Run `npx @kamranahmedse/claude-statusline --uninstall`: it restores the previous line from the backup or removes the settings entry together with the script.
FAQ
How do I install the status line?
Run `npx @kamranahmedse/claude-statusline`. It backs up the old line, copies `statusline.sh` to `~/.claude` and updates the settings.
What does it show?
Model, effort level, used context, directory, git branch and the five-hour and weekly limit usage with reset times.
What must be installed first?
jq, curl and git. On macOS jq comes from `brew install jq`.
How do I get my previous line back?
Run the installer with the `--uninstall` flag: it restores the backup or clears the settings.
Where are files written?
The script goes to `~/.claude/statusline.sh` and settings are edited in the Claude Code configuration. The installer touches nothing else.
Discussion
No questions or reviews yet.
Related
CLI toolsA Claude Code status line showing 5-hour and 7-day quota use plus the pace: whether what is left lasts until the window resets
A customizable status line for Claude Code: model, git branch, context, usage limits and other widgets
A statusline for Claude Code: token and cost usage, context left, rate limits and git branch in four styles and six themes
A Claude Code status line with 5-hour and weekly limit usage, reset countdowns, model and prompt cache lifetime
claudeline draws a Claude Code status line: plan, model, context usage and 5-hour and 7-day limits.
A Claude Code plugin: a status line with context, 5-hour and 7-day limits, cost and usage of Codex, Gemini and z.ai
README in short
A Node package installs a bash status-line script and edits Claude Code settings. The script itself depends on jq, curl and git.