pi-zentui 0.1.11 → 0.1.13

package/README.md

@@ -22,6 +22,8 @@ Zentui brings two popular aesthetics to Pi:
 - `[!?↑]` — git status indicators (modified, untracked, ahead/behind, stashed, etc.)
 - `via  v5.5.0` — runtime detection with version and Starship-style Nerd Font runtime/language modules
 - Right side shows context usage, token counts, and cost
+- Third-party Pi extension statuses from `ctx.ui.setStatus()` can be shown on the left,
+  middle, or right side, or hidden per status key from `/zentui`
 
 ### Editor (Opencode-inspired)
 
@@ -121,7 +123,7 @@ pi install git:github.com/lmilojevicc/pi-zentui
 
 ## Config
 
-User config lives at `~/.pi/agent/zentui.json`. The file is optional: missing or invalid known values fall back to Zentui defaults, unknown keys are ignored at runtime, and `/zentui` currently patches only color-source settings.
+User config lives at `~/.pi/agent/zentui.json`. The file is optional: missing or invalid known values fall back to Zentui defaults, unknown keys are ignored at runtime, and `/zentui` can patch color-source settings plus active third-party status placements.
 
 Default config values — copy this and change any value you want:
 
@@ -152,6 +154,7 @@ Default config values — copy this and change any value you want:
 		"contextError": "bold red",
 		"tokens": "bright-black",
 		"cost": "bold green",
+		"extensionStatus": "bright-black",
 		"separator": "bright-black",
 		"runtimePrefix": "",
 		"editorAccent": "accent",
@@ -169,6 +172,10 @@ Default config values — copy this and change any value you want:
 		"starship": "theme",
 		"editor": "theme",
 		"userMessages": "theme"
