云服务部-叶林立
879fc5d37f
把 12 份 UPSTREAM.md 来源记录全部翻译为中文，并把中文定为这份仓库自有 维护文档的强制语言。 - 翻译 hippo-memory-pi、pi-ask-user、pi-chrome、pi-compaction、 pi-extension-codex-fast-mode、pi-minimal-footer、pi-notify、 pi-permission-system/docs/auto-review、pi-ssh、pi-subagents 与 pi-tool-search 的来源记录。 - 在 AGENTS.md 增加纪律：每个自维护扩展目录必须保留中文 UPSTREAM.md， 内容涵盖官方仓库、tag/commit、导入版本、导入日期、许可证归属、本地 改动清单与同步上游时的约束。 - 明确边界：UPSTREAM.md 属于仓库自有的维护文档，因此使用中文；上游自带 的源码、测试、文档、README、CHANGELOG 与 LICENSE 一律保持原文，不翻 译、不改写，避免同步上游时产生无意义 diff 并破坏许可证原文完整性。 - 所有 40 位 commit、tag/版本号、仓库 URL 与许可证路径原样保留，仅翻译 叙述性文字。 验证：12 份文件均无残留英文正文；逐份复核了 commit、版本、URL 与 LICENSES/ 路径未发生改变。
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()and showsFast onwhile Codex Fast mode is enabled
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
Environment variables (all optional):
| Variable | Description | Default |
|---|---|---|
PI_MINIMAL_FOOTER_SHOW_CWD |
Show current working directory in footer status line | 1 |
PI_MINIMAL_FOOTER_SHOW_BRANCH |
Show git branch/dirty/ahead/behind in footer status line | 1 |
Accepted false values: 0, false, no, off (case-insensitive).
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();codex-fast-mode=onis rendered as an accentedFast onsegment, while the disabled state is hidden. - 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