dashboard: two-meter run header — live context-window % + cumulative $ cost #967

New issue

Closed

opened 2026-05-08 12:15:53 +00:00 by claude-desktop · 2 comments

claude-desktop commented

2026-05-08 12:15:53 +00:00

Collaborator

User story

As an operator under a hard monthly budget, I want every run to show a live context-window % bar (per turn) and a cumulative $ cost counter (per run) at the top-right of the run header, so I can interrupt runaway tasks before they burn budget or hit context limits.

Context

Token meter (#952) ships per-task usage. Cost rate table (#953) ships per-task USD. This ticket binds both into the run header chrome and adds the context-window bar (which neither prior ticket covered explicitly).

Acceptance criteria

<RunHeaderMeters> component, mounted in: planner drawer header, monitor detail header, agent timeline header.
Meter 1 — context window: bar showing tokens_in_current_context / model_context_window. Color tiers: <50% neutral, 50–90% warn, >90% error. Tooltip lists per-tool token attribution (Read X / Bash Y / system Z) — see follow-up ticket.
Meter 2 — cumulative cost: $ figure (3 sig figs). Color tiers per a configurable soft budget. Tooltip breaks down by model / provider when mixed.
Compaction events render as discrete pill markers on the context-window bar.
Both meters update live via the SSE usage_delta and result events; coalesced ≤4 Hz.
Mobile: meters collapse into the drawer's status bar instead of the header.

Out of scope

Per-tool token attribution chart (separate follow-up).
Budget enforcement / auto-cancel.

Dependencies

Depends on #952 (live token meter foundation).
Depends on #953 (cost rate table).

References

Augment Code's argument for per-tool cost surface: https://www.augmentcode.com/guides/ai-agent-loop-token-cost-context-constraints
phuryn/claude-usage dashboard reference: https://github.com/phuryn/claude-usage

## User story As an operator under a hard monthly budget, I want every run to show a live **context-window %** bar (per turn) and a cumulative **$ cost** counter (per run) at the top-right of the run header, so I can interrupt runaway tasks before they burn budget or hit context limits. ## Context Token meter (#952) ships per-task usage. Cost rate table (#953) ships per-task USD. This ticket binds both into the run header chrome and adds the context-window bar (which neither prior ticket covered explicitly). ## Acceptance criteria - [ ] `<RunHeaderMeters>` component, mounted in: planner drawer header, monitor detail header, agent timeline header. - [ ] **Meter 1 — context window**: bar showing `tokens_in_current_context / model_context_window`. Color tiers: <50% neutral, 50–90% warn, >90% error. Tooltip lists per-tool token attribution (Read X / Bash Y / system Z) — see follow-up ticket. - [ ] **Meter 2 — cumulative cost**: $ figure (3 sig figs). Color tiers per a configurable soft budget. Tooltip breaks down by model / provider when mixed. - [ ] Compaction events render as discrete pill markers on the context-window bar. - [ ] Both meters update live via the SSE `usage_delta` and `result` events; coalesced ≤4 Hz. - [ ] Mobile: meters collapse into the drawer's status bar instead of the header. ## Out of scope - Per-tool token attribution chart (separate follow-up). - Budget enforcement / auto-cancel. ## Dependencies - Depends on #952 (live token meter foundation). - Depends on #953 (cost rate table). ## References - Augment Code's argument for per-tool cost surface: https://www.augmentcode.com/guides/ai-agent-loop-token-cost-context-constraints - `phuryn/claude-usage` dashboard reference: https://github.com/phuryn/claude-usage

claude-desktop added the

area:dashboard

type:user-story

labels

2026-05-08 12:18:10 +00:00

claude-desktop added a new dependency

2026-05-08 12:19:18 +00:00

#952 agents: live token meter — accumulate per-task usage across both providers

claude-desktop added a new dependency

2026-05-08 12:19:18 +00:00

#953 agents: per-model rate table + runner cost computation (cursor parity with claude-code)

claude-desktop added a new dependency