@calesennett/pi-codex-usage
v0.1.11
Published
Codex usage footer extension for pi
Maintainers
Readme
pi-codex-usage

Footer status extension for pi that shows Codex (and Codex Spark) usage windows.
Install
pi install npm:@calesennett/pi-codex-usageCommands
| 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)
