Claude Code Status Line
https://github.com/shanraisshan/claude-code-status-line- Category
- Developer Tools
- Rank
- No. 1140Tools index
Previous survey · No. 1145 ·
- Pricing
- Open Source
- Type
- TOOL
- Builder
- shanraisshan
- GitHub
- 64 stars
- Date
About
Custom Claude Code status line showing context window usage, git status, and active model info.
What it does
It reads Claude Code’s session data from standard input and turns it into a compact terminal readout: model and effort, a segmented token meter, plus five-hour and weekly quota use with reset times.
Why it's ranked here
A focused choice for developers who want session pressure visible without opening another view. The implementation handles loading states, missing quota data, large context sizes, and differing system date commands, while staying small enough to inspect quickly.
What's good
The display degrades cleanly when data is unavailable. Quota sections appear only when present, context percentage is capped at 100, and color thresholds flag rising pressure. It also falls back between macOS and GNU date syntax for reset times.
Tradeoffs
Installation is manual and depends on Bash, jq, sed, and date. The token count is estimated from a rounded percentage, so it is not exact. Context color changes only after 60 percent, while quota warnings use separate thresholds. It provides no Git information.
How to use it well
Use it when long Claude Code sessions make context and quota awareness important, especially on Pro or Max plans where rate-limit data can appear. It suits developers comfortable installing one shell script and editing configuration. It does not replace repository status tools, usage history, or broader monitoring.
Technical notes+
status-line.sh reads JSON with cat, extracts values through jq, strips trailing model annotations with sed, and defaults context_window_size to 200000. It rounds used_percentage, caps it at 100, derives approximate token labels, and renders ten circle segments. format_limit() colors quota use at 70 and 90 percent, while format_when() tries BSD/macOS date -r before GNU date -d. README.md documents command-based Claude Code configuration. .vscode/settings.json only sets an editor window color.
Observed
- Primary language
- Bash shell script
- Installation surface
- Manual download or copy, executable permission, and Claude Code settings configuration
- Interface
- Command-based Claude Code status line reading JSON from standard input
- Runtime dependencies
- Bash, jq, sed, cat, and date
- Platform handling
- Reset-time formatting supports BSD/macOS date syntax with a GNU date fallback
- Implementation structure
- A single shell script contains parsing, formatting, coloring, and output logic
Read from README.md, status-line.sh, .vscode/settings.json.
What it can do
Display context window usage
Current Claude conversation state → Visual indicator of context window utilization
Show git repository status
Local git repository → Current branch, commit status, and repository state
Display active Claude model information
Current Claude session → Model name and version being used
Provide real-time status updates
Code editor activity and git changes → Updated status line display
Monitor development environment state
Code editor and git workspace → Consolidated status information in status bar
Tags
Tech Stack
Comments (0)
No comments yet
Editorially curated, with community endorsements as a secondary signal. Corrections welcome.