Why is the 5h / 7d limit display the headline feature?

Because it's the #1 thing users complain about after buying a Claude plan: the default Claude Code status line gives you zero visibility into your 5-hour and 7-day rate limits. You only find out you hit them when Claude refuses to respond mid-task. This script reads limits data from the live JSON, renders both meters in real time, and triggers a visual alert when you cross 50% — so you can plan your session before you crash into the wall.

What does 5h{1.1h}: 1% mean?

You've used 1% of the 5-hour window, and {1.1h} is a live countdown — the window resets in 1.1 hours (7d{1.1d}: the weekly window resets in 1.1 days). Read from rate_limits.*.resets_at on every render. No reset timestamp in your build? The meter falls back to plain 5h: 1%.

Does the status line update by itself? My {1.1h} countdown looks frozen.

Claude Code re-renders on events — new assistant message, /compact, permission-mode or vim-mode change (debounced at 300 ms) — so between events the line freezes. Add "refreshInterval": 30 to the statusLine block in ~/.claude/settings.json and it also re-runs on a fixed 30-second timer, keeping the countdown and time tracker ticking while idle. A render costs ~0.1 s, so 30 s is negligible; use 60 on battery or in huge repos (git status runs each render); minimum is 1.

What is Claude Code Status Line?

A bash-based replacement for the default status line in Claude Code (Anthropic's CLI). Turns the bottom-of-screen line into a real dashboard: model, context %, progress bar, session cost, 5h/7d rate limits, git status, time-on-task, and more.

How do I update to the latest version?

Run ~/.claude/status-line.sh update. The command fetches the latest bundle from GitHub, creates a timestamped backup at ~/.claude/status-line.sh.bak. , and preserves your theme config in ~/.claude/statusline.conf. Restart Claude Code afterwards. Check what version you have with ~/.claude/status-line.sh version.

Does it support the 1M context window models?

Yes. The script detects [1m] in the model id and 1M in the display name and adjusts the bar's denominator to 1,000,000 tokens.

Will it slow down Claude Code?

No. Each render runs once per status redraw. Typical render is under 50 ms even with the time-tracker enabled.

Is it free? Can I use it commercially?

Personal local use is free under the Source-Available License. Any reuse, redistribution, fork, or inclusion in another project requires prior written permission from the author Yevgeniy Achin (amazopic@gmail.com).

Claude Code · Status Line

Issue 01 · 23 languages · 164 specimens GitHub

StatusLine A catalog of terminal status lines for Claude Code

Name: Claude Code Status Line
Author: Yevgeniy Achin

★ NEW · The #1 reason people install this

Limit control.
Maximum productivity.
Zero surprises.

Bought a Pro plan and now you keep hitting the 5-hour or 7-day cap mid-task? The default status line never warns you. This one does. Live 5h / 7d meters, ⚠️ alert above 50 %, baked into every theme.

5-hour limit

7-day limit

Predictable by design — every meter counts down to its reset, so you pace your work instead of hitting the wall.

⚠ Visual alert above 50 % — never hit the wall mid-session.

Install in 30s → See 164 specimens View on GitHub ↗

Live preview · cycling through 10 themes

Context Control

Clear context above 60% — stay sharp.

More context = slower Claude + faster limit burn. Compact early, work efficiently.

Context window

…

View on GitHub

Vibe-chill install

Why touch a terminal
when you have Claude Code?

Paste this one prompt into your Claude Code session. Say "y" when it asks for permission. Done.

No git, no jq install dance, no settings.json hunt — Claude handles every step and asks before each command.

you paste in Claude Code:

Install claude-code-statusline by amazopic for me. Clone the repo at github.com/amazopic/claude-code-statusline, back up my current ~/.claude/status-line.sh if any exists, copy statusline-bundle.sh to ~/.claude/status-line.sh and make it executable, also copy commands/statusline.md to ~/.claude/commands/. Then show me what to add to ~/.claude/settings.json so Claude Code wires up the new statusLine — include { "statusLine": { "type": "command", "command": "/Users//.claude/status-line.sh", "refreshInterval": 30 } } so the line keeps re-running every 30 seconds while idle. Finally run ~/.claude/status-line.sh use developer to test the developer theme and tell me to restart Claude Code.

↳ Just say y (yes) at every permission prompt — Claude will run each command one by one.

Editor's Note

Claude Code ships with a sparse status line. A model name. Maybe a directory. That's it. Meanwhile your context fills up, your 5h and 7d limits tick down, your session quietly accrues cost — and you find out only when you've blown past the window.

This project is the dashboard that should have been there. Eighty-two themes. Twenty-six composable blocks. One bash file. Pick something pretty — or build your own.

View on GitHub

By the numbers

2⚠

limit warnings (5h + 7d)

themes

composable blocks

1.25%

bar precision

documented languages

runtime deps (just bash + jq)

View on GitHub

Contents · 164 specimens

The Catalog
in two volumes — detailed & compact

Eighty-two themes, each in two trims — detailed and compact. Tap a name to jump to its specimen page.

View on GitHub

Specimens

Try it from inside Claude Code ~/.claude/commands/statusline.md

Already in a Claude Code session? Just type /statusline with arguments — the shipped slash command routes everything to the bundle below.

you /statusline cyberpunk

claude ⏺ Switching theme to "cyberpunk"…
✓ ~/.claude/statusline.conf updated. Next render will use the new theme.

you /statusline custom model context-bar limits cost git

claude ⏺ Building custom recipe…
✓ Active blocks: model · context-bar · limits · cost · git

you /statusline list

claude ⏺ Available themes (82):
cyberpunk · hacker · dragonball · naruto · pokemon · ironman · spiderman · einstein · tesla · ferrari
+ 8 Marvel · 8 scientists · 16 car brands · 10 OS · 7 religions · 2 anime · 21 classics

Same script, two modes — stdin = render, args = configure. Already shipped as ~/.claude/commands/statusline.md.

Loading specimens…

View on GitHub

A side-by-side

vs. the default
status line

Capability	Default Claude Code	This project

View on GitHub

Compose
your own

Click blocks to add them to your status line. Watch it render live. Copy the bash and ship.

Live preview

Your recipe

Generated bash

View on GitHub

Get going

Install in 30 seconds

A single bundled script does both jobs: it renders your status line when Claude Code calls it, and it acts as a CLI configurator when you call it with arguments.

Clone & copy

Drop the bundle into ~/.claude/status-line.sh.

Pick a theme

Or compose blocks via custom.

Wire it up

Tell Claude Code about it in settings.json, restart.

★ Or in Claude Code — easiest

Have Claude Code open? Paste these two prompts and you're done — no terminal needed.

you Run: git clone https://github.com/amazopic/claude-code-statusline.git claude-code-statusline / cp claude-code-statusline/statusline-bundle.sh ~/.claude/status-line.sh — back up the existing ~/.claude/status-line.sh if there is one. Then update ~/.claude/settings.json so statusLine is { "type": "command", "command": "/Users/<you>/.claude/status-line.sh", "refreshInterval": 30 }.

02 Then test it:

you /statusline developer

macOS / Linux / WSL

# 1 — clone & copy
git clone https://github.com/amazopic/claude-code-statusline.git
cp claude-code-statusline/statusline-bundle.sh ~/.claude/status-line.sh
chmod +x ~/.claude/status-line.sh

# 2 — pick a theme
~/.claude/status-line.sh use cyberpunk

# 3 — register in ~/.claude/settings.json
# { "statusLine": { "type": "command",
#   "command": "/Users/<you>/.claude/status-line.sh",
#   "refreshInterval": 30 } }

# 4 — restart Claude Code (or /config reload)

refreshInterval: 30 re-runs the line every 30 seconds even while the session is idle — keeps the reset countdown (5h{1.1h}), the time tracker and post-reset flips live. 30 is a sensible default; 60 is battery-frugal; omit to refresh on events only (new assistant message, /compact, vim toggle).

Optional: /statusline slash command

mkdir -p ~/.claude/commands
cp claude-code-statusline/commands/statusline.md \
   ~/.claude/commands/statusline.md

# inside Claude Code:
/statusline cyberpunk
/statusline custom model context-bar git cost
/statusline list

View on GitHub

Q & A

Frequently
Asked

View on GitHub

StatusLine A catalog of terminal status lines for Claude Code

Limit control.Maximum productivity.Zero surprises.

Clear context above 60% — stay sharp.

Why touch a terminalwhen you have Claude Code?

By the numbers

The Catalogin two volumes — detailed & compact

vs. the defaultstatus line

Composeyour own

Install in 30 seconds

Clone & copy

Pick a theme

Wire it up

FrequentlyAsked

Limit control.
Maximum productivity.
Zero surprises.

Why touch a terminal
when you have Claude Code?

The Catalog
in two volumes — detailed & compact

vs. the default
status line

Compose
your own

Frequently
Asked