timestamp-pi

Timestamps under every message plus a prompt-cache countdown in the footer

Packages

Package details

extension

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

npm repohome report
$ pi install npm:timestamp-pi
Package
timestamp-pi
Version
0.2.1
Published
Sep 3, 2026
Downloads
223/mo · 85/wk
Author
luong.nguyen
License
MIT
Types
extension
Size
11.7 KB
Dependencies
0 dependencies · 2 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ],
  "image": "https://raw.githubusercontent.com/luongnv89/pi-extensions/main/assets/timestamp-pi-timestamps.png"
}

Security note

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

README

timestamp-pi

Show a timestamp under every message in Pi's chat, plus a prompt-cache countdown in the footer.

Timestamps under each message, with the cache countdown in the footer

What it does

  • Per-message timestamps with context — a dim line like ⏱ HH:MM:SS (2m ago) · user message appears directly under each message, labeled as user message, ai response, or tool call
  • Cache miss countdown — a footer status element shows ⏳ cache 4:32, counting down the 5-minute prompt-cache TTL after each response; turns green while warm, yellow under 1 minute, red (cache expired) once the next request will be a cache miss

Timestamps are stored as custom session entries: they persist across reloads and are rendered TUI-only — they are never sent to the LLM. For paid keep-alive turns that refresh the prompt cache, use cache-warm instead; timestamp-pi does not send warming traffic.

Features

  • Zero context pollution — timestamps never reach the model
  • Session-persistent — historical timestamps re-render when you resume a session
  • Live countdown — countdown refreshes every second while the cache is warm
  • Coexists with other footers — adds its own status element instead of replacing Pi's footer (same approach as subagents-pi)
  • Toggle on/off — use /timestamp-pi to enable/disable

Usage

After installation, timestamps appear automatically. Toggle with:

/timestamp-pi

Installation

# From npm
pi install npm:timestamp-pi

# From repo (local)
pi -e ./extensions/timestamp-pi

Reload Pi (/reload) after installing.

Requirements

Requires @earendil-works/pi-coding-agent >= 0.84 (uses registerEntryRenderer).

Commands

Command Description
/timestamp-pi Toggle message timestamps and cache countdown on/off

Example

Chat:

You
Fix the failing test in auth.spec.ts
⏱ 14:32:05 (2m ago) · user message

Assistant
Fixed — running the tests now.
⏱ 14:32:08 (now) · ai response

Assistant
⏱ 14:32:10 (now) · tool call

Status element (in the footer):

⏳ cache 4:12

License

MIT