@championswimmer/pi-speedometer

A pi extension that shows live LLM streaming performance in the status bar:

⚡ 42.1 t/s ⏱ 412ms

• ⚡ TPS — output tokens per second (first content delta → now / stream end)
• ⏱ TTFT — time to first token (provider request → first content delta)

Values update live while streaming (throttled to ~4/sec) and the final exact numbers remain displayed after the response finishes.

Install

Development (symlink into pi's global extensions dir):

mkdir -p ~/.pi/agent/extensions
ln -s "$(pwd)/src/index.ts" ~/.pi/agent/extensions/pi-speedometer.ts

Hot-reload inside pi with /reload.

Quick one-off test:

pi -e ./src/index.ts

As a package (published on npm under the scoped name):

pi install npm:@championswimmer/pi-speedometer

Usage

The /speed command controls what is shown and how it is labeled:

| Command | Effect | |---|---| | /speed | Show current settings summary | | /speed tps on\|off | Toggle the tokens/sec readout | | /speed ttft on\|off | Toggle the time-to-first-token readout | | /speed tps icon\|text | Switch the TPS label between ⚡ and TPS | | /speed ttft icon\|text | Switch the TTFT label between ⏱ and TTFT |

Settings persist globally at ~/.pi/agent/pi-speedometer.json, with the shape:

{
  "showTps": true,
  "showTtft": true,
  "tpsStyle": "icon",
  "ttftStyle": "icon"
}

With both metrics off, the status entry is cleared.

Note: the npm package uses the scoped name @championswimmer/pi-speedometer because the unscoped pi-speedometer name is already taken on npm.

Notes

• Provider usage streaming differs. Anthropic streams cumulative output-token counts mid-stream, so live TPS is exact. OpenAI chat-completions only send usage in the final chunk, so mid-stream TPS uses a chars / 4 estimate and snaps to the exact value when the stream ends. Google usually reports per-chunk.
• Multiple LLM calls per agent run (tool loops) re-anchor the timing on each request, so the display always reflects the current call.
• No runtime dependencies — only Node builtins and type-only imports from pi packages.