A pi extension that shows your ChatGPT Codex subscription usage inline in the footer.
It displays configurable ChatGPT Pro/Codex usage next to the active Codex model, and provides a command for detailed 5-hour and weekly usage windows.
Footer display variants and color thresholds:
pi install npm:pi-chatgpt-limitOr shorthand:
pi install pi-chatgpt-limitThen reload pi:
/reloadThe footer percentage appears only while using an openai-codex model authenticated via pi's /login flow.
For details, run:
/chatgpt-limitThis shows:
- plan
- account email when available
- 5-hour usage window
- weekly usage window
- reset times
The /chatgpt-limit menu also configures the footer display:
- show weekly usage (default), 5-hour usage, both, or hide usage
- show used percent, used percent with reset, remaining percent, or remaining percent with reset
- reset footer settings to defaults
Examples:
W 42%W 42% · ~2dW 58% leftW 58% left · ~2d5h 25% / W 42%
Settings persist globally in ~/.pi/agent/chatgpt-limit.json, so the same footer preference applies across pi sessions.
This extension calls ChatGPT's usage endpoint:
GET https://chatgpt.com/backend-api/wham/usageIt uses the OAuth token already stored by pi for the active openai-codex provider.
Extensions run with local user permissions and can access pi auth storage. Review extensions before installing them.
See CONTRIBUTING.md for development setup, PR expectations, and commit message guidance.
See RELEASE.md for the release checklist, GitHub release publishing, npm verification, and announcement steps.
MIT