@championswimmer/pi-subscription-meter

Pi extension scaffolding for showing subscription and quota usage across AI providers.

Packages

Package details

extension

Install @championswimmer/pi-subscription-meter from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@championswimmer/pi-subscription-meter
Package
@championswimmer/pi-subscription-meter
Version
0.1.0
Published
Jun 29, 2026
Downloads
160/mo · 160/wk
Author
championswimmer
License
UNLICENSED
Types
extension
Size
101.3 KB
Dependencies
0 dependencies · 3 peers
Pi manifest JSON
{
  "extensions": [
    "./src/extensions/core/index.ts"
  ]
}

Security note

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

README

pi-subscription-meter

A Pi extension package for surfacing subscription, quota, and usage limits across AI providers.

Status

Early framework in place.

This repository currently contains:

  • npm + TypeScript package setup for a Pi extension
  • a /subscriptions Pi command
  • a tabbed Pi TUI dialog that renders one tab per enabled provider
  • a pluggable provider registry with initial scaffolds for OpenAI Codex, GitHub Copilot, Anthropic, OpenRouter, and OpenCode
  • repo-level agent instructions in AGENTS.md
  • Agent Skills under .agents/skills/
  • an implementation planning workflow under .agents/plans/

Actual subscription fetching, auth wiring, and live usage meters will come next.

Initial scope

The extension is intended to track or summarize subscription/usage information for providers such as:

  • Anthropic
  • OpenAI / ChatGPT / Codex
  • OpenRouter
  • OpenCode
  • GitHub Copilot

Inspiration

This project is intentionally inspired by:

Development

npm install
npm run typecheck

Current command

Once this extension is loaded in Pi, use:

/subscriptions

This opens a tabbed dialog showing all currently enabled provider scaffolds.

Press s inside the dialog to open provider settings in a sub-dialog overlay and enable/disable providers.

Enabled providers

Enabled providers are determined by saved extension settings.

The extension stores its settings in the Pi agent directory using the documented Pi helper for resolving that path (getAgentDir()), and writes:

~/.pi/agent/subscription-meter.json

If PI_CODING_AGENT_DIR is set, Pi’s configured agent directory override is respected automatically.

Use the in-app settings overlay opened with s from /subscriptions to update provider enablement.

Planned package shape

  • src/extensions/core/index.ts — Pi extension entrypoint
  • .agents/skills/ — reusable Agent Skills for planning and provider research
  • .agents/plans/ — implementation plans created before work begins