pi-tally

Local prompt counters for the Pi coding agent.

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-tally

Package: pi-tally
Version: 0.0.9
Published: Jun 21, 2026
Downloads: 828/mo · 828/wk
Author: wdphoto
License: MIT
Types: extension
Size: 67.9 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

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

Security note

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

README

pi-tally

pi-tally screenshot

A small local user prompt counter for Pi. It adds a compact tally to the footer and a /tally command.

Use /tally run after installing to count your session history.

Hide or restore the footer with /tally footer to toggle. The toggle applies across projects using the same Pi agent directory.

That's pretty much it. Definitely a work in progress.

Footer example:

5/52/84↑

That means:

5 prompts today on the active Pi tree path
52 prompts today overall
84 average prompts on active days
↑ or ↓ trend once there is enough history

Install

pi-tally is intended to be installed globally for your Pi user, not per project. I haven't even tested it any other way.

From npm:

pi install npm:pi-tally

From GitHub/source:

pi install https://github.com/wdphoto/pi-tally

Restart Pi after installing.

Commands

/tally run          count your Pi history
/tally              show your stats
/tally all          show verbose stat output
/tally footer       toggle footer tally on/off
/tally status       show storage/index info

Notes

A /tally report looks roughly like this:

Since:         2026-03-07 (60 active days / 101 calendar days)
Tree:          5 messages on active path
Today:         52 messages so far (4.1 messages/hr)
Daily avg:     84 messages/day   last 24h 52 messages
Recent avg:    7d 96 messages/day↑   30d 88 messages/day↓
5h window:     avg 64 messages   high 91 messages   peak 121 messages
Streak:        5 days current / 12 days record
Record:        221 messages on 2026-06-14
Total:         5.6k messages across 350 sessions

Crumb:         899,934 characters sent to Pi.

Data

The counter is stored locally at:

~/.pi/agent/pi-tally.json

Pi session files stay where Pi already stores them.

Uninstall

If installed from npm:

pi remove npm:pi-tally

If installed from GitHub/source:

pi remove https://github.com/wdphoto/pi-tally

Optional clean slate:

rm ~/.pi/agent/pi-tally.json