---
name: "Dedicated token usage page in web UI"
---

# Story 301: Dedicated token usage page in web UI

## User Story

As a project owner, I want a dedicated token usage page in the web UI that shows per-story and per-agent cost breakdowns with totals, so that I can analyse where tokens are being spent and identify optimisation opportunities.

## Acceptance Criteria

- [ ] New page/panel accessible from the main navigation
- [ ] Shows a table of all recorded agent sessions with story, agent name, model, token counts, and cost
- [ ] Sortable by cost, story, agent, or date
- [ ] Shows summary totals: total cost, cost by agent type (coder vs QA vs mergemaster), cost by model (opus vs sonnet)
- [ ] Data loads from the token_usage.jsonl log via API endpoint

## Out of Scope

- TBD
