@calesennett/pi-codex-usage

Codex usage footer extension for pi

Packages

Package details

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.14
Published
Aug 26, 2026
Downloads
352/mo · 22/wk
Author
calesennett
License
MIT
Types
extension
Size
237.8 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 the available Codex 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.
/codex-usage-mode used Show percent used.

Settings

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

{
  "pi-codex-usage": {
    "usageMode": "left"
  }
}
  • Settings file path: $PI_CODING_AGENT_DIR/settings.json
  • Fallback when the environment variable is unset: ~/.pi/agent/settings.json
  • The default is usageMode: "left".

Example outputs:

  • A response with only a primary window → Codex 7d:97% left (↺6d22h)
  • A response with a secondary window → Codex 5h:81% left (↺2h10m) 7d:64% left (↺6d22h)