By jonra
Claude Code statusline HUD — context burn rate, cost tracking, git status, stall detection
A heads-up display for Claude Code — see your context usage, costs, rate limits, and git status at a glance.
codeye │ Opus 4.6 │ 📁 my-project │ ⏱ 4m32s │ $0.24
▓▓▓▓░░░░░░ 42% │ 84k │ +1.2k/min │ ⎇ feature/auth +2 ~1 ↑3
5h 73% ↺1h20m · 7d 45% ↺4d
codeye adds a live statusline to Claude Code that keeps you informed while you work. No setup required — install and go.
Run these commands inside Claude Code:
/plugin marketplace add jonra/codeye
/plugin install codeye
/codeye:setup
The /codeye:setup command configures the statusLine setting — required for the HUD to appear. The statusline shows up immediately after setup. No restart needed.
Note: The
statusLinesetting is global-only (~/.claude/settings.json) — Claude Code does not support it at the project level. The HUD will be active across all projects.
Requirements: Claude Code v1.0.80+ · Node.js 18+
Opus 4.6)▓▓▓▓░░░░░░ 42%)Colors shift from green to yellow to red as you approach limits.
/compact when your context is getting full (70%) and warns you at 90%| Command | What it does |
|---|---|
/codeye:setup | Configures the statusline in your Claude Code settings |
/codeye:status | Checks that everything is installed and working |
You can customize codeye by editing ~/.claude/plugins/codeye/config.json. Everything works out of the box with sensible defaults — only change what you want to.
{
"contextBarWidth": 10,
"contextWarnAt": 70,
"contextCritAt": 90,
"gitEnabled": true,
"gitShowDirty": true,
"gitShowAheadBehind": true,
"burnRateEnabled": true,
"burnRateWindow": 60,
"costEnabled": true,
"costWarnAt": 0.50,
"costCritAt": 2.00,
"stallEnabled": true,
"stallWarnSec": 30,
"stallCritSec": 90,
"showModel": true,
"showProject": true,
"showSessionTime": true,
"rateLimitsEnabled": true
}
git clone https://github.com/jonra/codeye
cd codeye
npm ci && npm run build
# Test without a live Claude Code session
npm run test:mock # 42% context, normal session
npm run test:critical # 87% context → /compact warning
npm run test:expensive # $3.47 cost → red indicator
npm run test:fresh # brand new session, no tokens yet
npm run test:ratelimit # rate limits with 73% session, 45% weekly
See CONTRIBUTING.md for how to add a widget.
MIT — see LICENSE
Matches all tools
Hooks run on every tool call, not just specific ones
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
npx claudepluginhub jonra/codeye --plugin codeyeA rich statusline for Claude Code — context, rate limits, tool activity, token costs. Pure bash, no dependencies beyond jq.
Terminal HUD for Claude Code — real-time token, cost, git, and project monitor
Lightweight Claude Code status-line monitor with switchable styles, themes, and slash commands. v3.14.1 lowers the projection red line to 85% (yellow now 70–84) so a 7d window heading for →99% reads red instead of merely warm. v3.14.0 colours the 5h/7d bars by where usage is HEADED, not where it is now: once an end-of-window projection exists, the bar fill, label, and reset clock take their severity from the projected % against the cap (green <80, yellow 80–99, red ≥100) while the fill length still shows current usage — so a 7d window at 24% but on track for →96% reads yellow instead of a falsely-healthy green (all three styles). It also fixes the →NN% projection reading far too low for the first ~15 min after a reset (it was seeded from the used=0 first tick and lagged); it now holds `→--` until MIN_ELAPSED, then seeds from the first trustworthy reading. v3.13.3–v3.13.5 fix the 5h/7d bars sticking at a stale high % after Anthropic re-baselines usage mid-window (e.g. weekly limit raised): the cross-session merge now accepts an official downward revision once the old reading goes unconfirmed for 120s, idle windows replaying hours-old rate_limits blobs (expired 5h reset) can no longer overwrite or re-confirm the shared reading, and the →NN% projection drops its old-denominator samples and relearns after a re-baseline instead of freezing for the rest of the window. v3.13.0 adds a ⚙ session-mode line — effort (low/medium/high/xhigh/max/ultracode/auto) · thinking · fast · output-style — with a distinct static colour gradient per effort tier. v3.12.0 adds an always-on end-of-window projection (→NN%, learned from your local work rhythm) + an at-risk `⚠eta` forecast after each reset timer, session lines on by default, and a faint on-bar version that shows a `↑` hint when a newer release is on PyPI. v3.10.0 adds an opt-in live-activity line (in-progress todo, active tool, completed-tool rollup), git ahead/behind + session duration/lines on the project line, running-subagent lines, an opt-in `bar_shimmer` starfield on the battery bars, and a self-hosted plugin marketplace — plus a reliability fix so auto-update actually runs in daemon mode (detached, non-blocking) and the cache countdown is now per-session-correct. v3.9.0 makes the `cache` countdown auto-detect the real prompt-cache TTL (5m vs 1h) from the transcript, fixing a ~55-minute early `cache COLD` for Claude subscription users (Claude Code requests the 1-hour TTL automatically). v3.7.0 defends against status-line hijacking: a new `cs --setup --project [PATH]` writes a project-level override so another tool stealing the global `~/.claude/settings.json` slot can't kick `cs` out of this project; when displacement is detected, the bar also surfaces a one-line warning. v3.6.0 makes daemon (fast) mode the default for `cs --setup` — under 1% CPU continuously instead of ~3% inline at refreshInterval=1; pass `--inline` to opt back. Requires the `cs` CLI from PyPI (`pip install claude-statusbar` or `uv tool install claude-statusbar`).
Real-time statusline HUD for Claude Code - context health, tool activity, agent tracking, and todo progress
Live usage status bar for Claude Code — session limits, weekly usage, lines changed, 10 themes, widget priorities, shimmer animations, and zero API calls
Multi-model consensus engine integrating OpenAI Codex CLI, Gemini CLI, and Claude CLI for collaborative code review and problem-solving.