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.5
Published: Jun 17, 2026
Downloads: 379/mo · 379/wk
Author: wdphoto
License: MIT
Types: extension
Size: 37.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

A small local prompt counter for Pi.

It adds a compact footer tally and a /tally command. It counts your local Pi user messages only.

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

Hide or restore the footer with /tally footer off, /tally footer on, or /tally footer to toggle.

Install

From npm:

pi install npm:pi-tally

From GitHub/source:

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

Restart Pi after installing.

Commands

/tally              show your prompt stats
/tally run          count existing Pi session history
/tally status       show storage/index info
/tally footer       toggle footer tally on/off
/tally footer on    show footer tally
/tally footer off   hide footer tally

Run this once after installing if you want old sessions included:

/tally run

After that, pi-tally updates live as you use Pi. Run /tally run again only for missed/imported sessions or a clean rebuild.

Notes

A /tally report looks roughly like this:

pi-tally
────────
5h demand      avg 64 / high 91 / peak 121
Active days    18 in last 30d
Model          deepseek/deepseek-v4-pro
Today          52 so far (4.1/hr)
Tree path      5
Daily avg      84/day on active days
Daily high     221
7d avg         96/day on active days
30d avg        88/day on active days
All time       5.6k across 350 sessions
Indexed since  2026-03-07 (60 active / 101 calendar days)

5h demand summarizes active days' busiest 5-hour stretches over the last 30 days. high is the conservative high-use mark; peak is the biggest observed window. Footer day counts use your computer's local calendar day. UTC session filenames do not define "today". All counts come from local Pi session files. All-time totals may include inactive tree paths.

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