rinco-pi-hud 1.6.0 → 1.6.1

package/README.md

@@ -26,7 +26,7 @@ Requires Pi **1.3.0 or newer within the 1.x release line**. Development and CI d
 pi install npm:rinco-pi-hud
 ```
 
-Restart Pi afterwards, or run `/reload`. The footer is enabled by default and `/zentui` opens the settings UI.
+Restart Pi afterwards, or run `/reload`. The footer is enabled by default and `/hud` opens the settings UI.
 
 From GitHub, or from a local checkout:
 
@@ -44,32 +44,32 @@ pi install "$PWD"
 > Pi extensions run with your user permissions. Review the source before installing any third-party extension.
 
 > [!NOTE]
-> Truecolor and 256-color terminals are supported; explicit RGB colors use Pi's terminal-capability-aware encoder. The screenshot above renders with ASCII icon mode; `/zentui` switches between the `auto`, `nerd`, and `ascii` glyph sets.
+> Truecolor and 256-color terminals are supported; explicit RGB colors use Pi's terminal-capability-aware encoder. The screenshot above renders with ASCII icon mode; `/hud` switches between the `auto`, `nerd`, and `ascii` glyph sets.
 
 ## Commands
 
 | Command | Effect |
 | --- | --- |
-| `/zentui` | Settings UI: rows, segments, separator, icons, colors, templates |
-| `/zentui statusline enable\|disable\|toggle` | Show or hide the whole footer |
-| `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | Turn one row on or off |
-| `/zentui format "<template>"` | Replace the four rows with a single-line template |
-| `/zentui compact-format "<template>"` | Opt into a wrapped template below 80 columns; `clear` removes it |
-| `/zentui footer hud\|hidden\|native` | Four-group/template HUD, statuses only, or Pi’s native footer |
-| `/zentui layout\|segments\|extensions` | Open a settings section directly |
+| `/hud` | Settings UI: rows, segments, separator, icons, colors, templates |
+| `/hud statusline enable\|disable\|toggle` | Show or hide the whole footer |
+| `/hud row project\|session\|activity\|usage <enable\|disable\|toggle>` | Turn one row on or off |
+| `/hud format "<template>"` | Replace the four rows with a single-line template |
+| `/hud compact-format "<template>"` | Opt into a wrapped template below 80 columns; `clear` removes it |
+| `/hud footer hud\|hidden\|native` | Four-group/template HUD, statuses only, or Pi’s native footer |
+| `/hud layout\|segments\|extensions` | Open a settings section directly |
 | `/codex-status` | Print Codex subscription usage and rate-limit windows |
 | `/usage-refresh` | Refresh the model usage or balance shown in the footer |
 
 ## What it shows
 
-| Row | Segments, each with its own switch under **Built-in segments** in `/zentui` |
+| Row | Segments, each with its own switch under **Built-in segments** in `/hud` |
 | --- | --- |
 | **Project** | directory, git branch, commit and tag, working-tree status, operation state (`MERGING`, `REBASING`, …), diff metrics, runtime, package version, OS, user |
-| **Session** | session name, provider and model, thinking level, turn count, duration |
-| **Activity** | running tools, completed tool counts, active agents, `Agent idle`, skills, MCP servers |
-| **Usage** | context window with a gauge, input and output tokens, cache read/write volume and hit rate, cost, model quota, clock |
+| **Session** | session name, provider and model, thinking level, turn count, duration, clock |
+| **Activity** | running tools, completed tool counts, skills, MCP servers |
+| **Usage** | context window with a gauge, input and output tokens, cache read/write volume and hit rate, cost, model quota |
 
-Rows are toggled with `/zentui row usage disable`; the segments inside them have individual switches in the same UI. Existing configs that used the former aggregate `tokens`, `toolActivity`, or `agentActivity` switches are migrated automatically.
+Rows are toggled with `/hud row usage disable`; the segments inside them have individual switches in the same UI. Existing configs that used the former aggregate `tokens` or `toolActivity` switches are migrated automatically.
 
 ### Model quota
 
@@ -92,16 +92,18 @@ Groups wrap only at segment boundaries. A continuation line realigns under the s
 Set a template for a single-line footer instead of the four groups:
 
 ```text
-/zentui format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
+/hud format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
 ```
 
-Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) lists all of them, along with the aliases (`$directory`, `$status`, `$codex`, …). Run `/zentui format` with no argument, or `/zentui format clear`, to go back to the four groups.
+Variables accept `$name` or `${name}`. The [footer reference](docs/footer.md) lists all of them, along with the aliases (`$directory`, `$status`, `$codex`, …). Run `/hud format` with no argument, or `/hud format clear`, to go back to the four groups.
 
 ## Configuration
 
