pi-bar 0.3.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jenny Yu
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# pi-bar
+
+[![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.
+
+```text
+◈ claude-opus-4.7  ❯  ✦ think:med  ❯  ◷ 2.6% / 1.0M
+```
+
+![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`.
+
+## 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.
+
+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.
+
+## Install
+
+```bash
+pi install npm:pi-bar
+```
+
+If pi is already running after install, reload resources:
+
+```text
+/reload
+```
+
+## Customization
+
+pi-bar works out of the box, but you can tune it with environment variables before launching pi.
+
+### Show or hide segments
+
+```bash
+PI_BAR_SHOW=model,thinking,context pi
+PI_BAR_SHOW=model,context pi
+```
+
+Allowed segments are `model`, `thinking`, and `context`.
+
+### Change context thresholds
+
+```bash
+PI_BAR_THRESHOLDS=60,85 pi
+```
+
+The first number is the warning/yellow threshold. The second number is the danger/red threshold. Defaults are `70,90`.
+
+### Change icon style
+
+```bash
+PI_BAR_ICONS=plain pi
+PI_BAR_ICONS=emoji pi
+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`
+
+## Compatibility
+
+The default `unicode` preset uses common Unicode symbols that render well in most modern terminals. If your terminal shows boxes or misaligned glyphs, use:
+
+```bash
+PI_BAR_ICONS=plain pi
+```
+
+## Security note
+
+Pi extensions run with your local user permissions. Review any pi package source before installing it.

package/extensions/status-footer.ts

@@ -0,0 +1,211 @@
+/**
+ * pi-bar — footer/statusline extension.
+ *
+ * Replaces the built-in footer with three left-aligned segments:
+ *   ◈ <model name> ❯ ✦ think:<level> ❯ ◷ <context% / window>
+ *
+ * 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.
+ *
+ * Configuration env vars:
+ *   PI_BAR_SHOW=model,thinking,context
+ *   PI_BAR_THRESHOLDS=70,90
+ *   PI_BAR_ICONS=unicode|plain|emoji|nerdfont
+ */
+
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { truncateToWidth } from "@earendil-works/pi-tui";
+
+type SegmentName = "model" | "thinking" | "context";
+type IconPreset = "unicode" | "plain" | "emoji" | "nerdfont";
+
+const DEFAULT_SEGMENTS: SegmentName[] = ["model", "thinking", "context"];
+const DEFAULT_WARNING_THRESHOLD = 70;
+const DEFAULT_ERROR_THRESHOLD = 90;
+
+const ICON_PRESETS: Record<
+	IconPreset,
+	{ model: string; thinking: string; context: 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: "" },
+};
+
+function formatTokens(n: number): string {
+	if (n >= 1_000_000) {
+		const value = n / 1_000_000;
+		return value >= 10 ? `${Math.round(value)}M` : `${value.toFixed(1)}M`;
+	}
+	if (n >= 1_000) {
+		const value = n / 1_000;
+		return value >= 10 ? `${Math.round(value)}k` : `${value.toFixed(1)}k`;
+	}
+	return `${n}`;
+}
+
+function formatModelName(id: string | undefined): string {
+	if (!id) return "no-model";
+	const base = id.includes("/") ? (id.split("/").pop() ?? id) : id;
+	return base.replace(/-\d{8}$/, "").replace(/-\d{4}-\d{2}-\d{2}$/, "");
+}
+
+function thinkingColor(level: string): string {
+	switch (level) {
+		case "off":
+			return "thinkingOff";
+		case "minimal":
+		case "min":
+			return "thinkingMinimal";
+		case "low":
+			return "thinkingLow";
+		case "medium":
+		case "med":
+			return "thinkingMedium";
+		case "high":
+			return "thinkingHigh";
+		case "xhigh":
+		case "extra-high":
+			return "thinkingXhigh";
+		default:
+			return "thinkingText";
+	}
+}
+
+function contextColor(
+	percent: number | null | undefined,
+	warningThreshold: number,
+	errorThreshold: number,
+): string {
+	if (percent === null || percent === undefined) return "muted";
+	if (percent >= errorThreshold) return "error";
+	if (percent >= warningThreshold) return "warning";
+	return "success";
+}
+
+function parseSegments(): SegmentName[] {
+	const raw = process.env.PI_BAR_SHOW;
+	if (!raw) return DEFAULT_SEGMENTS;
+
+	const requested = raw
+		.split(",")
+		.map((segment) => segment.trim().toLowerCase())
+		.filter((segment): segment is SegmentName =>
+			["model", "thinking", "context"].includes(segment),
+		);
+
+	return requested.length > 0 ? requested : DEFAULT_SEGMENTS;
+}
+
+function parseThresholds(): { warningThreshold: number; errorThreshold: number } {
+	const raw = process.env.PI_BAR_THRESHOLDS;
+	if (!raw) {
+		return {
+			warningThreshold: DEFAULT_WARNING_THRESHOLD,
+			errorThreshold: DEFAULT_ERROR_THRESHOLD,
+		};
+	}
+
+	const [warning, error] = raw
+		.split(",")
+		.map((value) => Number.parseFloat(value.trim()));
+
+	if (
+		Number.isFinite(warning) &&
+		Number.isFinite(error) &&
+		warning >= 0 &&
+		error > warning
+	) {
+		return { warningThreshold: warning, errorThreshold: error };
+	}
+
+	return {
+		warningThreshold: DEFAULT_WARNING_THRESHOLD,
+		errorThreshold: DEFAULT_ERROR_THRESHOLD,
+	};
+}
+
+function parseIconPreset(): IconPreset {
+	const raw = process.env.PI_BAR_ICONS?.trim().toLowerCase();
+	if (raw === "plain" || raw === "emoji" || raw === "nerdfont") return raw;
+	return "unicode";
+}
+
+function prefixed(icon: string, text: string, preset: IconPreset): string {
+	if (preset === "plain") return `${icon}:${text}`;
+	return `${icon} ${text}`;
+}
+
+export default function (pi: ExtensionAPI) {
+	let requestRender: (() => void) | undefined;
+	const refresh = () => requestRender?.();
+
+	pi.on("model_select", async () => refresh());
+	pi.on("thinking_level_select", async () => refresh());
+	pi.on("turn_end", async () => refresh());
+	pi.on("message_end", async () => refresh());
+
+	pi.on("session_start", async (_event, ctx) => {
+		if (!ctx.hasUI) return;
+
+		const visibleSegments = parseSegments();
+		const iconPreset = parseIconPreset();
+		const icons = ICON_PRESETS[iconPreset];
+		const { warningThreshold, errorThreshold } = parseThresholds();
+
+		ctx.ui.setFooter((tui, theme) => {
+			requestRender = () => tui.requestRender();
+
+			return {
+				dispose() {
+					requestRender = undefined;
+				},
+				invalidate() {},
+				render(width: number): string[] {
+					const modelName = formatModelName(ctx.model?.id);
+					const thinkingLevel = String(pi.getThinkingLevel());
+					const usage = ctx.getContextUsage();
+					const contextSegmentColor = contextColor(
+						usage?.percent,
+						warningThreshold,
+						errorThreshold,
+					);
+
+					const contextText = usage
+						? `${usage.percent !== null ? `${usage.percent.toFixed(1)}%` : "—%"} / ${formatTokens(usage.contextWindow)}`
+						: "—";
+
+					const segmentRenderers: Record<SegmentName, string> = {
+						model: theme.fg(
+							"accent",
+							prefixed(icons.model, modelName, iconPreset),
+						),
+						thinking: theme.fg(
+							thinkingColor(thinkingLevel),
+							prefixed(icons.thinking, `think:${thinkingLevel}`, iconPreset),
+						),
+						context: theme.fg(
+							contextSegmentColor,
+							prefixed(icons.context, contextText, iconPreset),
+						),
+					};
+
+					const separator = `  ${theme.fg("dim", icons.separator)}  `;
+					const line = visibleSegments
+						.map((segment) => segmentRenderers[segment])
+						.join(separator);
+
+					return [truncateToWidth(line, width)];
+				},
+			};
+		});
+	});
+
+	pi.on("session_shutdown", async (_event, ctx) => {
+		if (ctx.hasUI) ctx.ui.setFooter(undefined);
+	});
+}

package/package.json

@@ -0,0 +1,35 @@
+{
+  "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.",
+  "type": "module",
+  "keywords": [
+    "pi-package",
+    "pi-extension",
+    "pi",
+    "pi-bar",
+    "footer",
+    "statusline",
+    "model",
+    "thinking",
+    "context",
+    "context-window"
+  ],
+  "license": "MIT",
+  "files": [
+    "assets",
+    "extensions",
+    "README.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "@earendil-works/pi-tui": "*"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/status-footer.ts"
+    ],
+    "image": "https://cdn.jsdelivr.net/npm/pi-bar@0.3.0/assets/screenshot.png"
+  }
+}