Skip to content

v1.7.2 — Status line for quota/TTL warnings

Choose a tag to compare

@cnighswonger cnighswonger released this 13 Apr 00:16
· 303 commits to main since this release

Ships tools/quota-statusline.sh — a Claude Code status line script that displays live quota and cache state:

Q5h: 84% (+0.3%/m) | Q7d: 29% (+0.4%/hr) | TTL:1h 97.9%

When the server downgrades your TTL to 5m at Q5h ≥ 100% (the Layer 2 quota-aware downgrade documented in our blog series), the status line shows TTL:5m in red — a visible signal to stop working and wait for the Q5h window to reset rather than powering through overage, which compounds the drain.

Setup

mkdir -p ~/.claude/hooks
cp "$(npm root -g)/claude-code-cache-fix/tools/quota-statusline.sh" ~/.claude/hooks/
chmod +x ~/.claude/hooks/quota-statusline.sh

Add to ~/.claude/settings.json:

{ "statusLine": { "command": "~/.claude/hooks/quota-statusline.sh" } }

What it shows

  • Q5h % with burn rate (%/min)
  • Q7d % with burn rate (%/hr)
  • TTL tier — TTL:1h (green) or TTL:5m (red)
  • Cache hit rate %
  • PEAK flag during weekday peak hours (13–19 UTC)
  • OVERAGE flag when active