@wannfq/pi-meter

Provider allowance windows for Pi — displayed in a compact /meter overlay.

Packages

Package details

extension

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

npm repohome report
$ pi install npm:@wannfq/pi-meter
Package
@wannfq/pi-meter
Version
0.2.0
Published
Jul 31, 2026
Downloads
75/mo · 75/wk
Author
wannfq
License
MIT
Types
extension
Size
104.3 KB
Dependencies
0 dependencies · 2 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

pi-meter

pi-meter is a Pi extension that shows provider allowance windows in a compact /meter overlay.

Features

  • Shows OpenAI Codex subscription allowance and reset times through Pi's existing openai-codex login.
  • Shows xAI SuperGrok's shared weekly usage through Pi's SuperGrok / X Premium OAuth login.
  • Keeps successful provider readings visible when another provider fails.
  • Shows Claude as awaiting-interface support while Anthropic's allowance API remains unpublished.
  • Keeps OpenCode Go as awaiting-interface until a public quota API exists.
  • Fetches only when /meter opens or you request a refresh. It performs no startup requests or background polling.

Install

Pi packages run with full system access. Review the source before installing.

pi install npm:@wannfq/pi-meter

You can also install directly from GitHub:

pi install git:github.com/wannfq/pi-meter

To try the extension without installing it:

pi -e npm:@wannfq/pi-meter

Use

Run Pi in interactive mode, then enter:

/meter

Use r to request a refresh and Esc or q to close the overlay. You can also open the overlay with a forced refresh:

/meter refresh

A forced refresh bypasses cached freshness, but it still respects provider rate protection. OpenAI Codex requires an openai-codex account in Pi. SuperGrok requires Pi's xAI OAuth login; an XAI_API_KEY alone does not grant access to consumer subscription usage.

Develop

This project requires Node.js and the pnpm version declared in package.json.

pnpm install
pnpm check
pnpm test
pnpm dev

pnpm dev starts Pi with only this extension loaded. See docs/providers.md before adding or changing a provider. Project conventions and validation requirements are in AGENTS.md.

License

MIT