A cockpit for Claude Code: plan bars and subagent strips, context, usage limits with reset countdowns and burn rates, spend, the model route and a pet. Six bar styles, three collapsed looks. CLI and Desktop.
Session HUD
Notice when Claude Code is on the main branch
A one-line strip above the prompt with your git branch (yellow on main, master or a detached HEAD), context use against a target you set, and weekly usage.
What this mod can do
- Reviewed at commit cf828ae
- Runs programs
- Changes your settings in /config
- Sees each Bash tool call before it runs and can block or change it
1 more thing it can do
- Runs on a timer
Good to know (3)
- The context target only changes the meter, not Claude's real context window or auto-compaction
- Its full context breakdown runs only when you open Details or press Refresh, never in the background
- Change the target (10k to 10m) from Details, or under Context target in /config
Preview
Terminal
● main Context ███░░░░░░░░░░░░░░░ 15% of 300k Week 7% [ Details ] [-]Claude Desktop
What it does
In the author's words
Shows branch safety, context headroom, and account usage in a compact session telemetry strip
- What you see
- A one-line strip above the prompt, plus a Details pane
- Works in
- Terminal and Claude Desktop
- Slash commands
- None
- Uses your tokens
- No
- Changes files
- Only through programs it runs
- Network access
- Only through programs it runs
- Reviewed commit
- cf828ae
- Preview recorded with
- Claude Code 2.1.309
How it works
- Checks the git branch every five seconds, and at once when a Claude Bash call switches it
- Measures context use against your personal target, 300k by default
- Shows seven-day account usage as a compact Week percentage
- Opens a Details pane with both usage windows, session cost and a context breakdown
Common questions
How do I know which git branch Claude Code is working on?
The branch comes first in the strip above the prompt: green for working branches, yellow for main, master or a detached HEAD, and none outside a repo. It checks every five seconds, so it also catches switches made in another terminal.
How much context am I using in Claude Code?
The strip shows a meter and percentage against a personal target (300k by default). It turns yellow at 70 percent and red at 90. The Details pane breaks the context into messages, system content, tool schemas, memory, skills, agents and MCP tools.
Where can I see my weekly Claude usage?
The Week label in the strip shows your seven-day account usage. Select Details to see the five-hour and weekly windows with their reset times, plus the session cost when Claude Code reports one.
Badge for your README
Own this listing? Add it to your README. The badge shows the install count as it grows.
[](https://staging.statuslin.es/mods/session-hud?utm_source=readme-badge)
Or show the preview card:
[](https://staging.statuslin.es/mods/session-hud?utm_source=readme-badge)
More like this
Flightdeck: a live agent dashboard for Claude Code. Main model vitals, an on-call architect, every permission check, subagent cards and swimlanes, a turn receipt and a session log, all from real session events
An animated pixel-art companion above your prompt that reacts to your session and your typing, with a live context meter.
One line above the prompt: context tokens with their weather, a bar per recent prompt, your 5-hour and 7-day limits against the time elapsed, the prompt cache with its time left, the session cost with the last prompt's share in dollars and in points of the 5-hour limit, the subagents running, and a one-click pill for the GOs Claude proposes. Labels in English, French or Russian. After Token Weather (Anthropic, Apache-2.0) and the ideas of usage-meter (HolyGrail) and prompt-cache-control (Daniel San).
Opus 4.8 high ✦ │ ctx 22% │ app (main) │ PR #1287 ● │ $0.41 · 10m +128 -34
Session ● ● ● ● ● ● ● ● ○ ○ ○ 74% left Resets in 2h 6m
Weekly ● ● ● ● ● ● ● ● ● ● ○ 93% left Resets in 2d 0h
Feature-rich bash status line with model, context bar, session cost (read live from Claude Code, so it stays correct on any model), rate-limit bars, and live tool/agent activity that adapts to terminal width. Source: github.com/JungHoonGhae/claude-statusline
Opus 4.8 │ ✍️ 78% │ app (main) │ +128/-34
Cost $0.4100
Tokens in 44.0k │ cache write 5000 │ cache read 2000 │ out 1.4k
Compact status line showing model, context remaining %, directory/git, session time and lines changed, with rate-limit bars or a cost/token breakdown. Source: github.com/susomejias/claude-statusline
✧ ███████████▋ 73% 🗝 Ultima Weapon ✦ app ∙ main
♥ ████████████████████████ 100% 「SAVE POINT」 ✶ Limit Form ◉ 41
Claude Code plan-usage HP bar that reads the Claude auth token to show remaining usage.
Opus 4.8 │ main │ app │ ▓▓░░░░░░░░ 44k/200k │ $0.41
Catppuccin Frappé–themed status line with model, git branch and dirty flag, folder, a block context bar, and session cost. Source: github.com/danjdewhurst/cc-status-line