pi-stats-ext

Dense local-first Pi coding-agent usage dashboard for tokens, costs, models, projects, and sessions.

Package details

extension

Install pi-stats-ext from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:pi-stats-ext

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Local-first Pi coding-agent usage dashboard.

pi-stats overview

pi-stats models

/pi-stats opens a dense Ops-console TUI over local session history:

global date ranges: default 30d, plus today, 7d, 90d, all, or YYYY-MM-DD..YYYY-MM-DD
multi-view layout: Overview, Models, Projects, Sessions
responsive, Pi-theme-aware summary cards for fresh tokens, cost, cache leverage, and cost per million fresh tokens
previous-period comparisons that expose changes in spend, usage, cache leverage, and efficiency
decision signals for cost shifts, cache regressions, stable usage, and model concentration
responsive Activity panel with a calendar heatmap, collision-free month labels, active-day cadence, peak/average usage, streaks, busiest weekday, and a fresh-token trend
keyboard-driven model efficiency table with usage share, cost, cache leverage, and cost per million fresh tokens
model inspector with provider, reach, efficiency baseline, and a practical routing recommendation
bordered tables for projects and sessions by cost/tokens
keyboard controls: 1 today, 2 7d, 3 30d, 4 90d, 5 all, d custom date input, o/m/p/s views, tab cycles views, left/right cycles range, up/down or j/k selects a model, enter inspects it, q/esc closes
incremental JSON cache at ~/.pi/agent/pi-stats/cache.json

pi install npm:pi-stats-ext

Then reload Pi and run:

/pi-stats

npm install
pi install ./
# then reload pi and run:
/pi-stats

npm test
npm run build