@herbertgao/pi-extensions 2026.8.3 → 2026.8.5

package/README.md

@@ -11,17 +11,58 @@ pi install npm:@herbertgao/pi-extensions
 The package bundles 11 active `@herbertgao/*` child packages, including `@herbertgao/pi-cc-extensions`, plus the following upstream packages under their original names:
 
 - `@dietrichgebert/ponytail@4.9.0`
-- `@juicesharp/rpiv-ask-user-question@2.4.0`
-- `@narumitw/pi-btw@0.50.0`
+- `@juicesharp/rpiv-ask-user-question@2.5.2`
+- `@narumitw/pi-btw@0.51.0`
 - `@pi-plugins/fast-mode@0.1.9`
-- `pi-mcp-adapter@2.23.0`
-- `pi-lens@3.8.74`
+- `pi-mcp-adapter@2.25.0`
+- `pi-footer@0.5.1`
+- `pi-lens@4.0.0`
 - `pi-web-access@0.22.0`
 - `remote-pi@0.7.0`
 - `@czottmann/pi-automode@1.11.0`
 
 Pi loads their extensions and skills through `node_modules/` paths inside one package root. The upstream companions are pinned and bundled, not forked or renamed.
 
+If `pi-footer` was installed separately before upgrading to an aggregate release that includes it, remove the standalone source shown by `pi list` so only the bundled copy loads. For the pinned standalone install used while preparing this integration:
+
+```bash
+pi remove npm:pi-footer@0.5.1
+```
+
+### Recommended footer
+
+`pi-footer` is enabled by the aggregate. To use the recommended compact layout for MCP, Auto mode, LSP, Ponytail, Remote Pi, and Subagents, copy the bundled example to Pi's user config directory:
+
+```bash
+agent_dir="${PI_CODING_AGENT_DIR:-$HOME/.pi/agent}"
+mkdir -p "$agent_dir/extensions"
+cp "$agent_dir/npm/node_modules/@herbertgao/pi-extensions/examples/pi-footer.json" \
+  "$agent_dir/extensions/pi-footer.json"
+```
+
+The same copy is linked here as [`examples/pi-footer.json`](examples/pi-footer.json). The example preserves the native path, Git branch, session, token/context, model, and thinking information. It uses a gray `•` separator and shows Remote Pi/Subagents only when those extensions publish status. Restart Pi or run `/reload` after copying. Existing config is intentionally never overwritten automatically.
+
+For the intended compact status text, merge these optional companion settings into existing files rather than replacing the files:
+
+```jsonc
+// ~/.pi/agent/mcp.json
+{
+  "settings": {
+    "mcpFooterStatus": "compact",
+    "showStatusIcon": false
+  }
+}
+
+// ~/.pi-lens/config.json
+{
+  "widget": {
+    "visible": false
+  }
+}
+```
+
+The copy command replaces an existing `pi-footer.json`; review or back it up first. Only one footer-replacement extension should be enabled at a time. Use `/footer` for interactive changes.
+
 Pi 0.84.1 or newer should use native `fullscreen` TUI mode. The deprecated `@herbertgao/pi-fixed-editor` legacy package is intentionally not bundled.
 
 ### Remote Pi trust boundary

package/examples/pi-footer.json

