pi-bar 0.3.0 → 0.3.2

package/README.md

@@ -3,23 +3,22 @@
 [![npm version](https://img.shields.io/npm/v/pi-bar.svg)](https://www.npmjs.com/package/pi-bar)
 [![npm downloads](https://img.shields.io/npm/dm/pi-bar.svg)](https://www.npmjs.com/package/pi-bar)
 
-**Never accidentally run Opus on a typo again.** pi-bar puts the active model, thinking level, and context usage in pi's footer so you catch wrong-model / wrong-reasoning / context-pressure problems before they cost you.
+**Never accidentally run Opus on a typo again.** pi-bar puts the active model, thinking level, context usage, and extension statuses in pi's footer so you catch wrong-model / wrong-reasoning / context-pressure problems before they cost you.
 
 ```text
-◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M
+◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M  ❯  ✧ plan:active
 ```
 
-![pi-bar screenshot, three rows showing green, yellow, and red context usage](https://cdn.jsdelivr.net/npm/pi-bar@0.3.0/assets/screenshot.png)
-
-> Renamed from `trifecta-footer` at 0.3.0. If you previously installed `trifecta-footer`, run `pi remove npm:trifecta-footer && pi install npm:pi-bar`.
+![pi-bar screenshot, three rows showing green, yellow, and red context usage](https://cdn.jsdelivr.net/npm/pi-bar@0.3.2/assets/screenshot.png)
 
 ## Why use it?
 
 - **See the active model at a glance** — catch accidental model switches before an expensive or sensitive task starts.
 - **Track thinking level in place** — immediately notice when you are using the wrong reasoning setting.
 - **Watch context pressure early** — context usage turns green, yellow, then red as you approach the limit.
+- **Keep extension statuses visible** — statuses set with `ctx.ui.setStatus()` still appear in the custom footer.
 
-pi-bar is intentionally tiny: one small extension, no broad behavior changes, and no commands to learn. It replaces pi's built-in footer with a compact model / thinking / context status line that refreshes when the model changes, thinking level changes, and after assistant turns.
+pi-bar is intentionally tiny: one small extension, no broad behavior changes, and no commands to learn. It replaces pi's built-in footer with a compact model / thinking / context / extension-status line that refreshes when model, thinking level, context usage, or extension statuses change.
 
 ## Install
 
@@ -40,11 +39,11 @@ pi-bar works out of the box, but you can tune it with environment variables befo
 ### Show or hide segments
 
 ```bash
-PI_BAR_SHOW=model,thinking,context pi
+PI_BAR_SHOW=model,thinking,context,extensions pi
 PI_BAR_SHOW=model,context pi
 ```
 
-Allowed segments are `model`, `thinking`, and `context`.
+Allowed segments are `model`, `thinking`, `context`, and `extensions`. The `extensions` segment is hidden when no extension has set a status.
 
 ### Change context thresholds
 
@@ -64,10 +63,10 @@ PI_BAR_ICONS=nerdfont pi
 
 Supported presets:
 
-- `unicode` — default, e.g. `◈ gpt-5.5  ❯  ✦ think:medium  ❯  ◷ 42.7% / 272k`
-- `plain` — maximum compatibility, e.g. `model:gpt-5.5 | think:medium | ctx:42.7% / 272k`
-- `emoji` — colorful emoji markers, e.g. `🤖 gpt-5.5  ›  ✨ think:medium  ›  🧭 42.7% / 272k`
-- `nerdfont` — icon-font glyphs for terminals configured with a Nerd Font, e.g. `󰊩 gpt-5.5  󰮱  󰉑 think:medium  󰮱  󰍛 42.7% / 272k`
+- `unicode` — default, e.g. `◈ gpt-5.5  ❯  ✦ think:medium  ❯  ◷ 42.7% / 272k  ❯  ✧ plan:active`
+- `plain` — maximum compatibility, e.g. `model:gpt-5.5 | think:medium | ctx:42.7% / 272k | ext:plan:active`
+- `emoji` — colorful emoji markers, e.g. `🤖 gpt-5.5  ›  ✨ think:medium  ›  🧭 42.7% / 272k  ›  🧩 plan:active`
+- `nerdfont` — icon-font glyphs for terminals configured with a Nerd Font, e.g. `󰚩 gpt-5.5    󰧑 think:medium    󰍛 42.7% / 272k    󰐱 plan:active`
 
 ## Compatibility
 
@@ -77,6 +76,11 @@ The default `unicode` preset uses common Unicode symbols that render well in mos
 PI_BAR_ICONS=plain pi
 ```
 
+## Pairs well with
+
+- **[pi-chrome](https://www.npmjs.com/package/pi-chrome)** — give your Pi agent your real, signed-in Chrome. Use pi-bar's red-context threshold as the signal to wrap up long browser scrapes before context overflows.
+- **[pi-qq](https://www.npmjs.com/package/pi-qq)** — ask side questions about what the agent just did without polluting the transcript.
+
 ## Security note
 
 Pi extensions run with your local user permissions. Review any pi package source before installing it.

package/extensions/status-footer.ts

@@ -1,17 +1,17 @@
 /**
  * pi-bar — footer/statusline extension.
  *
- * Replaces the built-in footer with three left-aligned segments:
- *   ◈ <model name> ❯ ✦ think:<level> ❯ ◷ <context% / window>
+ * Replaces the built-in footer with left-aligned segments:
+ *   ◈ <model name> ❯ ✦ think:<level> ❯ ◷ <context% / window> ❯ ✧ <extension statuses>
  *
  * Examples:
  *   ◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M
  *
- * Re-renders on model change, thinking-level change, and after each
- * assistant turn so context usage stays current.
+ * Re-renders on model change, thinking-level change, status updates,
+ * and after each assistant turn so context usage stays current.
  *
  * Configuration env vars:
- *   PI_BAR_SHOW=model,thinking,context
+ *   PI_BAR_SHOW=model,thinking,context,extensions
  *   PI_BAR_THRESHOLDS=70,90
  *   PI_BAR_ICONS=unicode|plain|emoji|nerdfont
  */
@@ -19,21 +19,56 @@
 import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth } from "@earendil-works/pi-tui";
 
-type SegmentName = "model" | "thinking" | "context";
+type SegmentName = "model" | "thinking" | "context" | "extensions";
 type IconPreset = "unicode" | "plain" | "emoji" | "nerdfont";
 
-const DEFAULT_SEGMENTS: SegmentName[] = ["model", "thinking", "context"];
+const DEFAULT_SEGMENTS: SegmentName[] = [
+	"model",
+	"thinking",
+	"context",
+	"extensions",
+];
 const DEFAULT_WARNING_THRESHOLD = 70;
 const DEFAULT_ERROR_THRESHOLD = 90;
 
 const ICON_PRESETS: Record<
 	IconPreset,
-	{ model: string; thinking: string; context: string; separator: string }
+	{
+		model: string;
+		thinking: string;
+		context: string;
+		extensions: string;
+		separator: string;
+	}
 > = {
-	unicode: { model: "◈", thinking: "✦", context: "◷", separator: "❯" },
-	plain: { model: "model", thinking: "think", context: "ctx", separator: "|" },
-	emoji: { model: "🤖", thinking: "✨", context: "🧭", separator: "›" },
-	nerdfont: { model: "󰚩", thinking: "󰧑", context: "󰍛", separator: "" },
+	unicode: {
+		model: "◈",
+		thinking: "✦",
+		context: "◷",
+		extensions: "✧",
+		separator: "❯",
+	},
+	plain: {
+		model: "model",
+		thinking: "think",
+		context: "ctx",
+		extensions: "ext",
+		separator: "|",
+	},
+	emoji: {
+		model: "🤖",
+		thinking: "✨",
+		context: "🧭",
+		extensions: "🧩",
+		separator: "›",
+	},
+	nerdfont: {
+		model: "󰚩",
+		thinking: "󰧑",
+		context: "󰍛",
+		extensions: "󰐱",
+		separator: "",
+	},
 };
 
 function formatTokens(n: number): string {
@@ -95,7 +130,7 @@ function parseSegments(): SegmentName[] {
 		.split(",")
 		.map((segment) => segment.trim().toLowerCase())
 		.filter((segment): segment is SegmentName =>
-			["model", "thinking", "context"].includes(segment),
+			["model", "thinking", "context", "extensions"].includes(segment),
 		);
 
 	return requested.length > 0 ? requested : DEFAULT_SEGMENTS;
@@ -140,6 +175,14 @@ function prefixed(icon: string, text: string, preset: IconPreset): string {
 	return `${icon} ${text}`;
 }
 
+function formatExtensionStatuses(statuses: ReadonlyMap<string, string>): string | null {
+	const parts = Array.from(statuses.entries())
+		.filter(([, text]) => text.trim().length > 0)
+		.map(([key, text]) => `${key}:${text}`);
+
+	return parts.length > 0 ? parts.join(" ") : null;
+}
+
 export default function (pi: ExtensionAPI) {
 	let requestRender: (() => void) | undefined;
 	const refresh = () => requestRender?.();
@@ -157,7 +200,7 @@ export default function (pi: ExtensionAPI) {
 		const icons = ICON_PRESETS[iconPreset];
 		const { warningThreshold, errorThreshold } = parseThresholds();
 
-		ctx.ui.setFooter((tui, theme) => {
+		ctx.ui.setFooter((tui, theme, footerData) => {
 			requestRender = () => tui.requestRender();
 
 			return {
@@ -168,6 +211,9 @@ export default function (pi: ExtensionAPI) {
 				render(width: number): string[] {
 					const modelName = formatModelName(ctx.model?.id);
 					const thinkingLevel = String(pi.getThinkingLevel());
+					const extensionStatuses = formatExtensionStatuses(
+						footerData?.getExtensionStatuses?.() ?? new Map(),
+					);
 					const usage = ctx.getContextUsage();
 					const contextSegmentColor = contextColor(
 						usage?.percent,
@@ -179,7 +225,7 @@ export default function (pi: ExtensionAPI) {
 						? `${usage.percent !== null ? `${usage.percent.toFixed(1)}%` : "—%"} / ${formatTokens(usage.contextWindow)}`
 						: "—";
 
-					const segmentRenderers: Record<SegmentName, string> = {
+					const segmentRenderers: Record<SegmentName, string | null> = {
 						model: theme.fg(
 							"accent",
 							prefixed(icons.model, modelName, iconPreset),
@@ -192,11 +238,18 @@ export default function (pi: ExtensionAPI) {
 							contextSegmentColor,
 							prefixed(icons.context, contextText, iconPreset),
 						),
+						extensions: extensionStatuses
+							? theme.fg(
+									"muted",
+									prefixed(icons.extensions, extensionStatuses, iconPreset),
+								)
+							: null,
 					};
 
 					const separator = `  ${theme.fg("dim", icons.separator)}  `;
 					const line = visibleSegments
 						.map((segment) => segmentRenderers[segment])
+						.filter((segment): segment is string => segment !== null)
 						.join(separator);
 
 					return [truncateToWidth(line, width)];

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-bar",
-  "version": "0.3.0",
-  "description": "Never accidentally run Opus on a typo. Pi footer/statusline showing active model, thinking level, and context usage.",
+  "version": "0.3.2",
+  "description": "Never accidentally run Opus on a typo. Pi footer/statusline showing active model, thinking level, context usage, and extension statuses.",
   "type": "module",
   "keywords": [
     "pi-package",
@@ -16,6 +16,14 @@
     "context-window"
   ],
   "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+ssh://git@github.com/tianrendong/pi-bar.git"
+  },
+  "bugs": {
+    "url": "https://github.com/tianrendong/pi-bar/issues"
+  },
+  "homepage": "https://github.com/tianrendong/pi-bar#readme",
   "files": [
     "assets",
     "extensions",
@@ -26,10 +34,18 @@
     "@earendil-works/pi-coding-agent": "*",
     "@earendil-works/pi-tui": "*"
   },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "@earendil-works/pi-tui": {
+      "optional": true
+    }
+  },
   "pi": {
     "extensions": [
       "./extensions/status-footer.ts"
     ],
-    "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.0/assets/screenshot.png"
+    "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.2/assets/screenshot.png"
   }
 }