@sanif/pi-turnstamp

A configurable timestamp and elapsed-time badge for Pi agent turns.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@sanif/pi-turnstamp
Package
@sanif/pi-turnstamp
Version
0.1.0
Published
Aug 11, 2026
Downloads
113/mo · 16/wk
Author
sanif
License
MIT
Types
extension
Size
177.5 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

Turnstamp

A polished, configurable completion timestamp and elapsed-time badge for Pi agent turns.

                              ◷ Aug 11, 2026, 2:13:04 PM • 12.4s

The badge is right-aligned by default and adapts safely to narrow terminals.

Turnstamp displayed after a completed Pi response

Behavior

  • Starts timing when an interactive query is submitted.
  • Stops only when the agent is fully settled, including tool calls, retries, automatic compaction, and queued continuations.
  • Formats the completion datetime in your local locale and time zone.
  • Adds a themed, durable transcript badge after the final agent response.
  • Applies appearance changes to existing timing entries when the transcript rerenders.
  • Keeps timing entries out of model context; they are never sent to the LLM.
  • Runs only in Pi's interactive TUI, so print, JSON, and RPC output stay unchanged.

Configuration

Run the slash command:

/turnstamp

It opens an interactive settings panel. Changes save immediately and persist globally in ~/.pi/agent/turnstamp.json (or the directory selected by PI_CODING_AGENT_DIR). Existing response-timing.json preferences migrate automatically.

Turnstamp interactive settings panel

Available settings:

  • Alignment: right, center, or left
  • Visual style: themed badge or minimal line
  • Show date: on or off
  • Show time: on or off
  • Show duration: on or off

Restore defaults with:

/turnstamp reset

The previous /response-timing command remains available as a compatibility alias.

Install

Once published to npm:

pi install npm:@sanif/pi-turnstamp

Or install directly from the sanif GitHub namespace:

pi install git:github.com/sanif/pi-turnstamp

For local development, point Pi at this package directory:

pi install /absolute/path/to/turnstamp

If the package is already under ~/.pi/agent/extensions/turnstamp, Pi auto-discovers it. Run /reload in an existing Pi session after changes.

Development

bun install
bun run verify

verify runs TypeScript checks, the complete Bun test suite, and a package dry run.

Privacy

The extension performs no network requests and stores only submission time, completion time, and elapsed milliseconds in Pi's existing local session file.

License

MIT