@kmiyh/pi-codex-plan-limits

Pi extension that shows live Codex plan usage: remaining 5h and weekly limits, reset times, and cached fallback snapshots.

Package details

extension

Install @kmiyh/pi-codex-plan-limits from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@kmiyh/pi-codex-plan-limits

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

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

@kmiyh/pi-codex-plan-limits is a Pi extension that shows your OpenAI Codex subscription limits in Pi's footer.

It replaces the less useful subscription footer segment with:

pi install npm:@kmiyh/pi-codex-plan-limits

When Pi is using:

the extension modifies the footer and shows Codex plan limits.

If Pi is using any other model, or openai-codex without subscription auth, the extension disables itself and the default Pi footer is restored.

The extension uses Pi's own auth session for openai-codex and fetches usage from OpenAI's backend:

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

It does not depend on a separate Codex CLI login and does not read ~/.codex/sessions.

If a live refresh fails, it keeps the last successful snapshot fetched through Pi.

The limits are refreshed:

Event-driven refreshes are throttled to avoid excessive requests.

npm install
npm run typecheck

For testing:

pi -e ./src/index.ts

MIT