# Claude Epic Status Line
Claude Epic Status Line is a feature-rich status line script for [[Claude Code]]. It replaces the default status bar with a multi-line, color-coded display showing model info, context usage, git status, rate limits, session cost, and more.
![[Claude Epic Status Line - Picture.png]]
## Features
- **Model name** (shortened, e.g., `Opus 4.6`)
- **Context usage** with token counts (`12% (42k/200k)`) and color-coded thresholds (green/orange/yellow/red)
- **Auto-compact warning** — blinking `⚠` when context >= 80%
- **Git status** with staged (`S:2`), unstaged (`U:1`), untracked (`A:3`) counts, ahead/behind arrows (`⇡2⇣1`)
- **Worktree detection** — `⎇wt` when inside a git worktree
- **Session cost** (`$X.XX`) and **duration** (`⏱ 12m`)
- **Effort level** — `● high`, `◑ medium`, `◔ low`
- **Rate limit bars** — visual `●○` progress bars for 5-hour, 7-day, and extra usage with reset times, fetched from the Anthropic API (cached 60s)
## How it works
The script receives JSON from Claude Code via stdin. All fields are extracted in a single `jq` call for performance. Rate limits are fetched using the OAuth token (from env, credentials file, `secret-tool` on Linux, or macOS Keychain).
## Requirements
- `jq`, `curl`, `git`
## References
- https://github.com/dsebastien/claude-epic-status-line
- Inspired by https://github.com/kamranahmedse/claude-statusline
## Related
- [[Claude Code]]
- [[Command Line Interface (CLI)]]