@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.13
Published
Jul 12, 2026
Downloads
266/mo · 133/wk
Author
calesennett
License
MIT
Types
extension
Size
237.2 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 7-day usage.

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:

  • /codex-usage-mode left → Codex 7d:97% left (↺6d22h)
  • /codex-usage-mode used → Codex 7d:3% used (↺6d22h)