pi-speedometer

Per-turn speedometer for pi: TTFT, prefill tok/s, decode tok/s, and total wall time.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:pi-speedometer
Package
pi-speedometer
Version
0.2.0
Published
Aug 12, 2026
Downloads
not available
Author
cpepper1017
License
MIT
Types
extension
Size
14.8 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./extensions/pi-speedometer.ts"
  ]
}

Security note

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

README

pi-speedometer

A per-turn speedometer for pi. It adds these model performance metrics to pi's status line:

  • time to first token (TTFT)
  • prefill tokens per second
  • decode tokens per second
  • total turn time
  • a gauge for decode speed
▁▁·········· ttft 1967ms  prefill 412 tok/s  decode 63.8 tok/s  total 14.2s

The status updates after each completed model turn. It briefly changes color when new data arrives, then stays visible until the next update.

Commands

  • /speed — show recent turns and per-model session averages
  • /speed clear — reset history
  • /speed csv — export history as CSV

Install

pi install npm:pi-speedometer

Or try it without installing:

pi -e npm:pi-speedometer

For calculation details and status behavior, see Metrics and status behavior.

Development

./dev drops you into a nono-sandboxed shell with the toolchain (node 24, matching CI) provided by the nix flake:

./dev                    # interactive sandboxed shell — run pi, npm, etc. inside
./dev npm ci             # or run a one-off command sandboxed
./dev npm run typecheck

The only host prerequisite is nix. One-time setup — install the base sandbox profile pack (using the flake's own nono):

nix --extra-experimental-features 'nix-command flakes' develop -c nono pull always-further/pi

The sandbox profile lives in .nono/pi-speedometer.json and extends always-further/pi; project-specific grants go there.

License

MIT