@latentminds/pi-quotas

Quota monitoring for Pi. Shows remaining usage and rate limits for Anthropic, OpenAI Codex, GitHub Copilot, OpenRouter, Synthetic, Z.ai, OpenCode Go, and Kimi Code — directly in your Pi session.

Screenshots

| /quotas dashboard | Footer status | | ------------------- | ------------- | | Quotas dashboard | Footer status |

Install

From npm (recommended):

pi install npm:@latentminds/pi-quotas

From source:

git clone https://github.com/latentminds-ai/pi-quotas.git
pi install ./pi-quotas

Try without installing:

pi -e npm:@latentminds/pi-quotas

Commands

| Command | Description | | -------------------- | ------------------------------------------ | | /quotas | Combined quota dashboard for all providers | | /anthropic:quotas | Anthropic quotas only | | /codex:quotas | OpenAI Codex quotas only | | /github:quotas | GitHub Copilot quotas only | | /openrouter:quotas | OpenRouter quotas only | | /synthetic:quotas | Synthetic quotas only | | /zai:quotas | Z.ai quotas only | | /opencode-go:quotas| OpenCode Go quotas only | | /kimi:quotas | Kimi Code quotas only | | /tokens | Cross-session token/cost usage | | /quotas:settings | Toggle individual features on or off |

Features

Quota dashboard

Run /quotas to open a bordered TUI view showing all providers side by side, with progress bars, used/remaining counts, and reset times. Press r to refresh, q or Esc to close.

Footer status widget

When your active model is from a supported provider, the Pi footer shows real-time quota headroom - updated every 60 seconds and on each turn. Colours shift from green → amber → red as usage climbs.

Quota warnings

Automatic notifications when projected usage is on track to exceed limits before the window resets. Warnings escalate from warning → high → critical based on your consumption pace.

Per-feature toggles

Use /quotas:settings to enable or disable:

• Combined /quotas command
• Per-provider commands (/anthropic:quotas, /codex:quotas, /github:quotas, /openrouter:quotas, /synthetic:quotas, /zai:quotas, /opencode-go:quotas, /kimi:quotas)
• Footer status widget
• Quota warning notifications
• Defer to Synthetic — when both pi-quotas and pi-synthetic are loaded, pi-quotas hides its own Synthetic footer to avoid showing duplicate quota information. Enabled by default; disable if you prefer to see both footers.

Settings can be saved globally (~/.pi/agent/extensions/quotas.json) or per-project (.pi/quotas.json). Run /reload after changing command visibility.

Supported providers

| Provider | Windows | Details | | -------------- | -------------------------------------------------------------- | --------------------------------------------------------------------------------------------------- | | Anthropic | 5h, 7d, per-model 7d, extra usage | Utilization percentages; optional overage budget in local currency | | OpenAI Codex | 5h, 7d, credits, spend cap | Rate-limit percentages; credit balance; spend-cap reached/OK | | GitHub Copilot | Premium/chat/completions per month | Remaining/entitlement counts with overage indicators | | OpenRouter | Monthly budget, daily/weekly/monthly usage | USD spending tracking with cents precision; optional per-key budget limits; UTC-based period resets | | Synthetic | Subscription, search/hour, free tools, weekly tokens, 5h limit | Request counts and token budgets; rolling five-hour rate limit; weekly token regen | | Z.ai | 5h, 7d, monthly web searches | Token utilisation percentages (rolling 5h/7d windows); monthly web-search count limit | | OpenCode Go | Rolling 5h, weekly, monthly USD | USD spend tracking against tier limits; cross-session token/cost aggregation via the /tokens command | | Kimi Code | Rolling 5h, weekly | Coding Plan request allowances with reset times |

Credentials

pi-quotas reads existing Pi auth entries from ~/.pi/agent/auth.json:

• anthropic — Anthropic OAuth token
• openai-codex — Codex access token (also reads ~/.codex/auth.json for the account ID)
• github-copilot — GitHub Copilot OAuth token (falls back to gh auth token if needed)
• openrouter — OpenRouter API key (Bearer token)
• synthetic — Synthetic API key (set the SYNTHETIC_API_KEY environment variable)
• zai — Z.ai (Zhipu AI / GLM Coding Plan) API key
• opencode-go — OpenCode Go workspace ID and auth cookie (set the OPENCODE_GO_WORKSPACE_ID and OPENCODE_GO_AUTH_COOKIE environment variables, or configure them in the OpenCode Go config file)
• kimi-coding — Kimi Code OAuth access token

No additional setup is required - if Pi can use the provider, pi-quotas can check its quotas. For Synthetic, export SYNTHETIC_API_KEY in your shell or Pi environment.

Requirements

• Pi >= 0.61.0

Changelog

See CHANGELOG.md for release notes and recent changes.

License

MIT © Latent Minds Pty Ltd

Acknowledgements

This project was inspired by @aliou/pi-synthetic.