@@ -0,0 +1,275 @@
+{
+  "version": 1,
+  "enabled": true,
+  "preset": "pi-footer",
+  "lines": [
+    [
+      {
+        "id": "core-cwd",
+        "type": "cwd",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "cwdDisplayStyle": "full-home"
+        }
+      },
+      {
+        "id": "core-branch",
+        "type": "git-branch",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "hideWhenEmpty": true,
+          "gitBranchDisplayStyle": "round-brackets"
+        }
+      },
+      {
+        "id": "core-session",
+        "type": "session-name",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "hideWhenEmpty": true
+        }
+      }
+    ],
+    [
+      {
+        "id": "core-tokens",
+        "type": "tokens",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "tokenFormatStyle": "compact"
+        }
+      },
+      {
+        "id": "core-cache-read",
+        "type": "cache-read",
+        "enabled": true,
+        "options": {
+          "icon": "R",
+          "fg": "pi:dim",
+          "tokenFormatStyle": "compact",
+          "hideWhenZero": true
+        }
+      },
+      {
+        "id": "core-cache-write",
+        "type": "cache-write",
+        "enabled": true,
+        "options": {
+          "icon": "W",
+          "fg": "pi:dim",
+          "tokenFormatStyle": "compact",
+          "hideWhenZero": true
+        }
+      },
+      {
+        "id": "core-cache-hit",
+        "type": "cache-hit-rate",
+        "enabled": true,
+        "options": {
+          "icon": "CH",
+          "fg": "pi:dim",
+          "hideWhenZero": true,
+          "cacheHitSource": "turn"
+        }
+      },
+      {
+        "id": "core-cost",
+        "type": "cost",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "costFormatStyle": "compact",
+          "showSubscription": true
+        }
+      },
+      {
+        "id": "core-context",
+        "type": "context",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "contextConditionalColors": true,
+          "warningFg": "pi:warning",
+          "dangerFg": "pi:error"
+        }
+      },
+      {
+        "id": "core-context-slash",
+        "type": "separator",
+        "enabled": true,
+        "options": {
+          "separator": "custom",
+          "text": "/",
+          "fg": "pi:dim"
+        }
+      },
+      {
+        "id": "core-context-window",
+        "type": "context-window",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "contextConditionalColors": true,
+          "warningFg": "pi:warning",
+          "dangerFg": "pi:error",
+          "tokenFormatStyle": "compact"
+        }
+      },
+      {
+        "id": "core-flex",
+        "type": "flex-separator",
+        "enabled": true,
+        "options": {}
+      },
+      {
+        "id": "core-model",
+        "type": "model",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim"
+        }
+      },
+      {
+        "id": "core-thinking",
+        "type": "thinking-level",
+        "enabled": true,
+        "options": {
+          "raw": true,
+          "fg": "pi:dim",
+          "hideWhenEmpty": true
+        }
+      }
+    ],
+    [
+      {
+        "id": "status-mcp",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "mcp",
+          "icon": "🔌 ",
+          "hideWhenEmpty": true
+        }
+      },
+      {
+        "id": "status-auto",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "pi-automode",
+          "icon": "🤖 Auto ",
+          "trimValue": 2,
+          "preserveTrimStyles": true,
+          "hideWhenEmpty": true
+        }
+      }
+    ],
+    [
+      {
+        "id": "status-lsp",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "pi-lens-lsp",
+          "icon": "🧩 LSP ",
+          "trimValue": 4,
+          "preserveTrimStyles": true,
+          "hideWhenEmpty": true
+        }
+      },
+      {
+        "id": "status-ponytail",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "ponytail",
+          "trimValue": 2,
+          "preserveTrimStyles": false,
+          "hideWhenEmpty": true
+        }
+      }
+    ],
+    [
+      {
+        "id": "status-remote-session",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "remote-pi:session",
+          "hideWhenEmpty": true
+        }
+      },
+      {
+        "id": "status-remote-relay",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "remote-pi:relay",
+          "hideWhenEmpty": true
+        }
+      },
+      {
+        "id": "status-remote-peer",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "remote-pi:peer-active",
+          "hideWhenEmpty": true
+        }
+      },
+      {
+        "id": "status-subagents",
+        "type": "external-status",
+        "enabled": true,
+        "options": {
+          "externalStatusKey": "subagents",
+          "icon": "👥 ",
+          "hideWhenEmpty": true
+        }
+      }
+    ]
+  ],
+  "separator": "dot",
+  "separatorFg": "brightBlack",
+  "separatorBg": "default",
+  "iconMode": "text",
+  "minimalist": false,
+  "terminal": {
+    "widthMode": "full",
+    "colorLevel": "ansi256"
+  },
+  "extensionStatusRow": {
+    "hiddenKeys": [
+      "mcp",
+      "pi-automode",
+      "pi-lens-lsp",
+      "ponytail",
+      "remote-pi:peer-active",
+      "remote-pi:relay",
+      "remote-pi:session",
+      "subagents"
+    ],
+    "knownKeys": [
+      "mcp",
+      "pi-automode",
+      "pi-lens-lsp",
+      "ponytail",
+      "remote-pi:peer-active",
+      "remote-pi:relay",
+      "remote-pi:session",
+      "subagents"
+    ]
+  }
+}

package/node_modules/@herbertgao/pi-cc-extensions/README.en.md

@@ -39,7 +39,7 @@ Run `/reload` after installation.
 | ------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------- | ------------- |
 | Claude Code Output     | Tool summaries, expand/collapse, rich edit/write diffs, and `on` / `compact` / `off` modes                                                         | `/ccstyle`  |
 | Fullscreen mode          | Tool card/group click-to-toggle, previews, hover highlight, and a back-to-bottom button | `TUIMODE=fullscreen` or `--tui-mode fullscreen` |
