---
name: "Bot cost command shows total and per-story token spend"
---

# Story 302: Bot cost command shows total and per-story token spend

## User Story

As a project owner in a Matrix room, I want to type "{bot_name} cost" to see total token spend and the top most expensive stories, so that I can check burn rate from my phone.

## Acceptance Criteria

- [ ] '{bot_name} cost' shows total spend for the last 24 hours
- [ ] Shows top 5 most expensive stories from the last 24 hours with their costs
- [ ] Shows cost breakdown by agent type (coder, QA, mergemaster) for the last 24 hours
- [ ] Also shows an all-time total for context
- [ ] Registered in the command registry so it appears in help output
- [ ] Handled at bot level without LLM invocation

## Out of Scope

- TBD
