pi-codex-usage

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

Install

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

Command	Effect
`/codex-usage`	Toggle the footer status on/off.
`/codex-usage on`	Show the footer status and resume refreshes.
`/codex-usage off`	Hide the footer status and pause refreshes.
`/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.

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

{
  "pi-codex-usage": {
    "enabled": true,
    "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: enabled: true, usageMode: "left", refreshWindow: "7d"

Example outputs: