@calesennett/pi-codex-usage

Codex usage footer extension for pi

Package details

← Back
extension

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

npm repohome report
$ pi install npm:@calesennett/pi-codex-usage
Package
@calesennett/pi-codex-usage
Version
0.1.11
Published
Feb 28, 2026
Downloads
312/mo · 86/wk
Author
calesennett
License
MIT
Types
extension
Size
244 KB
Dependencies
0 dependencies · 0 peers

Security note

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

README

pi-codex-usage

pi-codex-usage screenshot

Footer status extension for pi that shows Codex (and Codex Spark) usage windows.

Install

pi install npm:@calesennett/pi-codex-usage

Commands

Command Effect
/codex-usage-mode Toggle display mode (left ↔ used).
/codex-usage-mode left Show percent left in each window.
/codex-usage-mode used Show percent used in each window.
/codex-usage-reset-window Toggle reset countdown window (7d ↔ 5h).
/codex-usage-reset-window 7d Show reset countdown for the 7d window.
/codex-usage-reset-window 5h Show reset countdown for the 5h window.

Settings

The extension persists display preferences in pi's settings.json under:

{
  "pi-codex-usage": {
    "usageMode": "left",
    "refreshWindow": "7d"
  }
}
  • Settings file path: $PI_CODING_AGENT_DIR/settings.json
  • Fallback when env var is unset: ~/.pi/agent/settings.json
  • Defaults are written on first load: usageMode: "left", refreshWindow: "7d"

Example outputs:

  • /codex-usage-mode left → Codex 5h:81% left 7d:64% left (7d:↺22h28m)
  • /codex-usage-mode used → Codex 5h:19% used 7d:36% used (7d:↺22h28m)