云服务部-叶林立andDevin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
e996f59469
仓库规则要求 config/ 为唯一配置来源、不以环境变量作持久默认值： - pi-notify 改读 config/pi-notify.json（逐字段校验回退，复用原 parsers 钳制） - pi-minimal-footer 改读 config/pi-minimal-footer.json - pi-chrome 移除 PI_CHROME_BRIDGE_HOST/PORT，固定 127.0.0.1:17318 （浏览器端 service_worker.js 硬编码同一地址，单侧可配只会断连） Generated with [Devin](https://devin.ai) Co-Authored-By: Devin <158243242+devin-ai-integration[bot]@users.noreply.github.com>
pi-minimal-footer
Minimal footer for pi that replaces the default footer with a compact two-line display: context gauge on top, subscription usage bars below.
Features
- Context gauge — optional working directory and git branch, model, thinking level, and context window usage with token counts
- Subscription usage bars — rolling window quotas with reset timers for supported providers
- Auto-refresh — fetches usage on startup and model switch, then every 5 minutes
- Git integration — branch name, dirty state, ahead/behind counts
- Extension statuses — preserves statuses published through
ctx.ui.setStatus()
Supported providers
| Provider | What it shows |
|---|---|
| Claude Max | 5h + weekly rolling windows |
| OpenAI Codex | Primary + secondary rolling windows |
| GitHub Copilot | Premium interactions + chat quotas |
| Google Gemini | Pro + Flash remaining quotas |
| MiniMax | 5h + weekly rolling windows (Token Plan, credit-based) |
| MiniMax CN | Same as MiniMax, China endpoint |
| Kimi Coding | 5h + weekly rolling windows (Plan) |
Install
pi install npm:@ogulcancelik/pi-minimal-footer
Configuration
Persistent defaults are read from config/pi-minimal-footer.json inside the installed bundle; a missing or invalid file falls back to the defaults shown:
| Field | Description | Default |
|---|---|---|
showCwd |
Show current working directory in footer status line | true |
showBranch |
Show git branch/dirty/ahead/behind in footer status line | true |
Only true/false values are honoured; anything else falls back to the default for that field.
How it works
The footer reads effective context usage from the read-only pi-compaction service so its gauge matches provider projection and compaction decisions. Before the first projection snapshot exists it safely falls back to the last assistant message's token counts. Subscription usage is fetched from each provider's dedicated quota API using your existing auth tokens from ~/.pi/agent/auth.json or environment variables.
Usage is fetched:
- Once on startup
- Immediately on model switch (Ctrl+P)
- Every 5 minutes after that
Git state is refreshed:
- Once on startup
- When pi reports a branch change
- At the end of each turn
The footer adapts to narrow terminals by stacking lines vertically instead of the single-line wide layout.
Known issues
Claude Max usage bar not showing
Anthropic's OAuth usage endpoint (/api/oauth/usage) has been returning persistent 429 (rate limit) errors since late March 2026, affecting all third-party tools that display Claude usage data (CodexBar, oh-my-claudecode, claude-pulse, etc.). This is an Anthropic-side issue — tracked in claude-code#30930 and claude-code#31021. The usage bar will start working again once Anthropic fixes the endpoint.
Notes
- Replaces the default pi footer entirely via
ctx.ui.setFooter() - The local
my-piversion readsfooterData.getExtensionStatuses()and renders each non-empty status as a plain footer segment. - Auth tokens are read from
~/.pi/agent/auth.json(populated by/login) or standard env vars (ANTHROPIC_API_KEY,MINIMAX_API_KEY, etc.) - Providers without auth simply don't show a usage bar — no errors