Past Pi sessions contain useful signals about where tokens and cost went, but they are scattered across session files.
usage opens a local dashboard that summarizes usage by provider and model over useful time ranges.
Use
Run /usage in Pi.
Choose Today, This Week, Last Week, or All Time with Tab or the arrow keys.
Use ↑ and ↓ to select a provider, then Enter or Space to expand its models.
Press v for usage insights.
Press q or Esc to close the dashboard.
The dashboard reads locally stored Pi session files across projects and does not render outside a UI session.
Use it only where aggregating those local session records is appropriate for you.
<img src="assets/banner.svg" alt="usage" height="70">
# usage
Past Pi sessions contain useful signals about where tokens and cost went, but they are scattered across session files.
usage opens a local dashboard that summarizes usage by provider and model over useful time ranges.
## Use
Run `/usage` in Pi.
Choose Today, This Week, Last Week, or All Time with `Tab` or the arrow keys.
Use `↑` and `↓` to select a provider, then `Enter` or `Space` to expand its models.
Press `v` for usage insights.
Press `q` or `Esc` to close the dashboard.
The dashboard reads locally stored Pi session files across projects and does not render outside a UI session.
Use it only where aggregating those local session records is appropriate for you.
[Installation](../../README.md#install)
## Reference
<!-- config:start -->
### Commands
| Command | Purpose |
| --- | --- |
| `/usage` | Show usage statistics dashboard |
<!-- config:end -->
[Changelog](./CHANGELOG.md).