-| Settings panel               | `Style / Diff / Thinking / Feature` tabs: startup header toggle and wheel step                                                                    | `/ccstyle`  |
+| Settings panel               | `Style / Diff / Thinking / Feature` tabs with startup, wheel, and optional feature toggles                                                        | `/ccstyle`  |
 | Context inspection           | Usage breakdown and previews for the system prompt, tools, skills, and messages                                                                   | `/context`  |
 | Session/Subagent references           | Search and inject effective context from previous Sessions or existing SubAgents                                                                  | `@` |
 | Theme                        | Bundled CC Dark and CC Light themes                                                                                                               | `/theme`    |
@@ -62,10 +62,18 @@ Run `/reload` after installation.
   "previewLines": 3,                       // thinking preview lines; 0 hides the preview body
   "animationIntervalMs": 90,               // thinking title animation interval in ms
   "showStartupHeader": true,               // custom startup header (logo + tips) toggle
-  "scrollStepLines": 3                     // fullscreen mouse wheel scroll lines
+  "scrollStepLines": 3,                    // fullscreen mouse wheel scroll lines
+  "enableSessionReference": true,          // @ session references
+  "enableSubagentAutocomplete": true,      // @ subagent autocomplete
+  "enableContextCommand": true,            // /context inspection
+  "enableAgentSummary": true,              // per-turn tool summary
+  "enableWorkingMessage": true,            // Working... token/time details
+  "enableAliases": true                    // /clear and /exit aliases
 }
 ```
 
+> **Tip**: set Mermaid diagrams to `final` in `/settings` to avoid redrawing streaming content frame by frame.
+
 ## Local development
 
 ```bash

package/node_modules/@herbertgao/pi-cc-extensions/README.md

@@ -39,7 +39,7 @@ pi install npm:@herbertgao/pi-cc-extensions
 | ---------------------- | ---------------------------------------------------------------------------------------------------------- | ------------- |
 | Claude Code UI | 工具摘要、折叠展开、rich edit/write diff，以及 `on` / `compact` / `off` 三种模式                          | `/ccstyle`  |
 | Fullscreen mode  | 工具卡/group 点击展开与收起、预览、hover 高亮、回到底部按钮 | `TUIMODE=fullscreen` 或 `--tui-mode fullscreen` |
-| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头开关与滚轮步进                                       | `/ccstyle`  |
+| 配置面板             | `Style / Diff / Thinking / Feature` 四页签，含启动头、滚轮步进及可选功能开关                              | `/ccstyle`  |
 | 上下文检查           | 查看上下文占用，并预览 System prompt、Tools、Skills 和消息内容                                           | `/context`  |
 | Session/Subagent 引用         | 搜索并注入历史 Session 或现有 SubAgent 的有效上下文                                                      | `@` |
 | 主题                 | 随包提供内置 CC Dark、CC Light 主题                                                                      | `/theme`    |
@@ -62,10 +62,18 @@ pi install npm:@herbertgao/pi-cc-extensions
   "previewLines": 3,                       // thinking 预览行数，0 隐藏预览正文
   "animationIntervalMs": 90,               // thinking 标题动画间隔（毫秒）
   "showStartupHeader": true,               // 自定义启动头（logo + tips）开关
-  "scrollStepLines": 3                     // fullscreen 滚轮滚动步进行数
+  "scrollStepLines": 3,                    // fullscreen 滚轮滚动步进行数
+  "enableSessionReference": true,          // @ session 引用
+  "enableSubagentAutocomplete": true,      // @ subagent 自动补全
+  "enableContextCommand": true,            // /context 上下文检查
+  "enableAgentSummary": true,              // 每回合工具统计摘要
+  "enableWorkingMessage": true,            // Working... token/耗时展示
+  "enableAliases": true                    // /clear、/exit 别名
 }
 ```
 
+> **建议**：在 `/settings` 中将 Mermaid diagrams 设为 `final`，避免流式内容逐帧重绘。
+
 ## 本地开发
 
 ```bash

package/node_modules/@herbertgao/pi-cc-extensions/extensions/config/config.ts

@@ -25,6 +25,12 @@ export type Config = {
 	animationIntervalMs: number;
 	showStartupHeader: boolean;
 	scrollStepLines: number;
+	enableSessionReference: boolean;
+	enableSubagentAutocomplete: boolean;
+	enableContextCommand: boolean;
+	enableAgentSummary: boolean;
+	enableWorkingMessage: boolean;
+	enableAliases: boolean;
 };
 
 const AGENT_DIR = process.env.PI_CODING_AGENT_DIR ?? join(homedir(), ".pi", "agent");
