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 repohome report
$ pi install npm:pi-tally
Package
pi-tally
Version
0.0.7
Published
Jun 20, 2026
Downloads
547/mo · 547/wk
Author
wdphoto
License
MIT
Types
extension
Size
49.7 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.

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 / 101 calendar days)
Tree:          5
Today:         52 so far (4.1/hr)
Daily:         avg 84   24h 52   7d 96↑   30d 88↓
5h window:     avg 64   high 91   peak 121
Streak:        5d current / 12d record
Record:        221 on 2026-06-14
Total:         5.6k across 350 sessions

Pi Crumbs:     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