pi-codex-usage

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)