@@ -67,6 +73,12 @@ export const DEFAULT_CONFIG: Config = {
 	animationIntervalMs: 90,
 	showStartupHeader: true,
 	scrollStepLines: 3,
+	enableSessionReference: true,
+	enableSubagentAutocomplete: true,
+	enableContextCommand: true,
+	enableAgentSummary: true,
+	enableWorkingMessage: true,
+	enableAliases: true,
 };
 
 function pickEnum<T extends string>(value: unknown, allowed: readonly T[], fallback: T): T {
@@ -148,6 +160,12 @@ export function normalizeConfig(input: unknown): Config {
 		),
 		showStartupHeader: source.showStartupHeader !== false,
 		scrollStepLines: pickPositiveInt(source.scrollStepLines, DEFAULT_CONFIG.scrollStepLines, 1, 50),
+		enableSessionReference: source.enableSessionReference !== false,
+		enableSubagentAutocomplete: source.enableSubagentAutocomplete !== false,
+		enableContextCommand: source.enableContextCommand !== false,
+		enableAgentSummary: source.enableAgentSummary !== false,
+		enableWorkingMessage: source.enableWorkingMessage !== false,
+		enableAliases: source.enableAliases !== false,
 	};
 }
 
@@ -189,6 +207,12 @@ export function formatConfigStatus(source: Config = config): string {
 		`thinkingAnimation=${source.animationIntervalMs}ms`,
 		`startupHeader=${source.showStartupHeader ? "on" : "off"}`,
 		`scrollStep=${source.scrollStepLines}`,
+		`sessionRef=${source.enableSessionReference ? "on" : "off"}`,
+		`subagentAuto=${source.enableSubagentAutocomplete ? "on" : "off"}`,
+		`context=${source.enableContextCommand ? "on" : "off"}`,
+		`agentSummary=${source.enableAgentSummary ? "on" : "off"}`,
+		`workingMsg=${source.enableWorkingMessage ? "on" : "off"}`,
+		`aliases=${source.enableAliases ? "on" : "off"}`,
 	].join(" · ");
 }
 

package/node_modules/@herbertgao/pi-cc-extensions/extensions/config/panel.ts

@@ -64,6 +64,29 @@ function diffIndicatorDescription(mode: DiffIndicatorMode): string {
 	return "Vertical bar indicators on changed lines (default).";
 }
 
