@deathbeam/pi-usage

Minimal extension for token usage and cost per provider, model and project.

Packages

Package details

extension

Install @deathbeam/pi-usage from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@deathbeam/pi-usage

Package: @deathbeam/pi-usage
Version: 0.0.6
Published: Nov 11, 2026
Downloads: 702/mo · 37/wk
Author: deathbeam
License: MIT
Types: extension
Size: 36.3 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

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

Security note

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

README

@deathbeam/pi-usage

Use the /usage command for a fullscreen dashboard of token usage and costs.

Keys

Key	Action
Tab, Shift+Tab, ← / →	Cycle groups. Inside an open day, skip day.
`[` / `]`	Step the day when it is the innermost filter
Enter	Open the selected row
Esc	Go back, or close when at the top level
`q`	Close
↑ / ↓, `j` / `k`	Move the cursor
Page Up / Page Down	Move by a page
`g` / `G`	Move to the first / last row

Day rows include days without usage. Δ compares cost with the previous day. The sparkline always shows total cost per day across all history; the day in context is highlighted.

The summary compares the daily spend so far this week and month with last week and month. Weeks start on Monday in local time. ▲new means the previous period had no spend.

Installation

# Choose one:
pi install npm:@deathbeam/pi-usage               # this package
pi install git:github.com/deathbeam/pi-packages  # all my packages

Development

From this package directory:

npm install
npm test
pi install .