@nerisma/pi-turn-usage-notifications

Per-turn token and cost notification in pi (output, cache hit/miss, total cost).

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@nerisma/pi-turn-usage-notifications
Package
@nerisma/pi-turn-usage-notifications
Version
1.0.0
Published
Jun 27, 2026
Downloads
229/mo · 22/wk
Author
nerisma
License
MIT
Types
extension
Size
558.4 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions"
  ]
}

Security note

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

README

@nerisma/pi-turn-usage-notifications

Shows a notification after every turn in pi with the usage metrics of the assistant's reply:

> T1 · 0.186$ · OUT 7.79K · HIT 1.41M · MISS 79.60K
Segment Meaning
T1 Turn number
0.186$ Total cost of the turn
OUT Generated tokens (output)
HIT Tokens read from cache (cache read)
MISS Uncached input tokens (input)

Colors follow the active theme (accent / muted / dim).

pi-turn-usage-notifications preview

Installation

pi install npm:@nerisma/pi-turn-usage-notifications

Or via settings.json:

{
  "packages": ["npm:@nerisma/pi-turn-usage-notifications"]
}

How it works

The extension subscribes to the turn_end event. When a turn ends it reads the usage off the assistant message (event.message.usage), which carries the cost breakdown (cost.total) and the token counts (output, cacheRead, input).

usage is not declared on the message union type in pi's published types, so it is read through a narrow local cast; the field is present on the assistant message at runtime.

Each metric becomes a segment, formatted with formatTokens (e.g. 7.79K, 1.41M) and colored with the theme's ANSI codes. Empty segments are dropped: a zero cost, or a turn with no cache activity, simply does not appear. The segments are joined with a dim · separator and emitted as a single line through ctx.ui.notify(line, "info").

Compatibility

  • pi >= 0.78

License

MIT © Sébastien SERVOUZE