+function featureToggleSetting(
+	id: string,
+	label: string,
+	onDescription: string,
+	offDescription: string,
+	current: boolean,
+) {
+	const setting = {
+		id,
+		label,
+		description: current ? onDescription : offDescription,
+		currentValue: current ? "on" : "off",
+		values: ["on", "off"],
+	};
+	return {
+		setting,
+		apply(on: boolean): void {
+			setting.currentValue = on ? "on" : "off";
+			setting.description = on ? onDescription : offDescription;
+		},
+	};
+}
+
 function buildExcludeRenderersSubmenu(
 	onClose: () => void,
 	onLiveChange: () => void,
@@ -333,8 +356,66 @@ export async function showCcstylePanel(
 			submenu: (_current: string, closeSubmenu: (selected?: string) => void) =>
 				buildNumberInputSubmenu(theme, scrollStepSetting, closeSubmenu),
 		};
+		const sessionReferenceToggle = featureToggleSetting(
+			"enableSessionReference",
+			"Session reference",
+			"@ session mentions search and inject referenced context after restart.",
+			"Session reference disabled.",
+			config.enableSessionReference,
+		);
+		const subagentAutocompleteToggle = featureToggleSetting(
+			"enableSubagentAutocomplete",
+			"Subagent autocomplete",
+			"@ subagent mentions suggest agents and delegation instructions after restart.",
+			"Subagent autocomplete disabled.",
+			config.enableSubagentAutocomplete,
+		);
+		const contextCommandToggle = featureToggleSetting(
+			"enableContextCommand",
+			"Context usage",
+			"/context shows context-window distribution after restart.",
+			"Context command disabled.",
+			config.enableContextCommand,
+		);
+		const agentSummaryToggle = featureToggleSetting(
+			"enableAgentSummary",
+			"Agent summary",
+			"Append per-round tool stats after each agent turn after restart.",
+			"Agent summary disabled.",
+			config.enableAgentSummary,
+		);
+		const workingMessageToggle = featureToggleSetting(
+			"enableWorkingMessage",
+			"Working message",
+			"Extend Working... with token count and elapsed time after restart.",
+			"Native Working... footer only.",
+			config.enableWorkingMessage,
+		);
+		const aliasesToggle = featureToggleSetting(
+			"enableAliases",
+			"Aliases",
+			"/clear and /exit aliases enabled after restart.",
+			"Aliases disabled.",
+			config.enableAliases,
+		);
+		const featureToggles: Record<string, { apply: (on: boolean) => void }> = {
+			enableSessionReference: sessionReferenceToggle,
+			enableSubagentAutocomplete: subagentAutocompleteToggle,
+			enableContextCommand: contextCommandToggle,
+			enableAgentSummary: agentSummaryToggle,
+			enableWorkingMessage: workingMessageToggle,
+			enableAliases: aliasesToggle,
+		};
 
 		const onSettingChange = (id: string, value: string) => {
+			const featureToggle = featureToggles[id];
+			if (featureToggle) {
+				(config as unknown as Record<string, boolean>)[id] = value === "on";
+				featureToggle.apply(value === "on");
+				saveConfig();
+				ctx.ui.notify(`Updated ${id}: ${value} (next restart)`, "info");
+				return;
+			}
 			switch (id) {
 				case "mode": {
 					// 选项值带 Experimental 标记，选择后还原为真实 mode 值。
@@ -450,7 +531,16 @@ export async function showCcstylePanel(
 			{
 				id: "feature",
 				label: "Feature",
-				items: [startupHeaderSetting, scrollStepSetting],
+				items: [
+					startupHeaderSetting,
+					scrollStepSetting,
+					sessionReferenceToggle.setting,
+					subagentAutocompleteToggle.setting,
+					contextCommandToggle.setting,
+					agentSummaryToggle.setting,
+					workingMessageToggle.setting,
+					aliasesToggle.setting,
+				],
 			},
 		];
 

package/node_modules/@herbertgao/pi-cc-extensions/extensions/feature/compact-thinking.ts

@@ -94,7 +94,7 @@ type AssistantInternals = {
 };
 
 type PatchedPrototype = typeof AssistantMessageComponent.prototype & {
-	updateContent: (message: AssistantMessage) => void;
+	updateContent: (message: AssistantMessage, isStreaming?: boolean) => void;
 };
 
 // 配置由 claude-code-style 管控（installCompactThinking 注入初始值，
@@ -334,9 +334,13 @@ function compactThinking(pi: ExtensionAPI) {
 		);
 	}
 
-	prototype.updateContent = function patchedUpdateContent(message: AssistantMessage) {
+	prototype.updateContent = function patchedUpdateContent(
+		message: AssistantMessage,
+		isStreaming?: boolean,
+	) {
 		const component = this as AssistantMessageComponentLike;
 		const self = this as unknown as AssistantInternals;
+		self.isStreaming = isStreaming ?? self.isStreaming;
 		self.lastMessage = message;
 		latestComponent = component;
 		latestComponentTimestamp = message.timestamp;
@@ -344,7 +348,7 @@ function compactThinking(pi: ExtensionAPI) {
 		// Visible mode is intentionally untouched: Shift+Tab restores Pi's exact
 		// built-in Thinking Markdown renderer, including every OpenAI summary stage.
 		if (!self.hideThinkingBlock) {
-			originalUpdateContent.call(this, message);
+			originalUpdateContent.call(this, message, self.isStreaming);
 			return;
 		}
 

package/node_modules/@herbertgao/pi-cc-extensions/extensions/index.ts

@@ -1,4 +1,5 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { config } from "./config/config.ts";
 
 // shell
 import piAliases from "./feature/shell/aliases.ts";
@@ -21,9 +22,9 @@ import markdownEnhance from "./renderer/markdown-enhance.ts";
 
 export default function (pi: ExtensionAPI): void {
 	// shell chrome
-	piAliases(pi);
+	if (config.enableAliases) piAliases(pi);
 	piStartupHeader(pi);
-	workingMessage(pi);
+	if (config.enableWorkingMessage) workingMessage(pi);
 
 	// Renderer 必须先注册 lifecycle handler，shutdown 时才能先解开外层 compact
 	// patch；bridge 让稍后安装的 thinking controller 仍可直接供 renderer query。
@@ -42,8 +43,8 @@ export default function (pi: ExtensionAPI): void {
 	compactThinking = installCompactThinking(pi, getCompactThinkingConfig());
 
 	// features
-	context(pi);
-	sessionReference(pi);
-	agentAutocomplete(pi);
-	agentSummary(pi);
+	if (config.enableContextCommand) context(pi);
+	if (config.enableSessionReference) sessionReference(pi);
+	if (config.enableSubagentAutocomplete) agentAutocomplete(pi);
+	if (config.enableAgentSummary) agentSummary(pi);
 }