mirror of
https://bitbucket.org/siakitem/my-pi.git
synced 2026-10-26 10:45:22 +00:00
云服务部-叶林立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>
76 lines
3.8 KiB
Markdown
76 lines
3.8 KiB
Markdown
# pi-minimal-footer
|
|
|
|
Minimal footer for [pi](https://github.com/earendil-works/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
|
|
|
|
```bash
|
|
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](https://github.com/anthropics/claude-code/issues/30930) and [claude-code#31021](https://github.com/anthropics/claude-code/issues/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-pi` version reads `footerData.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
|