+	},
+	"extensionStatuses": {
+		"defaultPlacement": "right",
+		"placements": {}
 	}
 }
 ```
@@ -177,6 +184,7 @@ Default config values — copy this and change any value you want:
 - `projectRefreshIntervalMs`: project status polling interval; `0` disables polling.
 - `icons`: every shown icon key is configurable; omit any key to use the Zentui default.
 - `colorSources`: `theme` maps styles through Pi theme tokens; `terminal` emits terminal colors. `/zentui` switches these sources; manual JSON controls specific style values.
+- `extensionStatuses`: controls third-party statuses published by other Pi extensions through `ctx.ui.setStatus()`. `defaultPlacement` and each `placements` value can be `off`, `left`, `middle`, or `right`. `/zentui` lists only statuses that are currently active.
 - The shown `editor*` values match the default `theme` source. Omit those keys to keep Zentui's source-aware defaults when switching between `theme` and `terminal`.
 - `editorAccent` styles the active editor rail and previous user-message rail.
 - `editorBorder` styles the active editor and previous user-message top/bottom border color only; the border glyph stays `─`.

package/extensions/zentui/config.ts

@@ -12,6 +12,13 @@ export type ColorSourcesConfig = {
 	userMessages: ColorSource;
 };
 
+export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
+
+export type ExtensionStatusesConfig = {
+	defaultPlacement: ExtensionStatusPlacement;
+	placements: Record<string, ExtensionStatusPlacement>;
+};
+
 const DEFAULT_PROJECT_REFRESH_INTERVAL_MS = 30_000;
 const MIN_PROJECT_REFRESH_INTERVAL_MS = 5_000;
 
@@ -43,6 +50,7 @@ export type PolishedTuiConfig = {
 		cost: ColorSpec;
 		separator: ColorSpec;
 		runtimePrefix: ColorSpec;
+		extensionStatus: ColorSpec;
 		editorAccent?: ColorSpec;
 		editorBorder?: ColorSpec;
 		editorModel?: ColorSpec;
@@ -55,6 +63,7 @@ export type PolishedTuiConfig = {
 		editorThinkingXhigh?: ColorSpec;
 	};
 	colorSources: ColorSourcesConfig;
+	extensionStatuses: ExtensionStatusesConfig;
 };
 
 export const configPath = join(getAgentDir(), "zentui.json");
@@ -87,12 +96,17 @@ export const defaultConfig: PolishedTuiConfig = {
 		cost: "bold green",
 		separator: "bright-black",
 		runtimePrefix: "",
+		extensionStatus: "bright-black",
 	},
 	colorSources: {
 		starship: "theme",
 		editor: "theme",
 		userMessages: "theme",
 	},
+	extensionStatuses: {
+		defaultPlacement: "right",
+		placements: {},
+	},
 };
 
 const iconKeys = [
@@ -178,6 +192,7 @@ function normalizeColors(record: Record<string, unknown>): Partial<PolishedTuiCo
 		cost: colorValue(record, "cost"),
 		separator: colorValue(record, "separator"),
 		runtimePrefix: colorValue(record, "runtimePrefix"),
+		extensionStatus: colorValue(record, "extensionStatus"),
 		editorAccent: colorValue(record, "editorAccent"),
 		editorBorder: colorValue(record, "editorBorder"),
 		editorModel: colorValue(record, "editorModel"),
@@ -199,6 +214,29 @@ function normalizeColorSources(record: Record<string, unknown>): ColorSourcesCon
 	};
 }
 
+export function isExtensionStatusPlacement(value: unknown): value is ExtensionStatusPlacement {
+	return value === "off" || value === "left" || value === "middle" || value === "right";
+}
+
+function normalizeExtensionStatuses(record: Record<string, unknown>): ExtensionStatusesConfig {
+	const defaultPlacement = isExtensionStatusPlacement(record.defaultPlacement)
+		? record.defaultPlacement
+		: defaultConfig.extensionStatuses.defaultPlacement;
+	const placements = isRecord(record.placements)
+		? Object.fromEntries(
+				Object.entries(record.placements).filter(
+					(entry): entry is [string, ExtensionStatusPlacement] =>
+						isExtensionStatusPlacement(entry[1]),
+				),
+			)
+		: {};
+
+	return {
+		defaultPlacement,
+		placements,
+	};
+}
+
 function isColorSourceKey(value: string): value is keyof ColorSourcesConfig {
 	return value === "starship" || value === "editor" || value === "userMessages";
 }
@@ -240,6 +278,9 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 	const colorSources = isRecord(config.colorSources)
 		? normalizeColorSources(config.colorSources as Record<string, unknown>)
 		: defaultConfig.colorSources;
+	const extensionStatuses = isRecord(config.extensionStatuses)
+		? normalizeExtensionStatuses(config.extensionStatuses as Record<string, unknown>)
+		: defaultConfig.extensionStatuses;
 	return {
 		projectRefreshIntervalMs: parseProjectRefreshIntervalMs(config.projectRefreshIntervalMs),
 		icons: {
@@ -251,9 +292,20 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 			...colors,
 		},
 		colorSources: { ...colorSources },
+		extensionStatuses: {
+			defaultPlacement: extensionStatuses.defaultPlacement,
+			placements: { ...extensionStatuses.placements },
+		},
 	};
 }
 
+export function getExtensionStatusPlacement(
+	config: PolishedTuiConfig,
+	key: string,
+): ExtensionStatusPlacement {
+	return config.extensionStatuses.placements[key] ?? config.extensionStatuses.defaultPlacement;
+}
+
 export function loadConfig(): PolishedTuiConfig {
 	try {
 		if (!existsSync(configPath)) return mergeConfig({});
@@ -278,3 +330,31 @@ export function saveColorSourcesPatch(
 	writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, "utf8");
 	return mergeConfig(record);
 }
+
+export function saveExtensionStatusPlacement(
+	key: string,
+	placement: ExtensionStatusPlacement,
+	path = configPath,
+): PolishedTuiConfig {
+	const record = readConfigRecord(path);
+	const existingExtensionStatuses = isRecord(record.extensionStatuses)
+		? { ...(record.extensionStatuses as Record<string, unknown>) }
+		: {};
+	const existingPlacements = isRecord(existingExtensionStatuses.placements)
+		? { ...(existingExtensionStatuses.placements as Record<string, unknown>) }
+		: {};
+
+	Object.defineProperty(existingPlacements, key, {
+		value: placement,
+		enumerable: true,
+		configurable: true,
+		writable: true,
+	});
+
+	record.extensionStatuses = {
+		...existingExtensionStatuses,
+		placements: existingPlacements,
+	};
+	writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+	return mergeConfig(record);
+}

package/extensions/zentui/extension-status.ts

@@ -0,0 +1,53 @@
+import { stripVTControlCharacters } from "node:util";
+import type { ExtensionStatusPlacement, PolishedTuiConfig } from "./config";
+import { getExtensionStatusPlacement } from "./config";
+
+export type ExtensionStatusSegment = {
+	key: string;
+	text: string;
+	placement: ExtensionStatusPlacement;
+};
+
+export type ExtensionStatusSegmentsByPlacement = {
+	left: ExtensionStatusSegment[];
+	middle: ExtensionStatusSegment[];
+	right: ExtensionStatusSegment[];
+};
+
+function compareKeys(a: ExtensionStatusSegment, b: ExtensionStatusSegment): number {
+	return a.key < b.key ? -1 : a.key > b.key ? 1 : 0;
+}
+
+export function sanitizeExtensionStatusText(value: string): string {
+	return stripVTControlCharacters(value)
+		.replace(/[\r\n\t\f\v]+/g, " ")
+		.replace(/[\u0000-\u001f\u007f-\u009f]/g, "")
+		.replace(/\s+/g, " ")
+		.trim();
+}
+
+export function collectExtensionStatusSegments(
+	statuses: ReadonlyMap<string, string>,
+	config: PolishedTuiConfig,
+): ExtensionStatusSegmentsByPlacement {
+	const segments: ExtensionStatusSegmentsByPlacement = {
+		left: [],
+		middle: [],
+		right: [],
+	};
+
+	for (const [key, value] of statuses.entries()) {
+		const placement = getExtensionStatusPlacement(config, key);
+		if (placement === "off") continue;
+
+		const text = sanitizeExtensionStatusText(value);
+		if (!text) continue;
+
+		segments[placement].push({ key, text, placement });
+	}
+
+	segments.left.sort(compareKeys);
+	segments.middle.sort(compareKeys);
+	segments.right.sort(compareKeys);
+	return segments;
+}

package/extensions/zentui/footer.ts

@@ -1,10 +1,129 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { PolishedTuiConfig } from "./config";
+import { collectExtensionStatusSegments } from "./extension-status";
 import { formatCwdLabel, formatRuntimeSegment } from "./format";
 import type { FooterState } from "./state";
 import { renderStyleForSource } from "./style";
 
+function joinStatusTexts(statusTexts: string[], separator: string): string {
+	return statusTexts.filter(Boolean).join(separator);
+}
+
+function fitStatusTexts(statusTexts: string[], maxWidth: number, separator: string): string {
+	if (maxWidth <= 0) return "";
+
+	const fitted: string[] = [];
+	for (const text of statusTexts) {
+		const candidate = joinStatusTexts([...fitted, text], separator);
+		if (visibleWidth(candidate) <= maxWidth) {
+			fitted.push(text);
+			continue;
+		}
+
+		if (fitted.length === 0) {
+			return maxWidth > 1 ? truncateToWidth(text, maxWidth, "…") : "";
+		}
+		break;
+	}
+
+	return joinStatusTexts(fitted, separator);
+}
+
+function appendStatusArea(base: string, statusText: string, separator: string): string {
+	if (!base) return statusText;
+	if (!statusText) return base;
+	return `${base}${separator}${statusText}`;
+}
+
+function prependStatusArea(base: string, statusText: string, separator: string): string {
+	if (!base) return statusText;
+	if (!statusText) return base;
+	return `${statusText}${separator}${base}`;
+}
+
+function composeBuiltInFooterContent(left: string, right: string, innerWidth: number): string {
+	const leftWidth = visibleWidth(left);
+	const rightWidth = visibleWidth(right);
+	return leftWidth >= innerWidth
+		? truncateToWidth(left, innerWidth, "")
+		: leftWidth + 1 + rightWidth <= innerWidth
+			? `${left}${" ".repeat(innerWidth - leftWidth - rightWidth)}${right}`
+			: truncateToWidth(left, innerWidth, "");
+}
+
+function composeFooterContent(
+	builtInLeft: string,
+	builtInRight: string,
+	extensionLeft: string[],
+	extensionMiddle: string[],
+	extensionRight: string[],
+	separator: string,
+	innerWidth: number,
+): string {
+	const builtInLeftWidth = visibleWidth(builtInLeft);
+	const builtInRightWidth = visibleWidth(builtInRight);
+	const minimumGap = builtInLeft && builtInRight ? 1 : 0;
+
+	if (builtInLeftWidth + minimumGap + builtInRightWidth > innerWidth) {
+		return composeBuiltInFooterContent(builtInLeft, builtInRight, innerWidth);
+	}
+
+	const available = Math.max(0, innerWidth - builtInLeftWidth - builtInRightWidth - minimumGap);
+	let remaining = available;
+	const leftConnectorWidth = builtInLeft && extensionLeft.length > 0 ? visibleWidth(separator) : 0;
+	const rightConnectorWidth =
+		builtInRight && extensionRight.length > 0 ? visibleWidth(separator) : 0;
+	let leftStatus = "";
+	let rightStatus = "";
+
+	if (extensionLeft.length > 0 && extensionRight.length > 0) {
+		const leftBudget = Math.max(0, Math.floor(available / 2) - leftConnectorWidth);
+		leftStatus = fitStatusTexts(extensionLeft, leftBudget, separator);
+		remaining -= leftStatus ? leftConnectorWidth + visibleWidth(leftStatus) : 0;
+
+		const rightBudget = Math.max(0, remaining - rightConnectorWidth);
+		rightStatus = fitStatusTexts(extensionRight, rightBudget, separator);
+		remaining -= rightStatus ? rightConnectorWidth + visibleWidth(rightStatus) : 0;
+
+		const expandedLeftBudget = Math.max(0, remaining + visibleWidth(leftStatus));
+		const expandedLeftStatus = fitStatusTexts(extensionLeft, expandedLeftBudget, separator);
+		if (visibleWidth(expandedLeftStatus) > visibleWidth(leftStatus)) {
+			remaining += leftStatus ? leftConnectorWidth + visibleWidth(leftStatus) : 0;
+			leftStatus = expandedLeftStatus;
+			remaining -= leftStatus ? leftConnectorWidth + visibleWidth(leftStatus) : 0;
+		}
+	} else if (extensionLeft.length > 0) {
+		leftStatus = fitStatusTexts(
+			extensionLeft,
+			Math.max(0, available - leftConnectorWidth),
+			separator,
+		);
+		remaining -= leftStatus ? leftConnectorWidth + visibleWidth(leftStatus) : 0;
+	} else if (extensionRight.length > 0) {
+		rightStatus = fitStatusTexts(
+			extensionRight,
+			Math.max(0, available - rightConnectorWidth),
+			separator,
+		);
+		remaining -= rightStatus ? rightConnectorWidth + visibleWidth(rightStatus) : 0;
+	}
+
+	const left = appendStatusArea(builtInLeft, leftStatus, separator);
+	const right = prependStatusArea(builtInRight, rightStatus, separator);
+	const gapWidth = Math.max(0, innerWidth - visibleWidth(left) - visibleWidth(right));
+	const middle = fitStatusTexts(extensionMiddle, gapWidth, separator);
+	const middleWidth = visibleWidth(middle);
+
+	if (!middle || middleWidth <= 0) {
+		return `${left}${" ".repeat(gapWidth)}${right}`;
+	}
+
+	const leftPadding = Math.floor((gapWidth - middleWidth) / 2);
+	const rightPadding = gapWidth - middleWidth - leftPadding;
+	return `${left}${" ".repeat(leftPadding)}${middle}${" ".repeat(rightPadding)}${right}`;
+}
+
 export function installFooter(
 	ctx: ExtensionContext,
 	state: FooterState,
@@ -12,10 +131,12 @@ export function installFooter(
 	hooks: {
 		setRequestRender: (fn: (() => void) | undefined) => void;
 		scheduleProjectRefresh: (ctx: ExtensionContext) => void;
+		setExtensionStatusesGetter?: (fn: (() => ReadonlyMap<string, string>) | undefined) => void;
 	},
 ): void {
 	ctx.ui.setFooter((tui, theme, footerData) => {
 		hooks.setRequestRender(() => tui.requestRender());
+		hooks.setExtensionStatusesGetter?.(() => footerData.getExtensionStatuses());
 		const unsubscribeBranch = footerData.onBranchChange(() => {
 			hooks.scheduleProjectRefresh(ctx);
 			tui.requestRender();
@@ -25,6 +146,7 @@ export function installFooter(
 			dispose: () => {
 				unsubscribeBranch();
 				hooks.setRequestRender(undefined);
+				hooks.setExtensionStatusesGetter?.(undefined);
 			},
 			invalidate() {},
 			render(width: number): string[] {
@@ -92,15 +214,21 @@ export function installFooter(
 					renderStyleForSource(theme, colorSource, config.colors.tokens, state.tokenLabel),
 					renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel),
 				].join(separator);
-
-				const leftWidth = visibleWidth(left);
-				const rightWidth = visibleWidth(right);
-				const content =
-					leftWidth >= innerWidth
-						? truncateToWidth(left, innerWidth, "")
-						: leftWidth + 1 + rightWidth <= innerWidth
-							? `${left}${" ".repeat(innerWidth - leftWidth - rightWidth)}${right}`
-							: truncateToWidth(left, innerWidth, "");
+				const extensionStatuses = collectExtensionStatusSegments(
+					footerData.getExtensionStatuses(),
+					config,
+				);
+				const renderExtensionStatus = (text: string) =>
+					renderStyleForSource(theme, colorSource, config.colors.extensionStatus, text);
+				const content = composeFooterContent(
+					left,
+					right,
+					extensionStatuses.left.map((segment) => renderExtensionStatus(segment.text)),
+					extensionStatuses.middle.map((segment) => renderExtensionStatus(segment.text)),
+					extensionStatuses.right.map((segment) => renderExtensionStatus(segment.text)),
+					separator,
+					innerWidth,
+				);
 				const framed = width > 2 ? ` ${truncateToWidth(content, width - 2, "")} ` : content;
 				return [truncateToWidth(framed, width, "")];
 			},

package/extensions/zentui/format.ts

@@ -11,9 +11,11 @@ export type UsageTotals = {
 };
 
 export function formatCount(value: number): string {
-	if (value < 1000) return `${value}`;
+	if (value < 1000) return value.toString();
 	if (value < 10_000) return `${(value / 1000).toFixed(1)}k`;
-	return `${Math.round(value / 1000)}k`;
+	if (value < 1_000_000) return `${Math.round(value / 1000)}k`;
+	if (value < 10_000_000) return `${(value / 1_000_000).toFixed(1)}M`;
+	return `${Math.round(value / 1_000_000)}M`;
 }
 
 export function formatProviderLabel(provider: string | undefined): string {
@@ -38,19 +40,23 @@ export function getUsageTotals(ctx: ExtensionContext): UsageTotals {
 	let output = 0;
 	let cost = 0;
 
-	for (const entry of ctx.sessionManager.getBranch()) {
+	const entries = ctx.sessionManager.getEntries?.() ?? ctx.sessionManager.getBranch();
+	for (const entry of entries) {
 		if (entry.type !== "message" || entry.message.role !== "assistant") continue;
-		const message = entry.message as AssistantMessage;
-		input += message.usage?.input ?? 0;
-		output += message.usage?.output ?? 0;
-		cost += message.usage?.cost?.total ?? 0;
+		const usage = (entry.message as AssistantMessage).usage;
+		input += usage?.input ?? 0;
+		output += usage?.output ?? 0;
+		cost += usage?.cost?.total ?? 0;
 	}
 
 	return { input, output, cost };
 }
 
 export function buildTokenLabel(totals: UsageTotals): string {
-	return `↑${formatCount(totals.input)} ↓${formatCount(totals.output)}`;
+	const parts: string[] = [];
+	if (totals.input) parts.push(`↑${formatCount(totals.input)}`);
+	if (totals.output) parts.push(`↓${formatCount(totals.output)}`);
+	return parts.length > 0 ? parts.join(" ") : "↑0 ↓0";
 }
 
 export function buildCostLabel(totals: UsageTotals): string {

package/extensions/zentui/index.ts

@@ -7,10 +7,12 @@ import type {
 import type { EditorTheme, TUI } from "@earendil-works/pi-tui";
 import {
 	type ColorSourcesConfig,
+	type ExtensionStatusPlacement,
 	type PolishedTuiConfig,
 	ensureConfigExists,
 	loadConfig,
 	saveColorSourcesPatch,
+	saveExtensionStatusPlacement,
 } from "./config";
 import { installFooter } from "./footer";
 import { emptyGitStatus, readGitStatus } from "./git";
@@ -28,6 +30,7 @@ export default function (pi: ExtensionAPI) {
 	let currentConfig: PolishedTuiConfig = loadConfig();
 	let activeTheme: Theme | undefined;
 	let requestFooterRender: (() => void) | undefined;
+	let getActiveExtensionStatuses: () => ReadonlyMap<string, string> = () => new Map();
 	let stopRefreshInterval: StopProjectRefreshInterval = () => {};
 	let cleanupPrototypePatches: () => void = () => {};
 	let projectRefreshInFlight = false;
@@ -109,6 +112,9 @@ export default function (pi: ExtensionAPI) {
 				requestFooterRender = fn;
 			},
 			scheduleProjectRefresh,
+			setExtensionStatusesGetter(fn) {
+				getActiveExtensionStatuses = fn ?? (() => new Map());
+			},
 		});
 		installEditor(ctx);
 		stopRefreshInterval = startProjectRefreshInterval(currentConfig.projectRefreshIntervalMs, () =>
@@ -126,6 +132,7 @@ export default function (pi: ExtensionAPI) {
 		projectRefreshInFlight = false;
 		projectRefreshPending = false;
 		requestFooterRender = undefined;
+		getActiveExtensionStatuses = () => new Map();
 		if (ctx?.hasUI) {
 			ctx.ui.setFooter(undefined);
 			ctx.ui.setEditorComponent(undefined);
@@ -133,6 +140,13 @@ export default function (pi: ExtensionAPI) {
 		activeTheme = undefined;
 	};
 
+	const syncInteractiveState = (_event: unknown, ctx: ExtensionContext) => {
+		refreshInteractiveState(ctx);
+	};
+	const syncInteractiveAndProjectState = (_event: unknown, ctx: ExtensionContext) => {
+		refreshInteractiveState(ctx, true);
+	};
+
 	pi.on("session_start", async (_event, ctx) => {
 		installUi(ctx);
 	});
@@ -142,6 +156,12 @@ export default function (pi: ExtensionAPI) {
 		setColorSources(patch: Partial<ColorSourcesConfig>) {
 			currentConfig = saveColorSourcesPatch(patch);
 		},
+		getActiveExtensionStatuses() {
+			return getActiveExtensionStatuses();
+		},
+		setExtensionStatusPlacement(key: string, placement: ExtensionStatusPlacement) {
+			currentConfig = saveExtensionStatusPlacement(key, placement);
+		},
 		requestRender() {
 			refresh();
 		},
@@ -151,31 +171,12 @@ export default function (pi: ExtensionAPI) {
 		cleanupUi(ctx);
 	});
 
-	pi.on("agent_start", async (_event, ctx) => {
-		refreshInteractiveState(ctx);
-	});
-
-	pi.on("agent_end", async (_event, ctx) => {
-		refreshInteractiveState(ctx, true);
-	});
-
-	pi.on("model_select", async (_event, ctx) => {
-		refreshInteractiveState(ctx);
-	});
-
-	pi.on("thinking_level_select", async (_event, ctx) => {
-		refreshInteractiveState(ctx);
-	});
-
-	pi.on("message_end", async (_event, ctx) => {
-		refreshInteractiveState(ctx, true);
-	});
-
-	pi.on("tool_execution_end", async (_event, ctx) => {
-		refreshInteractiveState(ctx, true);
-	});
-
-	pi.on("session_compact", async (_event, ctx) => {
-		refreshInteractiveState(ctx, true);
-	});
+	pi.on("agent_start", syncInteractiveState);
+	pi.on("agent_end", syncInteractiveAndProjectState);
+	pi.on("model_select", syncInteractiveState);
+	pi.on("thinking_level_select", syncInteractiveState);
+	pi.on("message_end", syncInteractiveAndProjectState);
+	pi.on("tool_execution_end", syncInteractiveAndProjectState);
+	pi.on("session_compact", syncInteractiveAndProjectState);
+	pi.on("session_tree", syncInteractiveAndProjectState);
 }

package/extensions/zentui/settings-command.ts

@@ -6,16 +6,32 @@ import {
 	type SettingsListTheme,
 	truncateToWidth,
 } from "@earendil-works/pi-tui";
-import type { ColorSource, ColorSourcesConfig, PolishedTuiConfig } from "./config";
+import {
+	type ColorSource,
+	type ColorSourcesConfig,
+	type ExtensionStatusPlacement,
+	type PolishedTuiConfig,
+	getExtensionStatusPlacement,
+	isExtensionStatusPlacement,
+} from "./config";
+import { sanitizeExtensionStatusText } from "./extension-status";
 import { EDITOR_BORDER_STYLE, renderChromeBorder, safeThemeFg } from "./style";
 
 const colorSourceValues: ColorSource[] = ["theme", "terminal"];
+const extensionStatusPlacementValues: ExtensionStatusPlacement[] = [
+	"off",
+	"left",
+	"middle",
+	"right",
+];
 
 type SettingId = "starship" | "editorMessages";
 
 type SettingsCommandDeps = {
 	getConfig: () => PolishedTuiConfig;
 	setColorSources: (patch: Partial<ColorSourcesConfig>) => void;
+	getActiveExtensionStatuses: () => ReadonlyMap<string, string>;
+	setExtensionStatusPlacement: (key: string, placement: ExtensionStatusPlacement) => void;
 	requestRender: () => void;
 	settingsListTheme?: SettingsListTheme;
 };
@@ -50,27 +66,114 @@ function patchForSetting(id: SettingId, value: ColorSource): Partial<ColorSource
 	return id === "starship" ? { starship: value } : { editor: value, userMessages: value };
 }
 
-function buildItems(config: PolishedTuiConfig): SettingItem[] {
-	return (Object.keys(settingLabels) as SettingId[]).map((key) => ({
-		id: key,
-		label: settingLabels[key],
-		description: settingDescriptions[key],
-		currentValue: key === "starship" ? config.colorSources.starship : editorMessageValue(config),
-		values: colorSourceValues,
-	}));
+function buildItems(
+	config: PolishedTuiConfig,
+	activeStatusCount: number,
+	thirdPartyStatusesSubmenu: SettingItem["submenu"],
+): SettingItem[] {
+	return [
+		...(Object.keys(settingLabels) as SettingId[]).map((key) => ({
+			id: key,
+			label: settingLabels[key],
+			description: settingDescriptions[key],
+			currentValue: key === "starship" ? config.colorSources.starship : editorMessageValue(config),
+			values: colorSourceValues,
+		})),
+		{
+			id: "thirdPartyStatuses",
+			label: "Third-party statuses",
+			description:
+				"Configure active ctx.ui.setStatus() footer statuses. Only currently active keys are listed.",
+			currentValue: `${activeStatusCount} active`,
+			submenu: thirdPartyStatusesSubmenu,
+		},
+	];
 }
 
 export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCommandDeps): void {
 	pi.registerCommand("zentui", {
-		description: "Configure Zentui colors",
+		description: "Configure Zentui",
 		handler: async (_args, ctx) => {
 			if (!ctx.hasUI) return;
 
 			await ctx.ui.custom<void>((tui, theme, _keybindings, done) => {
+				const settingsListTheme = deps.settingsListTheme ?? getSettingsListTheme();
+				const makeThirdPartyStatusesSubmenu: SettingItem["submenu"] = (_currentValue, close) => {
+					const activeStatuses = Array.from(deps.getActiveExtensionStatuses().entries()).sort(
+						([a], [b]) => (a < b ? -1 : a > b ? 1 : 0),
+					);
+
+					if (activeStatuses.length === 0) {
+						return {
+							render(width: number) {
+								return [
+									truncateToWidth(safeThemeFg(theme, "accent", "Third-party statuses"), width, ""),
+									"",
+									truncateToWidth(
+										safeThemeFg(theme, "muted", "No third-party statuses are active."),
+										width,
+										"",
+									),
+									truncateToWidth(
+										safeThemeFg(
+											theme,
+											"muted",
+											"This menu only lists statuses currently published through ctx.ui.setStatus().",
+										),
+										width,
+										"",
+									),
+									"",
+									truncateToWidth(safeThemeFg(theme, "muted", "Esc to go back"), width, ""),
+								];
+							},
+							invalidate() {},
+							handleInput(data: string) {
+								if (data === "\x1b" || data === "\u0003") close(undefined);
+							},
+						};
+					}
+
+					const statusItems: SettingItem[] = activeStatuses.map(([key, value]) => {
+						const sanitizedText = sanitizeExtensionStatusText(value);
+						return {
+							id: key,
+							label: key,
+							description: sanitizedText ? `Current status: ${sanitizedText}` : undefined,
+							currentValue: getExtensionStatusPlacement(deps.getConfig(), key),
+							values: extensionStatusPlacementValues,
+						};
+					});
+					const statusSettingsList = new SettingsList(
+						statusItems,
+						8,
+						settingsListTheme,
+						(key, newValue) => {
+							if (!isExtensionStatusPlacement(newValue)) return;
+
+							try {
+								deps.setExtensionStatusPlacement(key, newValue);
+								statusSettingsList.updateValue(key, newValue);
+								deps.requestRender();
+								ctx.ui.notify(`Third-party status ${key}: ${newValue}`, "info");
+								tui.requestRender();
+							} catch (error) {
+								const message = error instanceof Error ? error.message : String(error);
+								ctx.ui.notify(`Could not update Zentui settings: ${message}`, "error");
+							}
+						},
+						() => close(undefined),
+					);
+					return statusSettingsList;
+				};
 				const settingsList = new SettingsList(
-					buildItems(deps.getConfig()),
+					buildItems(
+						deps.getConfig(),
+						deps.getActiveExtensionStatuses().size,
+						makeThirdPartyStatusesSubmenu,
+					),
 					5,
-					deps.settingsListTheme ?? getSettingsListTheme(),
+					settingsListTheme,
 					(id, newValue) => {
 						if (!isSettingId(id) || !isColorSource(newValue)) return;
 

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-zentui",
-	"version": "0.1.11",
+	"version": "0.1.13",
 	"description": "A Starship-inspired statusline and Opencode-style TUI for Pi.",
 	"type": "module",
 	"license": "MIT",
@@ -45,6 +45,6 @@
 		"@earendil-works/pi-tui": "^0.74.0",
 		"@types/node": "^25.5.2",
 		"typescript": "^6.0.2",
-		"vitest": "^3.2.4"
+		"vitest": "^4.1.8"
 	}
 }