A Claude Code mod that shows git state, context window usage, session cost, and usage limits

·

source at cf828ae

·

MIT license

Shows branch safety, context headroom, and account usage in a compact session telemetry strip

0 installs

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 percentage is against your own target (300k by default), not the real context window
  • Change the target from Details or /config, anywhere from 10k to 10m
  • The full context breakdown runs only when you open Details or press Refresh
Are mods safe?

Preview

Terminal

● main Context ███░░░░░░░░░░░░░░░ 15% of 300k Week 7% [ Details ] [-]

Claude Desktop

Session HUD in Claude Desktop

What it does

A one-line strip above the prompt with your Git branch, context used against a target you set, and weekly account usage. Details opens the full breakdown.

What you see
A one-line strip above the prompt, and 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.296

How it works

  1. Draws the strip above the prompt once the session has recorded usage
  2. Checks the Git branch every five seconds, and right after a Claude Bash call
  3. Colors the branch yellow on main, master or a detached HEAD, green elsewhere
  4. Details opens a pane with context by category, 5-hour and weekly limits, and cost

More like this

Token Weather Usage in Claude Desktop

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, and the subagents running. 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).

Deck in Claude Desktop

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.

Flightdeck in Claude Desktop

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

Opus 4.8 [high] ~/app main 16:20:55 | ⛁ ██░░░░░░░░ 22% | 5h ●◔○○○ 26% ↻2h7m | 7d ◔○○○○○○ 7% ↻2d1h │ $0.41 ⏱ 10m

Two-line status with a block context bar and quarter-step dot meters (◔◑◕●) for the 5-hour and weekly limits (fill shows usage, color shows whether you are ahead of or behind pace), plus model, effort, git and cost. Needs no jq.

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 Fable ● ● ● ● ● ● ● ● ● ○ ○ 85% left Resets in 2d 0h ◐ Read:index.ts ✓ Read×1 ✓ Bash×1 ✓ Edit×1 ✓ Grep×1 ◐ code-reviewer Review the change for regressions

A header with model, context and burn rate per hour, then live tool and agent activity parsed from the session transcript.

Model: Opus 4.8 | Thinking: high | Context: [▰▰▱▱▱▱▱▱▱▱] 45k/200k (22%) | cwd: ~/app | ⎇ main | (+0,-0) Cost: $0.41 | Block: 2hr 6m | Weekly: 7.0% | Session: 10m | In: 916.7 t/s | Out: 29.2 t/s | Cached: 2k | Session: [▰▱▱▱▱] 26.0% Mem: 0.8G/1.0G | (*゚∀゚*) | Session ID: b8e1c0d2-4a6f-4e2a-9c1b-3f5d7a9e2c10

Three lines in One Dark: model, thinking effort and a context bar up top; cost, quota, session clock and token throughput in the middle; weather, free memory and a rotating kaomoji below.

🌿 main │ Opus 4.8/hi │ 🟢 Ctx ▓▓░░░░ 22% │ ⏳ 🟢 ▓▓░░░░ 26% ↻ 2h7m │ $0.41 ⏱ 10m

Branch, model with effort level, a context bar and the five-hour quota with reset countdown. Only calls the usage API when stdin lacks rate limits.