pi-bar 0.3.4 → 0.3.6

package/README.md

@@ -3,22 +3,23 @@
 [![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, context usage, and extension statuses 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, live TLDR, 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  ❯  ✧ plan:active
+◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M  ❯  ⓘ Inspecting package structure  ❯  ✧ plan:active
 ```
 
-![pi-bar screenshot, three rows showing green, yellow, and red context usage](https://cdn.jsdelivr.net/npm/pi-bar@0.3.4/assets/screenshot.png)
+![pi-bar screenshot, three rows showing green, yellow, and red context usage](https://cdn.jsdelivr.net/npm/pi-bar@0.3.6/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.
+- **Show pi-tldr inline** — when `pi-tldr` is installed, its current TLDR appears as a compact footer segment.
 - **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 / extension-status line that refreshes when model, thinking level, context usage, or extension statuses change.
+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 / tldr / extension-status line that refreshes when model, thinking level, context usage, pi-tldr, or extension statuses change.
 
 ## Install
 
@@ -39,11 +40,27 @@ 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,extensions pi
+PI_BAR_SHOW=model,thinking,context,tldr,extensions pi
 PI_BAR_SHOW=model,context pi
 ```
 
-Allowed segments are `model`, `thinking`, `context`, and `extensions`. The `extensions` segment is hidden when no extension has set a status.
+Allowed segments are `model`, `thinking`, `context`, `tldr`, and `extensions`. The `tldr` segment is hidden unless `pi-tldr` has a current TLDR. The `extensions` segment is hidden when no extension has set a status.
+
+### Show pi-tldr in the footer
+
+Install [pi-tldr](https://www.npmjs.com/package/pi-tldr) alongside pi-bar:
+
+```bash
+pi install npm:pi-tldr
+```
+
+pi-bar captures pi-tldr's `pi-tldr` widget and renders its current text as the `tldr` segment. Limit segment width with:
+
+```bash
+PI_BAR_TLDR_MAX_WIDTH=48 pi
+```
+
+Default is `64`. Set `PI_BAR_SHOW` without `tldr` to hide it.
 
 ### Configure extension statuses
 
@@ -56,7 +73,7 @@ Use `/bar` inside pi to open an interactive status-visibility picker.
 
 Toggle each status key between `shown` and `hidden`. The `New statuses` row controls whether status keys discovered later are shown or hidden by default.
 
-Status filter choices persist in the current session. Advanced command forms like `/bar status hide <key>` still work for scripting.
+Status filter choices persist globally across pi sessions. Set `PI_BAR_CONFIG=/path/to/config.json` before launching pi to override the default config path (`~/.pi/agent/pi-bar.json`). Advanced command forms like `/bar status hide <key>` still work for scripting.
 
 ### Change context thresholds
 
@@ -76,10 +93,10 @@ PI_BAR_ICONS=nerdfont pi
 
 Supported presets:
 
-- `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`
+- `unicode` — default, e.g. `◈ gpt-5.5  ❯  ✦ think:medium  ❯  ◷ 42.7% / 272k  ❯  ⓘ Reading files  ❯  ✧ plan:active`
+- `plain` — maximum compatibility, e.g. `model:gpt-5.5 | think:medium | ctx:42.7% / 272k | tldr:Reading files | ext:plan:active`
+- `emoji` — colorful emoji markers, e.g. `🤖 gpt-5.5  ›  ✨ think:medium  ›  🧭 42.7% / 272k  ›  📝 Reading files  ›  🧩 plan:active`
+- `nerdfont` — icon-font glyphs for terminals configured with a Nerd Font, e.g. `󰚩 gpt-5.5    󰧑 think:medium    󰍛 42.7% / 272k    󰦨 Reading files    󰐱 plan:active`
 
 ## Compatibility
 
@@ -91,6 +108,7 @@ PI_BAR_ICONS=plain pi
 
 ## Pairs well with
 
+- **[pi-tldr](https://www.npmjs.com/package/pi-tldr)** — show live summaries above the input bar; pi-bar mirrors them into the footer.
 - **[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.
 

package/extensions/status-footer.ts

@@ -2,7 +2,7 @@
  * pi-bar — footer/statusline extension.
  *
  * Replaces the built-in footer with left-aligned segments:
- *   ◈ <model name> ❯ ✦ think:<level> ❯ ◷ <context% / window> ❯ ✧ <extension statuses>
+ *   ◈ <model name> ❯ ✦ think:<level> ❯ ◷ <context% / window> ❯ ⓘ <tldr> ❯ ✧ <extension statuses>
  *
  * Examples:
  *   ◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M
@@ -11,24 +11,32 @@
  * and after each assistant turn so context usage stays current.
  *
  * Configuration env vars:
- *   PI_BAR_SHOW=model,thinking,context,extensions
+ *   PI_BAR_SHOW=model,thinking,context,tldr,extensions
  *   PI_BAR_THRESHOLDS=70,90
  *   PI_BAR_ICONS=unicode|plain|emoji|nerdfont
+ *   PI_BAR_TLDR_MAX_WIDTH=64
  */
 
+import { mkdirSync, readFileSync, renameSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { dirname, join } from "node:path";
 import {
 	getSettingsListTheme,
 	type ExtensionAPI,
 	type ExtensionContext,
+	type Theme,
+	type ThemeColor,
 } from "@earendil-works/pi-coding-agent";
 import {
 	Container,
+	type Component,
 	type SettingItem,
 	SettingsList,
+	type TUI,
 	truncateToWidth,
 } from "@earendil-works/pi-tui";
 
-type SegmentName = "model" | "thinking" | "context" | "extensions";
+type SegmentName = "model" | "thinking" | "context" | "tldr" | "extensions";
 type IconPreset = "unicode" | "plain" | "emoji" | "nerdfont";
 type StatusFilter =
 	| { mode: "all"; hidden: Set<string> }
@@ -36,13 +44,25 @@ type StatusFilter =
 type SerializedStatusFilter =
 	| { mode: "all"; hidden: string[] }
 	| { mode: "only"; shown: string[] };
+type TldrWidgetFactory = (tui: TUI, theme: Theme) => Component & {
+	dispose?(): void;
+};
+type CapturedTldrWidget =
+	| { kind: "lines"; lines: string[] }
+	| { kind: "factory"; factory: TldrWidgetFactory };
 
 const STATUS_FILTER_ENTRY_TYPE = "pi-bar-status-filter";
+const TLDR_WIDGET_KEY = "pi-tldr";
+const DEFAULT_TLDR_MAX_WIDTH = 64;
+const ANSI_PATTERN = /\x1B\[[0-?]*[ -/]*[@-~]/g;
+const CONFIG_PATH =
+	process.env.PI_BAR_CONFIG ?? join(homedir(), ".pi", "agent", "pi-bar.json");
 
 const DEFAULT_SEGMENTS: SegmentName[] = [
 	"model",
 	"thinking",
 	"context",
+	"tldr",
 	"extensions",
 ];
 const DEFAULT_WARNING_THRESHOLD = 70;
@@ -54,6 +74,7 @@ const ICON_PRESETS: Record<
 		model: string;
 		thinking: string;
 		context: string;
+		tldr: string;
 		extensions: string;
 		separator: string;
 	}
@@ -62,6 +83,7 @@ const ICON_PRESETS: Record<
 		model: "◈",
 		thinking: "✦",
 		context: "◷",
+		tldr: "ⓘ",
 		extensions: "✧",
 		separator: "❯",
 	},
@@ -69,6 +91,7 @@ const ICON_PRESETS: Record<
 		model: "model",
 		thinking: "think",
 		context: "ctx",
+		tldr: "tldr",
 		extensions: "ext",
 		separator: "|",
 	},
@@ -76,6 +99,7 @@ const ICON_PRESETS: Record<
 		model: "🤖",
 		thinking: "✨",
 		context: "🧭",
+		tldr: "📝",
 		extensions: "🧩",
 		separator: "›",
 	},
@@ -83,6 +107,7 @@ const ICON_PRESETS: Record<
 		model: "󰚩",
 		thinking: "󰧑",
 		context: "󰍛",
+		tldr: "󰦨",
 		extensions: "󰐱",
 		separator: "",
 	},
@@ -106,7 +131,7 @@ function formatModelName(id: string | undefined): string {
 	return base.replace(/-\d{8}$/, "").replace(/-\d{4}-\d{2}-\d{2}$/, "");
 }
 
-function thinkingColor(level: string): string {
+function thinkingColor(level: string): ThemeColor {
 	switch (level) {
 		case "off":
 			return "thinkingOff";
@@ -132,7 +157,7 @@ function contextColor(
 	percent: number | null | undefined,
 	warningThreshold: number,
 	errorThreshold: number,
-): string {
+): ThemeColor {
 	if (percent === null || percent === undefined) return "muted";
 	if (percent >= errorThreshold) return "error";
 	if (percent >= warningThreshold) return "warning";
@@ -147,7 +172,7 @@ function parseSegments(): SegmentName[] {
 		.split(",")
 		.map((segment) => segment.trim().toLowerCase())
 		.filter((segment): segment is SegmentName =>
-			["model", "thinking", "context", "extensions"].includes(segment),
+			["model", "thinking", "context", "tldr", "extensions"].includes(segment),
 		);
 
 	return requested.length > 0 ? requested : DEFAULT_SEGMENTS;
@@ -187,6 +212,63 @@ function parseIconPreset(): IconPreset {
 	return "unicode";
 }
 
+function parseTldrMaxWidth(): number {
+	const raw = process.env.PI_BAR_TLDR_MAX_WIDTH;
+	if (!raw) return DEFAULT_TLDR_MAX_WIDTH;
+
+	const value = Number.parseInt(raw, 10);
+	if (Number.isFinite(value) && value >= 10 && value <= 500) return value;
+	return DEFAULT_TLDR_MAX_WIDTH;
+}
+
+function stripAnsi(value: string): string {
+	return value.replace(ANSI_PATTERN, "");
+}
+
+function extractTldrText(lines: readonly string[]): string | null {
+	const parts = lines
+		.map(stripAnsi)
+		.map((line) => line.trimEnd())
+		.filter((line) => line.trim().length > 0)
+		.filter((line) => !/^[╭╰].*[╮╯]$/.test(line.trim()))
+		.map((line) => {
+			const trimmed = line.trim();
+			if (trimmed.startsWith("│") && trimmed.endsWith("│")) {
+				return trimmed.slice(1, -1).trim();
+			}
+			return trimmed.replace(/^tldr:\s*/i, "").trim();
+		})
+		.filter(Boolean);
+
+	const text = parts.join(" ").replace(/\s+/g, " ").trim();
+	return text.length > 0 ? text : null;
+}
+
+function renderCapturedTldr(
+	widget: CapturedTldrWidget | undefined,
+	tui: TUI,
+	theme: Theme,
+	width: number,
+	maxWidth: number,
+): string | null {
+	if (!widget) return null;
+
+	let lines: string[];
+	if (widget.kind === "lines") {
+		lines = widget.lines;
+	} else {
+		const component = widget.factory(tui, theme);
+		try {
+			lines = component.render(Math.max(12, width));
+		} finally {
+			component.dispose?.();
+		}
+	}
+
+	const text = extractTldrText(lines);
+	return text ? truncateToWidth(text, maxWidth) : null;
+}
+
 function prefixed(icon: string, text: string, preset: IconPreset): string {
 	if (preset === "plain") return `${icon}:${text}`;
 	return `${icon} ${text}`;
@@ -250,6 +332,29 @@ function describeStatusFilter(filter: StatusFilter): string {
 	return hidden.length > 0 ? `showing all except: ${hidden.join(", ")}` : "showing all";
 }
 
+function readGlobalStatusFilter(): StatusFilter | null {
+	try {
+		const data = JSON.parse(readFileSync(CONFIG_PATH, "utf8")) as {
+			statusFilter?: unknown;
+		};
+		return parseSerializedStatusFilter(data.statusFilter ?? data);
+	} catch {
+		return null;
+	}
+}
+
+function writeGlobalStatusFilter(filter: StatusFilter): void {
+	const data = JSON.stringify(
+		{ statusFilter: serializeStatusFilter(filter) },
+		null,
+		2,
+	);
+	mkdirSync(dirname(CONFIG_PATH), { recursive: true });
+	const tmpPath = `${CONFIG_PATH}.${process.pid}.tmp`;
+	writeFileSync(tmpPath, `${data}\n`, "utf8");
+	renameSync(tmpPath, CONFIG_PATH);
+}
+
 function getKnownStatusKeys(filter: StatusFilter, seenStatusKeys: Set<string>): string[] {
 	const keys = new Set(seenStatusKeys);
 	if (filter.mode === "only") {
@@ -263,19 +368,52 @@ function getKnownStatusKeys(filter: StatusFilter, seenStatusKeys: Set<string>):
 export default function (pi: ExtensionAPI) {
 	let requestRender: (() => void) | undefined;
 	let statusFilter: StatusFilter = { mode: "all", hidden: new Set() };
+	let capturedTldrWidget: CapturedTldrWidget | undefined;
 	const seenStatusKeys = new Set<string>();
+	const patchedUis = new WeakSet<object>();
 	const refresh = () => requestRender?.();
+	const installTldrWidgetCapture = (ctx: ExtensionContext) => {
+		if (!ctx.hasUI) return;
+		const ui = ctx.ui as ExtensionContext["ui"];
+		if (patchedUis.has(ui)) return;
+		patchedUis.add(ui);
+
+		const originalSetWidget = ui.setWidget.bind(ui);
+		ui.setWidget = ((key: string, content: unknown, options?: unknown) => {
+			if (key === TLDR_WIDGET_KEY) {
+				if (Array.isArray(content)) {
+					capturedTldrWidget = { kind: "lines", lines: content };
+				} else if (typeof content === "function") {
+					capturedTldrWidget = {
+						kind: "factory",
+						factory: content as TldrWidgetFactory,
+					};
+				} else {
+					capturedTldrWidget = undefined;
+				}
+				refresh();
+			}
+
+			return originalSetWidget(
+				key,
+				content as Parameters<ExtensionContext["ui"]["setWidget"]>[1],
+				options as Parameters<ExtensionContext["ui"]["setWidget"]>[2],
+			);
+		}) as ExtensionContext["ui"]["setWidget"];
+	};
 	const restoreStatusFilter = (ctx: ExtensionContext) => {
-		let restoredFilter: StatusFilter | null = null;
-		for (const entry of ctx.sessionManager.getBranch()) {
-			if (entry.type === "custom" && entry.customType === STATUS_FILTER_ENTRY_TYPE) {
-				restoredFilter = parseSerializedStatusFilter(entry.data);
+		let restoredFilter = readGlobalStatusFilter();
+		if (!restoredFilter) {
+			for (const entry of ctx.sessionManager.getBranch()) {
+				if (entry.type === "custom" && entry.customType === STATUS_FILTER_ENTRY_TYPE) {
+					restoredFilter = parseSerializedStatusFilter(entry.data);
+				}
 			}
 		}
 		statusFilter = restoredFilter ?? { mode: "all", hidden: new Set() };
 	};
 	const persistStatusFilter = () => {
-		pi.appendEntry(STATUS_FILTER_ENTRY_TYPE, serializeStatusFilter(statusFilter));
+		writeGlobalStatusFilter(statusFilter);
 		refresh();
 	};
 	const openStatusConfigurator = async (ctx: ExtensionContext) => {
@@ -451,11 +589,14 @@ export default function (pi: ExtensionAPI) {
 	pi.on("turn_end", async () => refresh());
 	pi.on("message_end", async () => refresh());
 	pi.on("session_tree", async (_event, ctx) => {
+		installTldrWidgetCapture(ctx);
 		restoreStatusFilter(ctx);
 		refresh();
 	});
 
 	pi.on("session_start", async (_event, ctx) => {
+		capturedTldrWidget = undefined;
+		installTldrWidgetCapture(ctx);
 		restoreStatusFilter(ctx);
 
 		if (!ctx.hasUI) return;
@@ -464,6 +605,7 @@ export default function (pi: ExtensionAPI) {
 		const iconPreset = parseIconPreset();
 		const icons = ICON_PRESETS[iconPreset];
 		const { warningThreshold, errorThreshold } = parseThresholds();
+		const tldrMaxWidth = parseTldrMaxWidth();
 
 		ctx.ui.setFooter((tui, theme, footerData) => {
 			requestRender = () => tui.requestRender();
@@ -491,6 +633,13 @@ export default function (pi: ExtensionAPI) {
 					const contextText = usage
 						? `${usage.percent !== null ? `${usage.percent.toFixed(1)}%` : "—%"} / ${formatTokens(usage.contextWindow)}`
 						: "—";
+					const tldrText = renderCapturedTldr(
+						capturedTldrWidget,
+						tui,
+						theme,
+						width,
+						tldrMaxWidth,
+					);
 
 					const segmentRenderers: Record<SegmentName, string | null> = {
 						model: theme.fg(
@@ -505,6 +654,9 @@ export default function (pi: ExtensionAPI) {
 							contextSegmentColor,
 							prefixed(icons.context, contextText, iconPreset),
 						),
+						tldr: tldrText
+							? theme.fg("muted", prefixed(icons.tldr, tldrText, iconPreset))
+							: null,
 						extensions: extensionStatuses
 							? theme.fg(
 									"muted",
@@ -526,6 +678,7 @@ export default function (pi: ExtensionAPI) {
 	});
 
 	pi.on("session_shutdown", async (_event, ctx) => {
+		capturedTldrWidget = undefined;
 		if (ctx.hasUI) ctx.ui.setFooter(undefined);
 	});
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "pi-bar",
-  "version": "0.3.4",
-  "description": "Never accidentally run Opus on a typo. Pi footer/statusline showing active model, thinking level, context usage, and extension statuses.",
+  "version": "0.3.6",
+  "description": "Never accidentally run Opus on a typo. Pi footer/statusline showing active model, thinking level, context usage, pi-tldr, and extension statuses.",
   "type": "module",
   "keywords": [
     "pi-package",
@@ -13,7 +13,9 @@
     "model",
     "thinking",
     "context",
-    "context-window"
+    "context-window",
+    "tldr",
+    "pi-tldr"
   ],
   "license": "MIT",
   "repository": {
@@ -46,6 +48,6 @@
     "extensions": [
       "./extensions/status-footer.ts"
     ],
-    "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.4/assets/screenshot.png"
+    "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.6/assets/screenshot.png"
   }
 }