agent-bar

agent-bar

A multi-service status bar for Claude Code that shows real-time context usage, rate limits, cost tracking, and OAuth status — with built-in support for Claude Code and OpenAI Codex.

Opus 4.6  projects/factory  main  +37 -12
context  ======----  62%  2Min/428kout  $4.98 ($3.53/hr)  84m33s  cache:80%  cpu:38% mem:4%
claude   =======--- 75%/day 3M/10M ~10h37m | =========- 95%/wk 3M/50M ~2d10h | ~$4.43
codex    ========-- 84%/5h ~4h 1m          | ===------- 37%/wk ~2d 22h       | ~$0.55
auth     claude:5h48m | codex:6d0h

Features

Line 1 — Session Header

Element	Description
Model	Active model name (e.g., Opus 4.6)
Directory	Last two segments of working directory
Git branch	Current branch name
Lines changed	+added / -removed in this session

Line 2 — Context Window

Element	Description
Progress bar	Visual fill of the context window
Percentage	How full the context window is
Tokens	Cumulative input/output tokens this session
Cost	Combined session cost (Claude + Codex) in USD
Burn rate	Projected cost per hour based on session pace
Cache hit %	Prompt cache efficiency (cache_read / (cache_read + cache_creation))
CPU / Memory	Claude process resource usage

Line 3 — Claude Code Rate Limits

Element	Description
Daily bar	Estimated % of daily token budget remaining
Weekly bar	Estimated % of weekly token budget remaining
Token counts	Used / limit (e.g., 3M/10M)
Reset countdown	Time until the window resets (midnight for daily, Monday for weekly)
Cost	Claude-only session cost

Usage is self-tracked across sessions in ~/.claude/agent-bar-usage.json. Limits are configurable — see Configuration.

Note: Anthropic does not publish exact token limits for Max plans. The defaults (10M/day, 50M/week) are estimates for Max 20x. Adjust to match your experience.

Line 4 — Codex Rate Limits

Element	Description
5h bar	% remaining in the rolling 5-hour window
Weekly bar	% remaining of weekly quota
Reset countdowns	Time until each window resets
Estimated cost	API-equivalent cost based on session tokens

Rate limit data is read directly from Codex session files in ~/.codex/sessions/.

This line only appears if the codex CLI is installed and has session data.

Line 5 — OAuth Status

Element	Description
claude	Time until Claude Code OAuth token expires
codex	Time until Codex OAuth token expires (decoded from JWT)

Color System

Progress Bars

Bars use = for filled and - for empty, colored by threshold:

Context window (higher = worse):

Color	Threshold	Meaning
Green	< 70%	Healthy
Yellow	70-89%	Warning
Red	90%+	Critical — compaction imminent

When the context window fills up, Claude Code automatically compresses earlier messages to free space. The red zone warns you to wrap up complex reasoning before this happens.

Rate limits (higher = better):

Color	Threshold	Meaning
Green	> 30%	Healthy
Yellow	10-30%	Running low
Red	< 10%	Nearly exhausted

OAuth Countdowns

Color	Threshold	Meaning
Green	> 24h	No action needed
Yellow	< 24h	Re-auth soon
Red	Expired	Re-authenticate now

Text Hierarchy

• Bold + color — primary data (percentages, model name)
• Light gray — secondary metrics (tokens, costs, times)
• Dark gray — decorative elements (bar empties, separators)

Requirements

• Claude Code (any plan)
• jq — JSON processing
• git — for branch detection
• Optional: Codex CLI — for Codex rate limit tracking

Installation

As a Claude Code Plugin (recommended)

/plugin marketplace add strataga/agent-bar
/plugin install agent-bar

Then run the setup skill to configure the statusline:

/agent-bar:setup

Restart Claude Code to activate.

Via Install Script

git clone https://github.com/strataga/agent-bar.git
cd agent-bar
./scripts/install.sh

The installer copies statusline.sh to ~/.claude/statusline.sh and adds the statusLine config to ~/.claude/settings.json. Restart Claude Code to activate.

Manual Installation

cp scripts/statusline.sh ~/.claude/statusline.sh
chmod +x ~/.claude/statusline.sh

Add to ~/.claude/settings.json: