pi-stats-dashboard

Local usage and behavior dashboard for Pi agent sessions

Packages

Package details

extension

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

npm repo home report

$ pi install npm:pi-stats-dashboard

Package: pi-stats-dashboard
Version: 0.1.3
Published: Sep 1, 2026
Downloads: not available
Author: suryavamsi06
License: MIT
Types: extension
Size: 250.8 KB
Dependencies: 0 dependencies · 0 peers

Pi manifest JSON

{
  "extensions": [
    "./extensions/stats.js"
  ],
  "image": "https://unpkg.com/pi-stats-dashboard@0.1.3/artifacts/stats.png"
}

Security note

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

README

pi-stats-dashboard

A local, privacy-first /stats dashboard for Pi. It reads Pi's persisted JSONL sessions and opens a browser dashboard with lifetime, today, 7-day, and 30-day usage.

GitHub repository · npm package

Pi Stats dashboard

Install

pi install npm:pi-stats-dashboard

Then run Pi and use /stats.

Included metrics

Input, output, reasoning, cache read/write, total tokens, recorded cost, requests, and errors
Daily activity and breakdowns by model, provider, project, agent, and tool
Local-only behavior counters for user messages: yelling, profanity, anguish, correction, repetition, and blame
Malformed-record diagnostics

Costs are the values recorded by providers and may be zero or unavailable. They are estimates, not invoices. Pi does not persist reliable historical latency, TTFT, tokens/sec, or subscription-window data, so those are intentionally not fabricated.

The server binds to 127.0.0.1, uses a random URL token, and returns aggregate data only. Prompt and response text is never retained or returned; behavior analysis happens in memory.

NixOS

Requires Pi to be installed separately.

Add the flake and module to your NixOS configuration:

inputs.pi-stats-dashboard.url = "github:suryavamsi6/pi-stats-dashboard";

modules = [
  inputs.pi-stats-dashboard.nixosModules.default
];

programs.pi-stats-dashboard.enable = true;

Apply the configuration, then register the package with Pi:

sudo nixos-rebuild switch --flake .#your-hostname
pi install /run/current-system/sw/share/pi-stats-dashboard

For a one-off install without the module:

pi install "$(nix build --no-link --print-out-paths github:suryavamsi6/pi-stats-dashboard)"

Development

pi -e .
npm test
npm run check
npm pack --dry-run

This package intentionally uses Node built-ins and no runtime dependencies. The generated tarball is publish-ready; npm publication and repository creation are not automated.