pi-chatgpt-limit

Show ChatGPT Codex subscription usage in pi's footer

Packages

Package details

extension

Install pi-chatgpt-limit from npm and Pi will load the resources declared by the package manifest.

npm repohome report
$ pi install npm:pi-chatgpt-limit
Package
pi-chatgpt-limit
Version
0.3.1
Published
May 26, 2026
Downloads
655/mo · 70/wk
Author
patlux
License
MIT
Types
extension
Size
28.3 KB
Dependencies
0 dependencies · 1 peer
Pi manifest JSON
{
  "extensions": [
    "./index.js"
  ],
  "image": "https://github.com/patlux/pi-chatgpt-limit/releases/download/preview-assets/footer-preview.png"
}

Security note

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

README

pi-chatgpt-limit

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.

Preview

Footer preview

Footer display variants and color thresholds:

Footer display variants and color thresholds

Install

pi install npm:pi-chatgpt-limit

Or shorthand:

pi install pi-chatgpt-limit

Then reload pi:

/reload

Usage

The footer percentage appears only while using an openai-codex model authenticated via pi's /login flow.

For details, run:

/chatgpt-limit

This shows:

  • plan
  • account email when available
  • 5-hour usage window
  • weekly usage window
  • reset times

Footer configuration

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% · ~2d
  • W 58% left
  • W 58% left · ~2d
  • 5h 25% / W 42%

Settings persist globally in ~/.pi/agent/chatgpt-limit.json, so the same footer preference applies across pi sessions.

Notes

This extension calls ChatGPT's usage endpoint:

GET https://chatgpt.com/backend-api/wham/usage

It 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.

Contributing

See CONTRIBUTING.md for development setup, PR expectations, and commit message guidance.

Release

See RELEASE.md for the release checklist, GitHub release publishing, npm verification, and announcement steps.

License

MIT