@zigai/pi-run-timer

Pi package that shows live loader elapsed time, optional rotating working-bar messages, and post-run agent timing stats.

Packages

Package details

extension

Install @zigai/pi-run-timer from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:@zigai/pi-run-timer

Package: @zigai/pi-run-timer
Version: 0.4.0
Published: Jul 4, 2026
Downloads: 564/mo · 20/wk
Author: zigai
License: MIT
Types: extension
Size: 43.1 KB
Dependencies: 1 dependency · 2 peers

Pi manifest JSON

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

Security note

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

README

Pi Run Timer

Adds runtime timing details to Pi:

live loader elapsed time, such as Thinking (12s) or Running command (2m 05s)
optional rotating right-side working-bar messages
a post-run summary widget, such as Worked for 1m 12s. [45 tok/s]

Install

pi install npm:@zigai/pi-run-timer

Configuration

Configure global settings at ~/.pi/agent/pi-run-timer/config.json.

Option	Type	Default	Description
`rightMessages`	`object`	disabled	Rotating right-side working-bar messages.
`rightMessages.enabled`	`boolean`	`false`	Enables messages. If omitted, messages turn on when any are loaded.
`rightMessages.intervalMs`	`integer`	`10000`	Time between message rotations.
`rightMessages.minGap`	`integer`	`4`	Minimum spacing between status text and right-side message.
`rightMessages.minScrollCycles`	`integer`	`1`	Minimum full scroll passes before a long message rotates.
`rightMessages.scrollColumnIntervalMs`	`integer`	`120`	Horizontal scroll speed for long messages.
`rightMessages.dimmed`	`boolean`	`true`	Renders messages dimmed.
`rightMessages.italic`	`boolean`	`true`	Renders messages italic.
`rightMessages.messages`	`string[]`	`[]`	Inline messages.
`rightMessages.messagesFile`	`string`	unset	Text file with one message per non-empty, non-comment line. Relative paths use the config file directory.

{
  "$schema": "./config.schema.json",
  "rightMessages": {
    "enabled": false,
    "intervalMs": 10000,
    "minGap": 4,
    "minScrollCycles": 1,
    "scrollColumnIntervalMs": 120,
    "dimmed": true,
    "italic": true,
    "messages": []
  }
}

License

MIT