@djoeyg/pi-usage

Remaining subscription usage for Claude, OpenAI Codex and OpenCode Go, as a /usage overlay and footer status line

Package details

extension

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

$ pi install npm:@djoeyg/pi-usage

Pi manifest JSON

{
  "extensions": [
    "./index.ts"
  ]
}

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

Remaining subscription quota for pi, the terminal-based coding agent, covering Claude, OpenAI (Codex) and OpenCode Go.

/usage overlay — one section per provider; each window shows a bar of quota remaining, the percentage left and a reset countdown. r refreshes, esc closes. Results fill in as each provider responds.
Footer status — compact Provider 89% percentages, refreshed every 5 minutes. The provider of the currently selected model is shown first, with a thin bar.
Theme aware — all colours use pi's theme tokens: accent when healthy, warning below 30%, error below 10%.

Provider	Source	Shows
Claude	Claude Code keychain login	5 hour + weekly windows (Opus/Sonnet and extra credits when present)
OpenAI	`~/.codex/auth.json` ChatGPT login	primary + secondary windows, code review limits
OpenCode Go	`~/.pi/agent/auth.json` or `$OPENCODE_API_KEY`	5 hour + weekly + monthly windows

Credentials are only read, never refreshed — run claude / codex once yourself to refresh an expired login.

https://opencode.ai/zen/go/v1/usage is undocumented and could change.

By default all three providers show. To hide some, create ~/.pi/agent/pi-usage.json:

{ "providers": ["claude"] }

or set the environment variable PI_USAGE_PROVIDERS=claude,openai. Run /reload after changing either.

pi install npm:@djoeyg/pi-usage
pi install git:github.com/D-Joey-G/pi-extensions  # or all four extensions