Use quota to see how much of your current AI subscription allowance remains without leaving Pi.
It shows the active provider's usage and reset time in Pi's status area when available.
Start
Install or update through Installation, then restart Pi after rebuilding.
Nothing needs invoking for the compact status view in interactive Pi.
Run /quota to show or hide the detailed usage widget.
/quota
Quota follows your selected model provider.
It supports Anthropic, Klaus, OpenAI Codex, GitHub Copilot, Gemini, MiniMax, Zai, and Kimi when Pi has credentials for that provider.
Codex quota uses only Pi's active-session token; identity is read from that token, never from Codex CLI auth files.
No row is shown when the provider has no configured auth or no usage result is available.
If a refresh fails after a successful fetch, the last fetched usage may remain visible.
Refreshing
Pi refreshes visible quota periodically and when you select a model.
The default refresh interval is five minutes.
Change quota.refreshIntervalMs only when you need a different polling interval.
<img src="assets/banner.svg" alt="quota" height="70">
# quota
Use quota to see how much of your current AI subscription allowance remains without leaving Pi.
It shows the active provider's usage and reset time in Pi's status area when available.
## Start
Install or update through [Installation](../../README.md#install), then restart Pi after rebuilding.
Nothing needs invoking for the compact status view in interactive Pi.
Run `/quota` to show or hide the detailed usage widget.
```
/quota
```
Quota follows your selected model provider.
It supports Anthropic, Klaus, OpenAI Codex, GitHub Copilot, Gemini, MiniMax, Zai, and Kimi when Pi has credentials for that provider.
Codex quota uses only Pi's active-session token; identity is read from that token, never from Codex CLI auth files.
No row is shown when the provider has no configured auth or no usage result is available.
If a refresh fails after a successful fetch, the last fetched usage may remain visible.
## Refreshing
Pi refreshes visible quota periodically and when you select a model.
The default refresh interval is five minutes.
Change `quota.refreshIntervalMs` only when you need a different polling interval.
## Reference
<!-- config:start -->
### Commands
| Command | Purpose |
| --- | --- |
| `/quota` | Show/hide subscription quota usage |
### Setting names
| Setting | Environment |
| --- | --- |
| `quota.refreshIntervalMs` | `PI_QUOTA_REFRESH_INTERVAL_MS` |
<!-- config:end -->
[Changelog](./CHANGELOG.md).
