pi-dynamic-footer

Dynamic, configurable footer for pi with live observability. Replaces the default footer with a multi-line display showing context usage, TPS, token/cost tracking, subscription quota bars, git status, and more.

Features

• Context gauge — current / max tokens with color-coded usage bar (green → yellow → red)
• Live TPS — tokens-per-second during streaming, plus last-turn average
• Token tracking — per-turn ↑input / ↓output counts, total session cost
• Cache ratio — cache hit percentage
• Git status — branch name, dirty state, added/removed lines
• Subscription usage bars — rolling window quotas with reset timers for 8 provider types
• Fast mode indicator — shows when priority/fast service tier is active
• Thinking level — displays current thinking mode (off/minimal/medium/high/xhigh)
• Labeled segments — each data point has a compact label
• Settings UI — /obs-settings command to toggle segments, configure zones, load presets
• Dashboard — /obs command for full observability dashboard + last 10 sessions
• Toggle — /obs-toggle to show/hide the footer

Install

pi install npm:@juanbenjumea/pi-dynamic-footer

Commands

| Command | Description | |---|---| | /obs | Full observability dashboard + last 10 session summaries | | /obs-toggle | Show/hide the dynamic footer | | /obs-settings | Open footer settings UI (segment toggles, zones, presets) |

Supported Providers (quota bars)

| Provider | Auth source | Windows | |---|---|---| | Claude / Claude Max | auth.json (anthropic) or macOS keychain | 5h, Week, Month | | OpenAI Codex | auth.json (openai-codex) or ~/.codex/auth.json | 5h, Week, Month | | OpenCode Go | auth.json (quota-status.opencode-go or opencode-go-failover) | 5h, Week, Month | | ClinePass | auth.json (cline-pass) or CLINE_API_KEY env | 5h, Week, Month | | Umans | auth.json (umans) or UMANS_API_KEY env | Requests, Concurrency | | GitHub Copilot | auth.json (github-copilot) | Premium, Chat | | Google Gemini | auth.json (google-gemini-cli) or ~/.gemini/oauth_creds.json | Pro, Flash | | Kimi Coding | auth.json (kimi-coding) or KIMI_API_KEY env | Windows, Week |

For multi-account OpenCode Go rotation, install @juanbenjumea/pi-multi-opencode-go alongside this footer. Usage parsing uses @juanbenjumea/opencode-go-usage (v0.1.4+).

Configuration

Footer segments

Use /obs-settings to toggle individual segments:

| Segment | Shows | |---|---| | modelThink | Model ID + thinking level | | runtime | Session duration | | pwd | Current working directory | | git | Branch, dirty state, ± lines | | contextUsage | Color-coded context usage bar | | contextProgress | Context progress bar | | contextPercentage | Context percentage | | contextNumbers | Verbatim token counts | | tokens | Total ↑input / ↓output tokens | | tps | Live or last-turn tokens/sec | | cost | Total session cost | | cache | Cache hit ratio | | turnCount | Current turn number | | usageBars | Subscription quota usage bars |

Context zones

Set the warning (yellow) and expert (red) thresholds in /obs-settings:

Warning zone:  70% (default)
Expert zone:   90% (default)

Presets

| Preset | Description | |---|---| | all | Every segment enabled | | minimal | Model + context percentage only | | developer | Full stack: model, TPS, context, tokens, cost, cache, git, quota | | ops | Runtime, git, cost, quota bars |

Environment variables

| Variable | Description | Default | |---|---|---| | PI_OBS_SHOW_FULL_PATH | Show full cwd path instead of basename | off |

How it works

The extension hooks into pi's event system:

• session_start — initializes state, fetches quota, sets footer
• turn_start / message_update / turn_end — tracks TPS, token counts, cost
• model_select — refreshes quota display on model switch
• session_shutdown — persists last 10 session summaries

Token counts come from the assistant message's usage object (free with every LLM response). Quota data is fetched from each provider's dedicated API using credentials from ~/.pi/agent/auth.json or environment variables.

Security and privacy

• Tokens are read only to request usage data and remain in memory; they are never written to the footer's settings or history files, displayed, or logged.
• Authenticated requests use the provider's fixed HTTPS API endpoint. Redirects are rejected and responses are size-limited.
• The footer stores only the last ten local session summaries (cwd, branch, model, token totals, cost, and runtime) under ~/.pi/agent/observability/. On POSIX systems, the directory is mode 0700 and its data files are mode 0600.
• Auth values beginning with ! are intentionally ignored: this package never executes shell commands from auth.json. Supply a resolved credential through the provider's environment variable instead.

Notes

• Auth tokens are read from ~/.pi/agent/auth.json (populated by pi's /login command)
• Providers without configured auth simply don't show usage bars — no errors
• The footer is set via ctx.ui.setFooter() and replaces pi's default footer entirely

License

MIT