pi-codex-usage-remaining

Display Codex usage in Pi's footer

Packages

Package details

extension

Install pi-codex-usage-remaining from npm and Pi will load the resources declared by the package manifest.

npm report

$ pi install npm:pi-codex-usage-remaining

Package: pi-codex-usage-remaining
Version: 0.1.1
Published: Oct 7, 2026
Downloads: 363/mo · 17/wk
Author: fran-chiarino
License: unknown
Types: extension
Size: 41 KB
Dependencies: 0 dependencies · 1 peer

Pi manifest JSON

{
  "image": "https://unpkg.com/pi-codex-usage-remaining/pi-codex-usage.png",
  "extensions": [
    "./extensions/codex-usage.ts"
  ]
}

Security note

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

README

Pi Codex Usage

A Pi extension that displays your Codex usage—like Codex does—with the remaining usage for each limit window and its reset time or date. It fits seamlessly into Pi's footer without disrupting your workflow.

The footer refreshes at session start and every five minutes. It uses the Codex account already configured in Pi; sign in to the openai-codex provider to see usage.

Install

pi install npm:pi-codex-usage

For local development:

pi -e /path/to/pi-codex-usage/extensions/codex-usage.ts

Display

Usage is shown as the remaining percentage for each window, followed by its reset time (for resets within 24 hours) or date. For example:

5h 82% 14:30 • Weekly 64% 12 Oct

If Codex usage cannot be retrieved, the footer displays Codex usage unavailable.

Publish

npm login
npm publish

The package name may need to be changed if pi-codex-usage is already taken on npm. Choose and add a license before publishing.