pi-quota

Anthropic and OpenAI Codex quota status extension for pi.

Install

pi install npm:@ravshansbox/pi-quota

Add -l to install it in project settings.

Usage

Pi loads the extension from ./index.ts and shows the used quota for the provider backing the active model in the footer when pi runs in the TUI.

• Calls the Anthropic usage endpoint once on session start, then reads the Anthropic quota from the rate limit headers of each Anthropic response, and calls it again after the reset ping (or at the reset when the active model is not from Anthropic)
• Polls the OpenAI Codex usage endpoint on session start, then at every 10-minute wall-clock mark (HH:00, HH:10, HH:20, HH:30, HH:40, HH:50)
• Shows a footer status for the provider backing the active model, and only when quota data for that provider has been polled; switching models re-renders it immediately
• The text stays compact, e.g. 7% 1h29m · 33% 4d, where the 5-hour window comes first and the 7-day window second, and each window shows its used percentage followed by time until reset
• Available resets, when present, are appended as · 2x 5h (count, then time until the soonest expires)
• Both providers are checked on session start whenever their credentials exist, so quota is already known when the active model changes
• Refreshes Anthropic and OpenAI Codex OAuth access tokens from ~/.pi/agent/auth.json when needed, writes updated credentials back (re-reading the file first to avoid clobbering concurrent updates), and notifies on the first successful refresh per provider each session
• Appends poll and token-refresh errors to ~/.pi/agent/pi-quota.log
• Does nothing outside the TUI (RPC, JSON and print modes, including subagents)

Configuration

No configuration is required. OAuth credentials for Anthropic and OpenAI Codex are read from ~/.pi/agent/auth.json.

To redeem a saved OpenAI Codex reset automatically when the 7-day window is exhausted, add this to ~/.pi/agent/settings.json:

{
  "quota": {
    "codexResets": { "autoRedeem": true }
  }
}

Development

npm install
npm run check