-`/zentui` writes to `~/.pi/agent/rinco-pi-hud.json` and applies changes immediately. It covers the separator style, icon mode (`nerd`, `ascii`, or `auto`), footer colors (Pi theme tokens or terminal palette styles), context rendering (text, gauge, or both), the project refresh interval, and third-party extension statuses with their own placement and color mode.
+The HUD uses `/hud`; `/zentui` is reserved for the original Zentui package. There is no legacy command alias. See [Using with Zentui](docs/footer.md#using-with-the-original-zentui) for component separation.
 
-Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/zentui`, **Footer colors → theme** enables this behavior; **terminal** keeps the original Sakura RGB palette. Explicit custom colors (hex, indexed, or `fg:`/`bg:` styles) remain fixed in either mode. Remove those entries from `colors` to restore automatic theme colors.
+`/hud` writes to `~/.pi/agent/rinco-pi-hud.json` and applies changes immediately. It covers the separator style, icon mode (`nerd`, `ascii`, or `auto`), footer colors (Pi theme tokens or terminal palette styles), context rendering (text, gauge, or both), the project refresh interval, and third-party extension statuses with their own placement and color mode.
+
+Footer colors follow the active Pi theme by default, including theme switches and automatic light/dark changes. In `/hud`, **Footer colors → theme** enables this behavior; **terminal** keeps the original Sakura RGB palette. Explicit custom colors (hex, indexed, or `fg:`/`bg:` styles) remain fixed in either mode. Remove those entries from `colors` to restore automatic theme colors.
 
 Footer features are adapted from Zentui **0.32.0**, without installing its editor, messages, working line, tool display, or OMP adapter. New opt-in features include repository-relative paths, `$join_sep`, compact templates, extension-published values, safe status hyperlinks, PR/CI metadata, and average token rate. Defaults and existing configurations remain unchanged. See [docs/upstream-zentui.md](docs/upstream-zentui.md) for the exact snapshot and integration boundaries, and [docs/footer.md](docs/footer.md) for configuration and examples.
 
@@ -116,11 +118,11 @@ Footer features are adapted from Zentui **0.32.0**, without installing its edito
 | [`extensions/hud/telemetry/`](extensions/hud/telemetry/format.ts) | Usage formatting, provider balance probes, and the Codex subscription client |
 | [`extensions/hud/session/`](extensions/hud/session/) | Pi event registration, session lifecycle, and live context overlay |
 | [`extensions/hud/state/`](extensions/hud/state/) | Aggregated state, telemetry reducer, and project refresh controller |
-| [`extensions/hud/commands/`](extensions/hud/commands/settings.ts) | `/zentui` settings UI and configuration controller |
+| [`extensions/hud/commands/`](extensions/hud/commands/settings.ts) | `/hud` settings UI and configuration controller |
 | [`extensions/hud/ui/`](extensions/hud/ui/) | Icons and terminal style utilities |
 | [`docs/footer.md`](docs/footer.md) | Complete footer configuration reference |
 | [`docs/CONTRIBUTING.md`](docs/CONTRIBUTING.md) | Local development, testing guidance, and pull request checklist |
-| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP configuration counts |
+| [`tests/`](tests/) | Vitest suite: footer layout, telemetry, provider balances, MCP runtime tool counts |
 
 ## Development
 
@@ -155,19 +157,19 @@ Confirm Pi is running in TUI mode rather than headless, JSON, or print mode. The
 <details>
 <summary>The layout looks wrong in a narrow terminal</summary>
 
-The footer measures the terminal and wraps at segment boundaries, so narrow windows show fewer segments per line. Set a `footerFormat` template, or disable low-priority segments in `/zentui`.
+The footer measures the terminal and wraps at segment boundaries, so narrow windows show fewer segments per line. Set a `footerFormat` template, or disable low-priority segments in `/hud`.
 </details>
 
 <details>
 <summary>Colors look incorrect</summary>
 
-The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/zentui` and remove explicit color overrides from `~/.pi/agent/rinco-pi-hud.json`. Third-party statuses set to `original` retain their own colors. Truecolor and 256-color output follow Pi's detected terminal capabilities.
+The default palette follows the active Pi theme. If the footer still uses fixed colors, select **Footer colors → theme** in `/hud` and remove explicit color overrides from `~/.pi/agent/rinco-pi-hud.json`. Third-party statuses set to `original` retain their own colors. Truecolor and 256-color output follow Pi's detected terminal capabilities.
 </details>
 
 <details>
 <summary>Icons are missing or misaligned</summary>
 
-Unicode and Nerd Font glyphs vary between terminals and fonts. Install a Nerd Font, or switch to ASCII icons in `/zentui`.
+Unicode and Nerd Font glyphs vary between terminals and fonts. Install a Nerd Font, or switch to ASCII icons in `/hud`.
 </details>
 
 ## License

package/assets/readme/hero.svg

@@ -15,7 +15,7 @@
 
     <text x="80" y="260" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">via</tspan><tspan> </tspan><tspan fill="#AEE5C5" font-weight="700">node v24.18.0</tspan><tspan fill="#716879"> › </tspan><tspan fill="#f7eef8">linux</tspan></text>
     <text x="80" y="290" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
-    <text x="80" y="320" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
+    <text x="80" y="320" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan></text>
     <text x="80" y="350" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
 </svg>

package/assets/readme/responsive.svg

@@ -14,14 +14,14 @@
     <line x1="194" y1="160" x2="194" y2="334" stroke="#716879" stroke-dasharray="3 5" opacity="0.55"/>
     <text x="80" y="190" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">via</tspan><tspan> </tspan><tspan fill="#AEE5C5" font-weight="700">node v24.18.0</tspan><tspan fill="#716879"> › </tspan><tspan fill="#f7eef8">linux</tspan></text>
     <text x="80" y="220" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
-    <text x="80" y="250" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
+    <text x="80" y="250" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × 76</tspan></text>
     <text x="80" y="280" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan></text>
     <text x="80" y="310" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
   <g id="panel-56">
     <rect x="56" y="368" width="1088" height="298" rx="14" fill="#16131F" stroke="#2C2640"/>
     <text x="80" y="391" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">render(56)</text>
-    <text x="1120" y="391" text-anchor="end" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">8 rows · continuations align</text>
+    <text x="1120" y="391" text-anchor="end" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="18" fill="#A99BAE">7 rows · continuations align</text>
     <line x1="56" y1="402" x2="1144" y2="402" stroke="#2C2640"/>
     <line x1="194" y1="402" x2="194" y2="666" stroke="#716879" stroke-dasharray="3 5" opacity="0.55"/>
     <text x="80" y="432" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#f2a7c6" font-weight="700">Project</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#f2a7c6" font-weight="700">rinco-pi-hud</tspan><tspan fill="#716879"> › </tspan><tspan>on </tspan><tspan fill="#c7b8f5" font-weight="700">*</tspan><tspan> </tspan><tspan fill="#c7b8f5" font-weight="700">main</tspan></text>
@@ -29,8 +29,7 @@
     <text x="80" y="492" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#9fd3f2">Session</tspan><tspan> </tspan><tspan fill="#716879"> › </tspan><tspan fill="#9fd3f2">deepseek/deepseek-flash</tspan></text>
     <text x="80" y="522" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Thinking level: max</tspan><tspan fill="#716879"> › </tspan><tspan fill="#efc3e6">Turn 3</tspan></text>
     <text x="80" y="552" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#efc3e6">Activity</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">Tool read × 30 write × 7 edit × 13 bash × </tspan><tspan>…</tspan></text>
-    <text x="80" y="582" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">Agent idle</tspan></text>
-    <text x="80" y="612" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan></text>
-    <text x="80" y="642" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
+    <text x="80" y="582" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan> </tspan><tspan fill="#aee5c5">Usage</tspan><tspan>   </tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5">[##--------] 17%/1.0M</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↑ 177k</tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">↓ 74k</tspan></text>
+    <text x="80" y="612" font-family="ui-monospace, SFMono-Regular, Menlo, Consolas, 'Liberation Mono', monospace" font-size="20" xml:space="preserve"><tspan>         </tspan><tspan fill="#716879"> › </tspan><tspan fill="#a99bae">R 10M</tspan><tspan> </tspan><tspan fill="#aee5c5">CH 99.8%</tspan><tspan fill="#716879"> › </tspan><tspan fill="#aee5c5" font-weight="700">$ 0.204</tspan></text>
   </g>
 </svg>

package/docs/CONTRIBUTING.md

@@ -50,7 +50,8 @@ npm run pack:check
 
 Tests live in `tests/`:
 
-- `zentui-status.test.ts` — Config counts, MCP configuration counts, and extension status helpers.
+- `zentui-status.test.ts` — Config counts, telemetry, and skill activity.
+- `mcp-status.test.ts` — Pi runtime MCP namespaces, exposure filtering, and dynamic tool changes.
 - `mcp-footer.test.ts` — MCP count rendering, segment controls, custom formats, and legacy third-party statuses.
 - `codex-usage.test.ts` — Codex payload normalization and model-specific quota formatting.
 - `footer-layout.test.ts` — Four-group categorized layout, segment wrapping, and narrow-width budget.
@@ -103,7 +104,7 @@ Follow the configured conventions:
 The HUD extension is organized into functional modules under `extensions/hud/`:
 
 - **`index.ts`** — Composition root for controllers, shared state, and UI installation.
-- **`commands/`** — `/zentui` presentation and its configuration-persistence controller.
+- **`commands/`** — `/hud` presentation and its configuration-persistence controller.
 - **`config/`** — Configuration model, normalization, and persistence.
 - **`footer/`** — Footer rendering, semantic group construction, responsive layout, and templates.
 - **`segments/`** — State collectors: Git, runtime, MCP, skills, projects, etc.

package/docs/README.zh-CN.md

@@ -26,7 +26,7 @@ Rinco Pi HUD 用四组实时状态替换 Pi 的脚注行，不需要的部分都
 pi install npm:rinco-pi-hud
 ```
 
-装完重启 Pi，或执行 `/reload`。脚注默认启用，`/zentui` 打开设置界面。
+装完重启 Pi，或执行 `/reload`。脚注默认启用，`/hud` 打开设置界面。
 
 从 GitHub 或本地目录安装：
 
@@ -44,32 +44,32 @@ pi install "$PWD"
 > Pi 扩展以当前用户权限运行。安装任何第三方扩展前，请先审查其源码。
 
 > [!NOTE]
-> 支持 Truecolor 和 256 色终端；显式 RGB 颜色通过 Pi 的终端能力适配接口输出。上图用的是 ASCII 图标模式，`/zentui` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
+> 支持 Truecolor 和 256 色终端；显式 RGB 颜色通过 Pi 的终端能力适配接口输出。上图用的是 ASCII 图标模式，`/hud` 可以在 `auto`、`nerd`、`ascii` 三套符号之间切换。
 
 ## 命令
 
 | 命令 | 作用 |
 | --- | --- |
-| `/zentui` | 设置界面：行、状态段、分隔符、图标、颜色、模板 |
-| `/zentui statusline enable\|disable\|toggle` | 显示或隐藏整个脚注 |
-| `/zentui row project\|session\|activity\|usage <enable\|disable\|toggle>` | 开关某一行 |
-| `/zentui format "<template>"` | 用单行模板替换四行布局 |
-| `/zentui compact-format "<template>"` | 设置低于 80 列时使用的换行模板；`clear` 清除 |
-| `/zentui footer hud\|hidden\|native` | HUD、仅第三方状态、恢复 Pi 原生脚注 |
-| `/zentui layout\|segments\|extensions` | 直接打开对应设置页 |
+| `/hud` | 设置界面：行、状态段、分隔符、图标、颜色、模板 |
+| `/hud statusline enable\|disable\|toggle` | 显示或隐藏整个脚注 |
+| `/hud row project\|session\|activity\|usage <enable\|disable\|toggle>` | 开关某一行 |
+| `/hud format "<template>"` | 用单行模板替换四行布局 |
+| `/hud compact-format "<template>"` | 设置低于 80 列时使用的换行模板；`clear` 清除 |
+| `/hud footer hud\|hidden\|native` | HUD、仅第三方状态、恢复 Pi 原生脚注 |
+| `/hud layout\|segments\|extensions` | 直接打开对应设置页 |
 | `/codex-status` | 打印 Codex 订阅用量与限额窗口 |
 | `/usage-refresh` | 立即刷新脚注上的模型用量或余额 |
 
 ## 显示什么
 
-| 行 | 状态段。每段在 `/zentui` 的 **Built-in segments** 里都有独立开关 |
+| 行 | 状态段。每段在 `/hud` 的 **Built-in segments** 里都有独立开关 |
 | --- | --- |
 | **Project** | 目录、Git 分支、Commit 与 Tag、工作区状态、Git 操作状态（`MERGING`、`REBASING` 等）、差异指标、运行时、包版本、OS、用户 |
-| **Session** | 会话名称、Provider 与模型、Thinking 等级、轮次、会话时长 |
-| **Activity** | 正在运行的 Tool、已完成 Tool 计数、活跃 Agent、`Agent idle`、Skill、MCP Server |
-| **Usage** | Context 窗口与进度条、输入/输出 Token、缓存读写量与命中率、费用、模型限额、时间 |
+| **Session** | 会话名称、Provider 与模型、Thinking 等级、轮次、会话时长、时间 |
+| **Activity** | 正在运行的 Tool、已完成 Tool 计数、Skill、MCP Server |
+| **Usage** | Context 窗口与进度条、输入/输出 Token、缓存读写量与命中率、费用、模型限额 |
 
-行用 `/zentui row usage disable` 开关；行内每个状态段在同一界面里各有开关。使用旧版聚合开关 `tokens`、`toolActivity`、`agentActivity` 的配置会自动迁移。
+行用 `/hud row usage disable` 开关；行内每个状态段在同一界面里各有开关。使用旧版聚合开关 `tokens`、`toolActivity` 的配置会自动迁移。
 
 ### 模型限额
 
@@ -92,16 +92,18 @@ Usage 行跟随当前模型的 Provider：
 想换成单行脚注，设置模板即可：
 
 ```text
-/zentui format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
+/hud format "$cwd( $git_branch)$fill($context)( $tokens)( $cost)"
 ```
 
-变量可以写成 `$name` 或 `${name}`。[脚注参考](footer.md)列出了全部变量和别名（`$directory`、`$status`、`$codex` 等）。不带参数的 `/zentui format`（或 `/zentui format clear`）恢复四行分组布局。
+变量可以写成 `$name` 或 `${name}`。[脚注参考](footer.md)列出了全部变量和别名（`$directory`、`$status`、`$codex` 等）。不带参数的 `/hud format`（或 `/hud format clear`）恢复四行分组布局。
 
 ## 配置
 
-`/zentui` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
+本项目使用 `/hud`，把 `/zentui` 留给原版 Zentui，不保留旧命令别名。配置文件和现有设置不变。与原版搭配时，请将 Zentui 的 Footer 设为 Native，让本项目继续管理 HUD；详见[共存说明](footer.md#using-with-the-original-zentui)。
 
-脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/zentui` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
+`/hud` 把配置写入 `~/.pi/agent/rinco-pi-hud.json`，改动立即生效。可配置分隔符样式、图标模式（`nerd`、`ascii`、`auto`）、脚注配色（Pi 主题色或终端调色板样式）、Context 渲染方式（文本、进度条或两者）、项目刷新间隔，以及第三方扩展状态的位置与颜色模式。
+
+脚注默认自动跟随当前 Pi 主题，包括手动切换主题和自动明暗切换。在 `/hud` 中选择 **Footer colors → theme** 启用跟随，选择 **terminal** 则保留原有 Sakura RGB 配色。显式自定义颜色（十六进制、索引色或 `fg:`/`bg:` 样式）在两种模式下都会保留；删除 `colors` 中的相应配置即可恢复自动配色。
 
 已适配 Zentui **0.32.0** 的 Footer 新功能：仓库相对路径、`$join_sep` 条件分隔符、窄屏模板、扩展发布的自定义值、安全状态超链接，以及按需启用的 PR/CI 与平均 Token 速率。默认四行 HUD、原有配置及余额查询保持不变；不接管编辑器、消息、工作进度行或工具展示，也不引入 OMP 适配。同步快照和边界见[上游集成记录](upstream-zentui.md)，配置示例和完整变量参考见 [docs/footer.md](footer.md)。
 
@@ -116,11 +118,11 @@ Usage 行跟随当前模型的 Provider：
 | [`extensions/hud/telemetry/`](../extensions/hud/telemetry/format.ts) | 用量格式化、各家余额探测与 Codex 订阅客户端 |
 | [`extensions/hud/session/`](../extensions/hud/session/) | Pi 事件注册、会话生命周期与实时 Context 覆盖 |
 | [`extensions/hud/state/`](../extensions/hud/state/) | 聚合状态、Telemetry Reducer 与项目刷新 Controller |
-| [`extensions/hud/commands/`](../extensions/hud/commands/settings.ts) | `/zentui` 设置界面与配置 Controller |
+| [`extensions/hud/commands/`](../extensions/hud/commands/settings.ts) | `/hud` 设置界面与配置 Controller |
 | [`extensions/hud/ui/`](../extensions/hud/ui/) | 图标与终端样式工具 |
 | [`docs/footer.md`](footer.md) | 完整脚注配置参考 |
 | [`docs/CONTRIBUTING.md`](CONTRIBUTING.md) | 本地开发、测试规范和 PR 检查清单 |
-| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 配置计数 |
+| [`tests/`](../tests/) | Vitest 测试套件：脚注布局、遥测、各家余额与 MCP 运行时工具计数 |
 
 ## 开发
 
@@ -155,19 +157,19 @@ npx tsx assets/readme/source/build-assets.mts /tmp/footer.json
 <details>
 <summary>窄终端里布局看起来不对</summary>
 
-脚注会测量终端宽度，只在状态段边界换行，所以窗口越窄，每行容纳的状态段越少。可以设置 `footerFormat` 模板，或在 `/zentui` 中关闭低优先级状态段。
+脚注会测量终端宽度，只在状态段边界换行，所以窗口越窄，每行容纳的状态段越少。可以设置 `footerFormat` 模板，或在 `/hud` 中关闭低优先级状态段。
 </details>
 
 <details>
 <summary>颜色显示异常</summary>
 
-默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/zentui` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
+默认配色自动跟随当前 Pi 主题。如果脚注仍使用固定颜色，请在 `/hud` 中选择 **Footer colors → theme**，并删除 `~/.pi/agent/rinco-pi-hud.json` 中的显式颜色覆盖。设为 `original` 的第三方扩展状态会保留自己的颜色。Truecolor 与 256 色输出仍按 Pi 检测到的终端能力选择。
 </details>
 
 <details>
 <summary>图标缺失或错位</summary>
 
-Unicode 与 Nerd Font 符号的显示效果因终端和字体而异。建议安装 Nerd Font，或在 `/zentui` 中切换到 ASCII 图标。
+Unicode 与 Nerd Font 符号的显示效果因终端和字体而异。建议安装 Nerd Font，或在 `/hud` 中切换到 ASCII 图标。
 </details>
 
 ## 许可证

package/docs/footer.md

@@ -7,33 +7,49 @@ When `footerFormat` is empty, the HUD displays four semantic groups:
 ```text
 Project  · pi-sakura ·  main ·  24.18
 Session  · gpt-5.3 · Thinking level: high · Turn 8
-Activity · Agent idle · Skill 2/3 · MCP 2
+Activity · Tool read × 4 · Skill 2/3 · MCP 2
 Usage    · 35%/200k · ↑ 4.2k · ↓ 1.1k · $ 0.030
 ```
 
-The MCP segment counts server entries in Pi's agent-directory `mcp.json` and the project's `.pi/mcp.json`. Same-name entries count once; disabled entries are included. This is a raw file-entry count: differently spelled names such as `my-server` and `my_server` remain separate, even though Pi may reject them as a namespace collision. Zero entries hide the segment. Counts refresh with the project state polling interval. This does not report connection state, validate individual server settings, or include servers registered dynamically by extensions. Missing, unreadable, malformed, or larger-than-1-MiB files contribute no entries. Legacy adapter footer statuses remain ordinary third-party statuses.
+The MCP segment uses Pi's public `pi.getAllTools()` API to count unique MCP namespaces with non-hidden registered tools, including direct, codemode, and deferred exposure. It includes file-configured and dynamically registered servers without reading `mcp.json`, resolving credentials, or creating connections. Hidden tools left behind after disabling or removing a server do not count. The value is read on each footer render (including normal project refreshes); zero hides the segment. This is a runtime tool-availability count, not a connection-health or configured-server count: resource-only servers and servers with no exposed tools are omitted, and a disconnected server may retain registered tools. Use Pi's `/mcp` for full connection status. `pi.getMcpServers()` is not used because it only lists extension registrations, not all configured servers. Legacy adapter footer statuses remain ordinary third-party statuses.
 
 The category column is sized from visible text so every separator aligns. When a row exceeds the terminal width, complete status segments move to an indented continuation line. Only a single segment that is wider than the available content area is truncated. Third-party extension statuses appear on the Activity group in configured `left`, `middle`, then `right` order.
 
 Control each default-layout row independently:
 
 ```text
-/zentui row project enable
-/zentui row session disable
-/zentui row activity toggle
-/zentui row usage toggle
+/hud row project enable
+/hud row session disable
+/hud row activity toggle
+/hud row usage toggle
 ```
 
-The command shape is `/zentui row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
+The command shape is `/hud row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
+
+## Using with the original Zentui
+
+This package registers `/hud`, not `/zentui`. The original Zentui keeps `/zentui`;
+the HUD has no legacy alias and still uses `rinco-pi-hud.json`.
+
+To use Zentui's User messages, Working line, or Tool display alongside the HUD,
+set Zentui's `components.footer.style` to `"native"` in
+`~/.pi/agent/zentui.json`. Native releases Zentui's Footer ownership without
+removing another extension's footer. Keep this package's status line enabled.
+Do not select Zentui Starship or Hidden while expecting the HUD to remain in control.
+
+Zentui components are independent. Disable its Editor, Thinking and selector borders
+unless wanted. With its Editor disabled, use Working line placement `"above"` rather
+than the editor-border placement. Tool display custom/MCP overrides and replacement
+of Bash renderers require separate consent; installing the package does not authorize them.
 
 ## Footer modes
 
-- `/zentui footer hud`: enable the normal four groups or configured templates.
-- `/zentui footer hidden`: show only allowed third-party statuses, no row when none exist.
-- `/zentui footer native`: release ownership to Pi; saved HUD choices remain unchanged.
+- `/hud footer hud`: enable the normal four groups or configured templates.
+- `/hud footer hidden`: show only allowed third-party statuses, no row when none exist.
+- `/hud footer native`: release ownership to Pi; saved HUD choices remain unchanged.
 
 Hidden and HUD share the existing per-key `extensionStatuses` placement/color policy.
-Native is Pi-owned and does not apply this policy. `/zentui layout`, `segments`, and
+Native is Pi-owned and does not apply this policy. `/hud layout`, `segments`, and
 `extensions` open the corresponding settings tabs directly.
 
 ## Repository paths
@@ -54,7 +70,7 @@ abbreviation; a stale root is never used to produce a relative path.
 
 By default, `colorSources.starship` is `"theme"`. Built-in footer colors use semantic Pi theme tokens such as `accent`, `muted`, `success`, `warning`, and `error`; runtime labels also use the active theme. Switching themes, including automatic light/dark switching, recolors the footer without reloading the extension. This applies to both the default rows and custom templates.
 
-To enable theme colors in an existing configuration, use **Footer colors → theme** in `/zentui`, or set:
+To enable theme colors in an existing configuration, use **Footer colors → theme** in `/hud`, or set:
 
 ```json
 {
@@ -91,30 +107,28 @@ Entries you explicitly set under `colors` override the selected defaults. Semant
 | `sessionDuration` | off | Session | Current session duration |
 | `runningTools` | on | Activity | Currently running native tools and elapsed time |
 | `toolCounts` | on | Activity | Cumulative completed native-tool counts |
-| `activeAgents` | on | Activity | Active primary agent runs |
-| `agentIdle` | on | Activity | `Agent idle` when no primary agent run is active |
 | `skills` | on | Activity | Active/available skills count, e.g. `Skill 1/3` |
-| `mcp` | on | Activity | File-configured MCP servers, e.g. `MCP 2` |
+| `mcp` | on | Activity | MCP namespaces with exposed runtime tools, e.g. `MCP 2` |
 | `context` | on | Usage | Context percentage, window size, and/or gauge |
 | `inputTokens` | on | Usage | Cumulative input tokens |
 | `outputTokens` | on | Usage | Cumulative output tokens |
 | `cacheDetails` | on | Usage | Cache read/write tokens and latest hit rate |
 | `cost` | on | Usage | Cumulative session cost |
 | `codexUsage` | on | Usage | Codex weekly quota remaining |
-| `time` | off | Usage | Current time `HH:MM` |
+| `time` | off | Session | Current time `HH:MM`, after session duration |
 
 ## Template syntax
 
 Set a custom template:
 
 ```text
-/zentui format "$os  $cwd(  $git_branch)$fill($context)(  $tokens)(  $cost)"
+/hud format "$os  $cwd(  $git_branch)$fill($context)(  $tokens)(  $cost)"
 ```
 
 Clear it:
 
 ```text
-/zentui format clear
+/hud format clear
 ```
 
 ### Variables
@@ -169,10 +183,9 @@ the separator already owns spacing. Templates without it retain their previous b
 | `$skills` | Active/available skills, e.g. `Skill 1/3` |
 | `$active_skills` | Active skills count only |
 | `$extensions` | Installed Pi packages count |
-| `$mcp` | File-configured MCP server count |
+| `$mcp` | MCP namespace count from Pi's exposed runtime tools |
 | `$tool_counts` | Native tool completion counts |
 | `$running_tools` | Recently running tools |
-| `$active_agents` | Active primary agent runs |
 | `$subscription` | Optional `(sub)` when Pi reports OAuth subscription use (also kimi-coding) |
 | `$auto_compaction` | Optional `(auto)` when public, trust-aware Pi settings report automatic compaction |
 | `$pr_number` / `$pr_url` | Current open GitHub PR number / plain HTTPS URL, qualified against local HEAD |
@@ -199,7 +212,6 @@ $codex_quota → $codex_usage
 $turn_count → $turn
 $codex → $codex_usage
 $tools → $tool_counts
-$agents → $active_agents
 $separator → $sep
 ```
 
@@ -208,7 +220,7 @@ $separator → $sep
 Set a separate narrow layout (used below 80 terminal columns):
 
 ```text
-/zentui compact-format "$cwd$wrap(on $git_branch)$fill$context$wrap_sep$tokens$wrap_sep$extension_statuses"
+/hud compact-format "$cwd$wrap(on $git_branch)$fill$context$wrap_sep$tokens$wrap_sep$extension_statuses"
 ```
 
 `$wrap` starts an independently packable chunk with a space boundary.
@@ -220,7 +232,7 @@ template order and are right-aligned. Nested/additional fills do not create extr
 
 `compactFooterMaxLines` defaults to 2 (range 1–8), and omitted/truncated chunks use `…`.
 Layout → Responsive compact controls `responsiveFooter`; an empty compact format is inert.
-Use `/zentui compact-format clear` to return to the existing layout at every width.
+Use `/hud compact-format clear` to return to the existing layout at every width.
 Custom templates and wide templates are otherwise unchanged; arbitrary narrow layouts cannot keep every field.
 
 ## Custom extension values
@@ -279,7 +291,7 @@ Unsafe protocols, title, clipboard, cursor controls and embedded line breaks are
 links and styles are closed before adjacent content. Zentui mode strips publisher styling/links.
 
 ```text
-/zentui format "$cwd( · PR #$pr_number)( · $ci)$fill($token_rate)"
+/hud format "$cwd( · PR #$pr_number)( · $ci)$fill($token_rate)"
 ```
 
 PR/CI collection is opt-in through template references and requires installed/authenticated

package/docs/upstream-zentui.md

@@ -25,8 +25,8 @@ No extra runtime dependency is installed. Pi 1.3–1.x remains supported.
 | Passive live metadata | Template-opt-in `$pr_number`, `$pr_url`, `$ci`, `$token_rate` |
 | Atomic telemetry | `$cache_read` and `$cache_write` already existed; add optional `$subscription` / `$auto_compaction` |
 | Thinking variable | `$thinkingLevel` aliases the existing `$thinking` |
-| Status-only / native mode | `/zentui footer hidden` keeps permitted statuses; `native` releases Footer ownership |
-| Direct settings access | `/zentui layout`, `segments`, `extensions` |
+| Status-only / native mode | `/hud footer hidden` keeps permitted statuses; `native` releases Footer ownership |
+| Direct settings access | `/hud layout`, `segments`, `extensions` |
 
 ## Deliberate differences
 
@@ -36,7 +36,7 @@ No extra runtime dependency is installed. Pi 1.3–1.x remains supported.
 - Keep the independent, flat `~/.pi/agent/rinco-pi-hud.json` schema. Upstream
   `components.footer.styles.starship` objects are not automatically imported.
 - Keep existing theme defaults, legacy configuration migration, and all HUD counters, skills,
-  MCP file counts, model/provider labels, live context and usage totals.
+  MCP runtime tool counts, model/provider labels, live context and usage totals.
 - Keep the existing Codex quota client and DeepSeek / Token Switch balance probes.
   `$codex_quota` is a compatibility alias for `$codex_usage`, not a new collector.
   Upstream's separate official-OpenAI response-header quota collector is not installed.

package/extensions/hud/commands/settings-controller.ts

@@ -15,7 +15,7 @@ import {
 	saveSeparatorPatch,
 	saveUiFeaturesPatch,
 } from "../config/config.js";
-import { registerZentuiSettingsCommand } from "./settings.js";
+import { registerHudSettingsCommand } from "./settings.js";
 
 interface SettingsControllerDeps {
 	getConfig: () => PolishedTuiConfig;
@@ -32,7 +32,7 @@ export function registerSettingsController(pi: ExtensionAPI, deps: SettingsContr
 		deps.setConfig(config);
 	};
 
-	registerZentuiSettingsCommand(pi, {
+	registerHudSettingsCommand(pi, {
 		getConfig: deps.getConfig,
 		setColorSources(patch) {
 			updateConfig(saveColorSourcesPatch(patch));

package/extensions/hud/commands/settings.ts

@@ -102,7 +102,7 @@ const featureSettingLabels: Record<FeatureSettingId, string> = {
 };
 
 const featureSettingDescriptions: Record<FeatureSettingId, string> = {
-	statusLine: "Enable or disable Zentui's custom footer/status line.",
+	statusLine: "Enable or disable Rinco HUD's custom footer/status line.",
 };
 
 const footerRowLabels: Record<keyof FooterRowsConfig, string> = {
@@ -132,10 +132,8 @@ const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	sessionDuration: "Session duration",
 	runningTools: "Running tools",
 	toolCounts: "Completed tool counts",
-	activeAgents: "Active agents",
-	agentIdle: "Agent idle status",
 	skills: "Skill activity",
-	mcp: "MCP configured servers",
+	mcp: "MCP runtime servers",
 	context: "Context usage",
 	inputTokens: "Input tokens",
 	outputTokens: "Output tokens",
@@ -154,7 +152,7 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 		"Show numeric ahead/behind and stash counts (requires the Git status segment to be enabled).",
 	sessionDuration: "Show session running time on the session row.",
 	username: "Show user@hostname on the project row.",
-	time: "Show the current time (HH:MM) on the usage row.",
+	time: "Show the current time (HH:MM) after duration on the session row.",
 	os: "Show an operating-system icon on the project row.",
 	runtime: "Show or hide the detected runtime/language on the project row.",
 	context: "Show or hide context usage on the usage row.",
@@ -175,11 +173,9 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 	codexUsage: "Show OpenAI Codex subscription rate limits on the usage row when available.",
 	configCounts: "Show instruction-file and installed Pi package counts on the project row.",
 	skills: "Show active/available Pi skill counts on the activity row.",
-	mcp: "Show the configured server count from global and project mcp.json, including disabled entries.",
+	mcp: "Show MCP servers with exposed runtime tools reported by Pi.",
 	runningTools: "Show currently running native tools and their elapsed time.",
 	toolCounts: "Show cumulative completed native-tool counts.",
-	activeAgents: "Show active main agent runs on the activity row (not subagent count).",
-	agentIdle: "Show Agent idle when no main agent run is active.",
 };
 
 const directCommandSuggestions = [
@@ -257,9 +253,7 @@ function isFooterSegmentSettingId(value: string): value is FooterSegmentSettingI
 		value === "skills" ||
 		value === "mcp" ||
 		value === "runningTools" ||
-		value === "toolCounts" ||
-		value === "activeAgents" ||
-		value === "agentIdle"
+		value === "toolCounts"
 	);
 }
 
@@ -333,7 +327,7 @@ function footerSegmentPatch(
 }
 
 function usageText(): string {
-	return 'Usage: /zentui statusline [enable|disable|toggle], /zentui row [project|session|activity|usage] [enable|disable|toggle], or /zentui format "<template>", /zentui compact-format "<template>"|clear, /zentui footer hud|hidden|native, /zentui layout|extensions|segments';
+	return 'Usage: /hud statusline [enable|disable|toggle], /hud row [project|session|activity|usage] [enable|disable|toggle], or /hud format "<template>", /hud compact-format "<template>"|clear, /hud footer hud|hidden|native, /hud layout|extensions|segments';
 }
 
 function isFooterRow(value: string): value is keyof FooterRowsConfig {
@@ -602,9 +596,9 @@ function withSectionFooter(lines: string[], theme: ExtensionContext["ui"]["theme
 	return next;
 }
 
-export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCommandDeps): void {
-	pi.registerCommand("zentui", {
-		description: "Configure Zentui",
+export function registerHudSettingsCommand(pi: ExtensionAPI, deps: SettingsCommandDeps): void {
+	pi.registerCommand("hud", {
+		description: "Configure Rinco HUD",
 		getArgumentCompletions: argumentCompletions,
 		handler: async (_args, ctx) => {
 			const args = typeof _args === "string" ? _args : "";
@@ -673,7 +667,7 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 					}
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
-					if (ctx.hasUI) ctx.ui.notify(`Could not update Zentui settings: ${message}`, "error");
+					if (ctx.hasUI) ctx.ui.notify(`Could not update HUD settings: ${message}`, "error");
 				}
 				return;
 			}
@@ -691,7 +685,7 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 					}
 				} catch (error) {
 					const message = error instanceof Error ? error.message : String(error);
-					if (ctx.hasUI) ctx.ui.notify(`Could not update Zentui settings: ${message}`, "error");
+					if (ctx.hasUI) ctx.ui.notify(`Could not update HUD settings: ${message}`, "error");
 				}
 				return;
 			}
@@ -859,7 +853,7 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 								settingsList = makeSettingsList();
 								tui.requestRender();
 								const message = error instanceof Error ? error.message : String(error);
-								ctx.ui.notify(`Could not update Zentui settings: ${message}`, "error");
+								ctx.ui.notify(`Could not update HUD settings: ${message}`, "error");
 							}
 						},
 						() => done(undefined),

package/extensions/hud/config/config-counts.ts

@@ -1,7 +1,6 @@
 import { createRequire } from "node:module";
 import { readFileSync, statSync } from "node:fs";
 import { isAbsolute, join } from "node:path";
-import { countConfiguredMcpServers } from "../segments/mcp-status.js";
 
 export interface ConfigCounts {
 	instructionFiles: {
@@ -10,7 +9,6 @@ export interface ConfigCounts {
 		total: number;
 	};
 	packages: number;
-	mcpServers: number;
 }
 
 export interface ConfigCountOptions {
@@ -84,7 +82,6 @@ export function countConfigEntries(cwd: string, options: ConfigCountOptions = {}
 			total: agentsMd + claudeMd,
 		},
 		packages: countPackages(agentDir),
-		mcpServers: countConfiguredMcpServers(cwd, agentDir),
 	};
 }
 

package/extensions/hud/config/normalize.ts

@@ -166,7 +166,7 @@ function footerSegmentValue(
 function footerSegmentValueWithLegacy(
 	record: Record<string, unknown>,
 	key: keyof FooterSegmentsConfig,
-	legacyKey: "tokens" | "toolActivity" | "agentActivity",
+	legacyKey: "tokens" | "toolActivity",
 ): boolean {
 	const value = record[key];
 	if (typeof value === "boolean") return value;
@@ -268,8 +268,6 @@ function normalizeFooterSegments(record: Record<string, unknown>): FooterSegment
 		mcp: footerSegmentValue(record, "mcp"),
 		runningTools: footerSegmentValueWithLegacy(record, "runningTools", "toolActivity"),
 		toolCounts: footerSegmentValueWithLegacy(record, "toolCounts", "toolActivity"),
-		activeAgents: footerSegmentValueWithLegacy(record, "activeAgents", "agentActivity"),
-		agentIdle: footerSegmentValueWithLegacy(record, "agentIdle", "agentActivity"),
 	};
 }
 

package/extensions/hud/config/persist.ts

@@ -2,7 +2,7 @@
  * `save*Patch` functions: validate a partial settings patch, merge it into
  * the on-disk config record via `mutateConfig`, and return the freshly
  * merged `PolishedTuiConfig`. Each function only accepts fields/values that
- * pass the corresponding type guard, so callers (e.g. the `/zentui` settings
+ * pass the corresponding type guard, so callers (e.g. the `/hud` settings
  * UI) cannot write malformed values into the config file.
  */
 import { normalizeIconMode } from "../ui/icons.js";
@@ -75,9 +75,7 @@ function isFooterSegmentKey(value: string): value is keyof FooterSegmentsConfig
 		value === "skills" ||
 		value === "mcp" ||
 		value === "runningTools" ||
-		value === "toolCounts" ||
-		value === "activeAgents" ||
-		value === "agentIdle"
+		value === "toolCounts"
 	);
 }
 

package/extensions/hud/config/schema.ts

@@ -79,8 +79,6 @@ export type FooterSegmentsConfig = {
 	mcp: boolean;
 	runningTools: boolean;
 	toolCounts: boolean;
-	activeAgents: boolean;
-	agentIdle: boolean;
 };
 
 export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
@@ -206,7 +204,6 @@ export const FOOTER_FORMAT_VARIABLES = [
 	"mcp",
 	"tool_counts",
 	"running_tools",
-	"active_agents",
 	"sep",
 	"join_sep",
 	"extension_statuses",
@@ -237,7 +234,6 @@ export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
 	turn_count: "turn",
 	codex: "codex_usage",
 	tools: "tool_counts",
-	agents: "active_agents",
 	separator: "sep",
 };
 
@@ -349,8 +345,6 @@ export const defaultConfig: PolishedTuiConfig = {
 		mcp: true,
 		runningTools: true,
 		toolCounts: true,
-		activeAgents: true,
-		agentIdle: true,
 	},
 	gitCommit: {
 		hashLength: 7,

package/extensions/hud/footer/groups.ts

@@ -20,14 +20,13 @@ export interface SessionFooterSegments {
 	thinking: string;
 	turn: string;
 	duration: string;
+	time: string;
 }
 
 export interface ActivityFooterSegments {
 	category: string;
 	runningTools: string;
 	toolCounts: string;
-	activeAgents: string;
-	agentIdle: string;
 	skills: string;
 	mcp: string;
 	extensions: readonly string[];
@@ -41,7 +40,6 @@ export interface UsageFooterSegments {
 	cache: string;
 	cost: string;
 	quota: string;
-	time: string;
 }
 
 export interface CategorizedFooterGroupInput {
@@ -79,13 +77,12 @@ export function buildCategorizedFooterGroups(
 			input.session.thinking,
 			input.session.turn,
 			input.session.duration,
+			input.session.time,
 		]),
 		activity: compact([
 			input.activity.category,
 			input.activity.runningTools,
 			input.activity.toolCounts,
-			input.activity.activeAgents,
-			input.activity.agentIdle,
 			input.activity.skills,
 			input.activity.mcp,
 			...input.activity.extensions,
@@ -98,7 +95,6 @@ export function buildCategorizedFooterGroups(
 			input.usage.cache,
 			input.usage.cost,
 			input.usage.quota,
-			input.usage.time,
 		]),
 	};
 }

package/extensions/hud/footer/index.ts

@@ -53,6 +53,7 @@ export function installFooter(
 		scheduleProjectRefresh: (ctx: ExtensionContext) => void;
 		setExtensionStatusesGetter?: (fn: (() => ReadonlyMap<string, string>) | undefined) => void;
 		getLiveContext?: () => LiveContextOverride | undefined;
+		getMcpServerCount?: () => number;
 		getCustomValues?: () => ReadonlyMap<string, string>;
 		getTemplateValues?: () => ReadonlyMap<string, string>;
 		setOwnership?: (owned: boolean) => void;
@@ -200,9 +201,14 @@ export function installFooter(
 					mcpLabel,
 					toolCountsLabel,
 					runningToolsLabel,
-					activeAgentsLabel,
-					agentIdleLabel,
-				} = buildTelemetryLabels(ctx, state, config, theme, colorSource);
+				} = buildTelemetryLabels(
+					ctx,
+					state,
+					config,
+					theme,
+					colorSource,
+					hooks.getMcpServerCount?.() ?? 0,
+				);
 				const rawCustomValues = hooks.getCustomValues?.() ?? new Map<string, string>();
 				const customValues = new Map<string, string>();
 				for (const [alias, key] of Object.entries(config.footerVariables)) {
@@ -391,8 +397,6 @@ export function installFooter(
 							return toolCountsLabel;
 						case "running_tools":
 							return runningToolsLabel;
-						case "active_agents":
-							return activeAgentsLabel || agentIdleLabel;
 						case "subscription":
 						case "auto_compaction":
 						case "pr_number":
@@ -589,13 +593,12 @@ export function installFooter(
 						thinking: config.footerSegments.thinking ? thinkingLabel : "",
 						turn: config.footerSegments.turnCount ? turnLabel : "",
 						duration: sessionDurationSegment,
+						time: timeSegment,
 					},
 					activity: {
 						category: activityCategoryLabel,
 						runningTools: config.footerSegments.runningTools ? runningToolsLabel : "",
 						toolCounts: config.footerSegments.toolCounts ? toolCountsLabel : "",
-						activeAgents: config.footerSegments.activeAgents ? activeAgentsLabel : "",
-						agentIdle: config.footerSegments.agentIdle ? agentIdleLabel : "",
 						skills: config.footerSegments.skills ? skillsLabel : "",
 						mcp: config.footerSegments.mcp ? mcpLabel : "",
 						extensions: [...extensionLeft, ...extensionMiddle, ...extensionRight],
@@ -612,7 +615,6 @@ export function installFooter(
 							? renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel)
 							: "",
 						quota: config.footerSegments.codexUsage ? codexUsageLabel : "",
-						time: timeSegment,
 					},
 				});
 				const contents = composeCategorizedFooterRows(

package/extensions/hud/footer/render-labels.ts

@@ -151,18 +151,17 @@ export type TelemetryLabels = {
 	mcpLabel: string;
 	toolCountsLabel: string;
 	runningToolsLabel: string;
-	activeAgentsLabel: string;
-	agentIdleLabel: string;
 };
 
 /** Build every session/activity/usage-row telemetry label (model, thinking level,
- * turn count, cache/tool/agent counters, skills, MCP, Codex usage, …). */
+ * turn count, cache/tool counters, skills, MCP, Codex usage, …). */
 export function buildTelemetryLabels(
 	ctx: Pick<ExtensionContext, "model">,
 	state: FooterState,
 	config: PolishedTuiConfig,
 	theme: ThemeLike,
 	colorSource: ColorSource,
+	mcpServerCount = 0,
 ): TelemetryLabels {
 	const statusStyle = (style: string, text: string) =>
 		text ? renderStyleForSource(theme, colorSource, style, text) : "";
@@ -266,9 +265,7 @@ export function buildTelemetryLabels(
 	const configCountsLabel = [instructionFilesLabel, extensionsLabel].filter(Boolean).join(" ");
 
 	const mcpLabel =
-		state.configCounts.mcpServers > 0
-			? statusStyle(config.colors.gitStatus, `MCP ${state.configCounts.mcpServers}`)
-			: "";
+		mcpServerCount > 0 ? statusStyle(config.colors.gitStatus, `MCP ${mcpServerCount}`) : "";
 
 	const telemetryStats = getTelemetryStats(state.telemetry);
 	const toolCountsText = Object.entries(telemetryStats.completedToolCounts)
@@ -286,12 +283,6 @@ export function buildTelemetryLabels(
 		})
 		.join(" ");
 	const runningToolsLabel = statusStyle(config.colors.contextWarning, runningToolsText);
-	const activeAgentsLabel =
-		telemetryStats.activeAgentRuns > 0
-			? statusStyle(config.colors.extensionStatus, `Agent × ${telemetryStats.activeAgentRuns}`)
-			: "";
-	const agentIdleLabel =
-		telemetryStats.activeAgentRuns === 0 ? statusStyle(config.colors.muted, "Agent idle") : "";
 
 	return {
 		projectCategoryLabel,
@@ -322,7 +313,5 @@ export function buildTelemetryLabels(
 		mcpLabel,
 		toolCountsLabel,
 		runningToolsLabel,
-		activeAgentsLabel,
-		agentIdleLabel,
 	};
 }

package/extensions/hud/index.ts

@@ -9,6 +9,7 @@ import { CustomVariables } from "./segments/custom-variables.js";
 import { createLiveMetadata } from "./segments/live-metadata.js";
 import { FooterTelemetryController } from "./telemetry/optional.js";
 import { emptyGitStatus } from "./segments/git.js";
+import { getMcpServerCount } from "./segments/mcp-status.js";
 import { LiveContextController } from "./session/live-context.js";
 import { createProjectStateController } from "./state/project-controller.js";
 import { isLiveExtensionContext } from "./session/context.js";
@@ -200,6 +201,7 @@ export default function (pi: ExtensionAPI) {
 				getActiveExtensionStatuses = fn ?? (() => new Map());
 			},
 			getLiveContext: () => liveContext.get(),
+			getMcpServerCount: () => getMcpServerCount(pi),
 			getCustomValues: () => customVariables.snapshot(),
 			getTemplateValues: () => new Map([...templateValues, ...metadata.values()]),
 			setOwnership(owned) {

package/extensions/hud/segments/mcp-status.ts

@@ -1,31 +1,28 @@
-import { readFileSync, statSync } from "node:fs";
-import { join } from "node:path";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 
-const MAX_CONFIG_BYTES = 1024 * 1024;
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-	return value !== null && typeof value === "object" && !Array.isArray(value);
-}
-
-function readServerNames(path: string): string[] {
+/** Count MCP namespaces with exposed runtime tools, not configuration entries or connections.
+ * Pi owns configuration, trust, credentials, and connections. getMcpServers() only lists
+ * extension registrations, whereas getAllTools() includes tools from file-configured servers
+ * and extensions, including codemode/deferred tools absent from the active tool set.
+ * Hidden tools remain registered after a server is disabled or removed, so exclude them.
+ * Resource-only servers cannot be identified through this public API and are not counted.
+ */
+export function getMcpServerCount(pi: Pick<ExtensionAPI, "getAllTools">): number {
 	try {
-		const stats = statSync(path);
-		if (!stats.isFile() || stats.size > MAX_CONFIG_BYTES) return [];
-		const config: unknown = JSON.parse(readFileSync(path, "utf8"));
-		if (!isRecord(config) || !isRecord(config.mcpServers)) return [];
-		return Object.entries(config.mcpServers)
-			.filter(([name, entry]) => /^[A-Za-z0-9_-]+$/.test(name) && isRecord(entry))
-			.map(([name]) => name);
+		const namespaces = new Set<string>();
+		for (const tool of pi.getAllTools()) {
+			const namespace = tool.namespace?.name;
+			if (
+				tool.exposure !== "hidden" &&
+				namespace &&
+				/^mcp__[A-Za-z0-9_]+$/.test(namespace) &&
+				tool.name.startsWith(`${namespace}__`)
+			) {
+				namespaces.add(namespace);
+			}
+		}
+		return namespaces.size;
 	} catch {
-		return [];
+		return 0;
 	}
 }
-
-/** Count file-configured server entries, including disabled ones, without resolving secrets
- * or starting connections. Project entries override global entries with the same name.
- * This is not a connection count or a validation of individual server settings. */
-export function countConfiguredMcpServers(cwd: string, agentDir: string): number {
-	const globalNames = agentDir ? readServerNames(join(agentDir, "mcp.json")) : [];
-	const projectNames = readServerNames(join(cwd, ".pi", "mcp.json"));
-	return new Set([...globalNames, ...projectNames]).size;
-}

package/extensions/hud/session/event-handlers.ts

@@ -79,18 +79,10 @@ export function registerSessionEventHandlers(
 
 	pi.on("agent_start", (event, ctx) => {
 		deps.liveContext.clear();
-		deps.state.telemetry = updateTelemetryState(deps.state.telemetry, {
-			type: "agent-start",
-			at: Date.now(),
-		});
 		syncInteractiveState(event, ctx);
 	});
 	pi.on("agent_end", (event, ctx) => {
 		deps.liveContext.clear();
-		deps.state.telemetry = updateTelemetryState(deps.state.telemetry, {
-			type: "agent-end",
-			at: Date.now(),
-		});
 		syncInteractiveAndProjectState(event, ctx);
 	});
 	pi.on("model_select", (event, ctx) => {

package/extensions/hud/session/footer-clock.ts

@@ -18,7 +18,8 @@ export function footerClockNeeds(
 	const defaultLayout = !config.footerFormat;
 	return {
 		wallClock:
-			names.has("time") || (defaultLayout && config.footerRows.usage && config.footerSegments.time),
+			names.has("time") ||
+			(defaultLayout && config.footerRows.session && config.footerSegments.time),
 		duration:
 			names.has("session_duration") ||
 			(defaultLayout && config.footerRows.session && config.footerSegments.sessionDuration),

package/extensions/hud/state/index.ts

@@ -45,7 +45,6 @@ export function createInitialState(gitDefaults: GitStatusSummary): FooterState {
 		configCounts: {
 			instructionFiles: { agentsMd: 0, claudeMd: 0, total: 0 },
 			packages: 0,
-			mcpServers: 0,
 		},
 		skillCounts: undefined,
 		codexUsageStatus: undefined,

package/extensions/hud/state/telemetry.ts

@@ -4,7 +4,6 @@ export const TRACKED_TOOL_NAMES = ["read", "write", "edit", "bash", "grep", "ls"
 
 export type TrackedToolName = (typeof TRACKED_TOOL_NAMES)[number];
 export type ToolStatus = "running" | "completed" | "error";
-export type AgentRunStatus = "running" | "completed";
 
 export interface ToolRecord {
 	toolCallId: string;
@@ -15,19 +14,12 @@ export interface ToolRecord {
 	endTime?: number;
 }
 
-export interface AgentRunRecord {
-	status: AgentRunStatus;
-	startTime: number;
-	endTime?: number;
-}
-
 export interface TelemetryState {
 	sessionName: string | undefined;
 	turnIndex: number;
 	thinkingLevel: string;
 	modelSupportsReasoning: boolean;
 	tools: readonly ToolRecord[];
-	agentRuns: readonly AgentRunRecord[];
 }
 
 export interface TelemetryInitialValues {
@@ -47,21 +39,16 @@ export type TelemetryUpdate =
 			args?: Record<string, unknown> | null;
 			at: number;
 	  }
-	| { type: "tool-result"; toolCallId: string; isError: boolean; at: number }
-	| { type: "agent-start"; at: number }
-	| { type: "agent-end"; at: number };
+	| { type: "tool-result"; toolCallId: string; isError: boolean; at: number };
 
 export interface TelemetryStats {
 	completedToolCounts: Record<TrackedToolName, number>;
 	recentRunningTools: readonly ToolRecord[];
-	activeAgentRuns: number;
 }
 
 const trackedToolNames = new Set<string>(TRACKED_TOOL_NAMES);
 const TOOL_HISTORY_LIMIT = 500;
 const TOOL_HISTORY_RETAINED = 400;
-const AGENT_HISTORY_LIMIT = 500;
-const AGENT_HISTORY_RETAINED = 400;
 const MAX_EXTERNAL_TEXT_LENGTH = 2048;
 const thinkingLevels = new Set(["off", "minimal", "low", "medium", "high", "xhigh", "max"]);
 
@@ -87,7 +74,6 @@ export function createTelemetryState(initial: TelemetryInitialValues = {}): Tele
 		thinkingLevel: normalizeThinkingLevel(initial.thinkingLevel),
 		modelSupportsReasoning: initial.modelSupportsReasoning ?? false,
 		tools: [],
-		agentRuns: [],
 	};
 }
 
@@ -193,21 +179,6 @@ function finishTool(
 	return { ...state, tools };
 }
 
-function finishLatestAgentRun(state: TelemetryState, at: number): TelemetryState {
-	let matchIndex = -1;
-	for (let index = state.agentRuns.length - 1; index >= 0; index -= 1) {
-		if (state.agentRuns[index]?.status === "running") {
-			matchIndex = index;
-			break;
-		}
-	}
-	if (matchIndex < 0) return state;
-
-	const agentRuns = [...state.agentRuns];
-	agentRuns[matchIndex] = { ...agentRuns[matchIndex]!, status: "completed", endTime: at };
-	return { ...state, agentRuns };
-}
-
 export function updateTelemetryState(
 	state: TelemetryState,
 	update: TelemetryUpdate,
@@ -221,15 +192,6 @@ export function updateTelemetryState(
 			return addTool(state, update);
 		case "tool-result":
 			return finishTool(state, update);
-		case "agent-start": {
-			let agentRuns = [...state.agentRuns, { status: "running" as const, startTime: update.at }];
-			if (agentRuns.length > AGENT_HISTORY_LIMIT) {
-				agentRuns = agentRuns.slice(-AGENT_HISTORY_RETAINED);
-			}
-			return { ...state, agentRuns };
-		}
-		case "agent-end":
-			return finishLatestAgentRun(state, update.at);
 	}
 }
 
@@ -254,12 +216,8 @@ export function getTelemetryStats(state: TelemetryState): TelemetryStats {
 		.filter((tool) => tool.status === "running")
 		.slice(-2)
 		.map((tool) => ({ ...tool }));
-	const activeAgentRuns = state.agentRuns.reduce(
-		(count, run) => count + (run.status === "running" ? 1 : 0),
-		0,
-	);
 
-	return { completedToolCounts, recentRunningTools, activeAgentRuns };
+	return { completedToolCounts, recentRunningTools };
 }
 
 export const createTelemetry = createTelemetryState;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rinco-pi-hud",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
   "type": "module",
   "license": "MIT",