@e9n/pi-jobs

Agent run tracking extension for pi — job history, cost analysis, and session telemetry

Package details

← Back
extension

Install @e9n/pi-jobs from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:@e9n/pi-jobs
Package
@e9n/pi-jobs
Version
0.1.1
Published
Apr 26, 2026
Downloads
162/mo · 147/wk
Author
e9n
License
MIT
Types
extension
Size
72.2 KB
Dependencies
1 dependency · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

@e9n/pi-jobs

Agent run telemetry and cost tracking for pi. Records every agent invocation with token usage, estimated cost, duration, and tool call stats.

Features

  • Auto-tracking — records all agent runs via session lifecycle events
  • Cost tracking — token usage and estimated cost per model and provider
  • Tool stats — call counts, error rates, and average duration per tool
  • Channel tracking — separate stats for tui, cron, heartbeat, and subagent runs
  • jobs tool — LLM can query stats, cost reports, model breakdowns, and recent runs
  • Web dashboard — auto-mounts at /jobs via pi-webserver
  • /jobs command — quick stats in the TUI

Setup / Settings

Add to ~/.pi/agent/settings.json (global) or .pi/settings.json (project):

{
  "pi-jobs": {
    "dbPath": "jobs/jobs.db",
    "useKysely": false
  }
}
Key Default Description
dbPath "jobs/jobs.db" SQLite file path (relative to agent dir).
useKysely false Use pi-kysely shared DB instead of a local SQLite file.

Tool: jobs

Query agent run telemetry.

Action Params Description
stats period?, channel? Summary totals: runs, errors, tokens, cost, tool calls, avg duration
recent channel?, limit? Recent runs with status, prompt preview, tokens, cost, and duration
cost_report period?, channel? Daily cost breakdown over the period
models period? Token and cost breakdown by provider/model
tools period? Tool call frequency, error count, and avg duration

period: today · week · month (default) · all
channel: tui · cron · heartbeat · subagent

Commands

Command Description
/jobs Show totals across all channels
/jobs tui Stats for TUI sessions only
/jobs cron Stats for cron job runs
/jobs heartbeat Stats for heartbeat check runs
/jobs subagent Stats for subagent runs

Web UI

Requires pi-webserver. The dashboard mounts automatically at /jobs and re-mounts if pi-webserver starts after pi-jobs.

Install

pi install npm:@e9n/pi-jobs

License

MIT