pi-zentui 0.3.3 → 0.4.0

package/README.md

@@ -21,8 +21,10 @@ Zentui brings two popular aesthetics to Pi:
 - `on  branch` — git branch with icon
 - `[!?↑]` — 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
+- Optional segments (off by default): `user@host`, current time, OS icon, and session duration
 - Right side shows context usage, token counts, and cost
 - Built-in footer segments can be shown or hidden individually from `/zentui`
+- Fully custom Starship-style layout via a `footerFormat` template string — see [Footer Format Template](#footer-format-template)
 - 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`
 
@@ -141,6 +143,8 @@ Useful slash-command shortcuts:
 /zentui copy-friendly enable
 /zentui copy-friendly disable
 /zentui copy-friendly toggle
+/zentui format "$cwd on branch $git_branch$git_status using $runtime $fill $context"
+/zentui format clear
 ```
 
 Default config values — copy this and change any value you want:
@@ -148,6 +152,7 @@ Default config values — copy this and change any value you want:
 ```json
 {
 	"projectRefreshIntervalMs": 30000,
+	"footerFormat": "",
 	"icons": {
 		"cwd": "󰝰",
 		"git": "",
@@ -164,7 +169,10 @@ Default config values — copy this and change any value you want:
 		"typechanged": "T",
 		"cacheHit": "󰆼",
 		"editorPrompt": "",
-		"rail": "│"
+		"rail": "│",
+		"username": "",
+		"time": "",
+		"os": ""
 	},
 	"colors": {
 		"cwd": "bold cyan",
@@ -178,6 +186,10 @@ Default config values — copy this and change any value you want:
 		"extensionStatus": "bright-black",
 		"separator": "bright-black",
 		"runtimePrefix": "",
+		"sessionDuration": "yellow",
+		"username": "bold yellow",
+		"time": "bold yellow",
+		"os": "bold white",
 		"editorAccent": "accent",
 		"editorPrompt": "accent",
 		"editorBorder": "borderMuted",
@@ -204,10 +216,15 @@ Default config values — copy this and change any value you want:
 		"cwd": true,
 		"gitBranch": true,
 		"gitStatus": true,
+		"gitCounts": false,
 		"runtime": true,
 		"context": true,
 		"tokens": true,
-		"cost": true
+		"cost": true,
+		"sessionDuration": false,
+		"username": false,
+		"time": false,
+		"os": false
 	},
 	"extensionStatuses": {
 		"defaultPlacement": "right",
@@ -222,7 +239,8 @@ Default config values — copy this and change any value you want:
 - `icons`: every shown icon key is configurable; omit any key to use the Zentui default. `rail` sets the vertical glyph drawn as the left rail of the active editor frame and previous user messages when `copyFriendly` is disabled (default `│`; any single Unicode vertical or block glyph). `editorPrompt` controls an optional copy-friendly editor prompt glyph; the default is `""` so copy-friendly mode stays rail-free.
 - `colorSources`: `theme` maps styles through Pi theme tokens; `terminal` emits terminal colors. `/zentui` switches these sources; manual JSON controls specific style values.
 - `features`: `editor` enables Zentui's custom editor, selector borders, and previous-message chrome. `statusLine` enables Zentui's custom footer/status line. `copyFriendly` hides editor and previous-message rail glyphs so native terminal selection copies less chrome. All three can be changed from `/zentui` or direct slash-command arguments.
-- `footerSegments`: show or hide individual built-in footer segments (`cwd`, `gitBranch`, `gitStatus`, `runtime`, `context`, `tokens`, `cost`). Toggle them from the `Built-in segments` tab in `/zentui`.
+- `footerSegments`: show or hide individual built-in footer segments (`cwd`, `gitBranch`, `gitStatus`, `gitCounts`, `runtime`, `sessionDuration`, `username`, `time`, `os`, `context`, `tokens`, `cost`). Toggle them from the `Built-in segments` tab in `/zentui`.
+- `footerFormat`: optional Starship-style template string that fully controls the footer layout. When set, it overrides `footerSegments`. See [Footer Format Template](#footer-format-template) below.
 - `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`. The `Extension segments` tab in `/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 when `features.copyFriendly` is disabled.
@@ -232,6 +250,57 @@ Default config values — copy this and change any value you want:
 
 Tip: when using copy-friendly mode, setting Pi's `editorPaddingX` to `1` in `~/.pi/agent/settings.json` keeps a small left gutter without copying a rail glyph.
 
+## Footer Format Template
+
+For full control, set a Starship-style `footerFormat` template string. It supports `$variable` and `${variable}` tokens plus a special `$fill` token that splits the line into left and right zones. When set, it overrides the built-in `footerSegments` layout; when empty or omitted, the segment layout above is used.
+
+A second `$fill` creates a **centered middle zone** — content between the two fills is true-centered (`floor((gap - middle) / 2)`), just like third-party statuses placed `middle`.
+
+```json
+{
+	"footerFormat": "$os $username $cwd on branch $git_branch$git_status using $runtime $fill $context | $tokens | $cost $time"
+}
+```
+
+Center the branch between directory and cost:
+
+```json
+{
+	"footerFormat": "$cwd $fill $git_branch $fill $cost"
+}
+```
+
+### Variables
+
+| Token               | Aliases      | Renders                   |
+| ------------------- | ------------ | ------------------------- |
+| `$cwd`              | `$directory` | current directory         |
+| `$git_branch`       | `$branch`    | git branch with icon      |
+| `$git_status`       | `$status`    | `[!?↑]` status block      |
+| `$runtime`          |              | runtime icon + version    |
+| `$session_duration` | `$duration`  | session running time      |
+| `$username`         |              | `user@host`               |
+| `$os`               |              | operating-system icon     |
+| `$time`             |              | current time `HH:MM`      |
+| `$context`          |              | context usage             |
+| `$tokens`           |              | input/output token counts |
+| `$cost`             |              | session cost              |
+| `$fill`             | —            | special: splits zones     |
+
+### `$fill` behavior
+
+| `$fill` count | Layout                                                                   |
+| ------------- | ------------------------------------------------------------------------ |
+| 0             | everything left-aligned                                                  |
+| 1             | tokens before → left, tokens after → right                               |
+| 2             | before first → left, between → **centered middle**, after second → right |
+| 3+            | first two count; extras ignored                                          |
+
+- Literal text (`on branch`, `using`, `\|`, spaces) is rendered verbatim — you control all spacing.
+- Each variable renders its core value only (no `on`/`via` prefixes); add those words as literal text.
+- Unknown `$variables` render empty.
+- Set or clear at runtime: `/zentui format "<template>"` and `/zentui format clear`.
+
 ## Requirements
 
 - [Pi](https://pi.dev) coding agent 0.79 or newer

package/extensions/zentui/config.ts

@@ -28,6 +28,9 @@ export type FooterSegmentsConfig = {
 	tokens: boolean;
 	cost: boolean;
 	sessionDuration: boolean;
+	username: boolean;
+	time: boolean;
+	os: boolean;
 };
 
 export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
@@ -46,6 +49,7 @@ const MIN_PROJECT_REFRESH_INTERVAL_MS = 5_000;
 
 export type PolishedTuiConfig = {
 	projectRefreshIntervalMs: number;
+	footerFormat: string;
 	icons: {
 		cwd: string;
 		git: string;
@@ -63,6 +67,9 @@ export type PolishedTuiConfig = {
 		cacheHit: string;
 		editorPrompt: string;
 		rail: string;
+		username: string;
+		time: string;
+		os: string;
 	};
 	colors: {
 		cwd: ColorSpec;
@@ -77,6 +84,9 @@ export type PolishedTuiConfig = {
 		runtimePrefix: ColorSpec;
 		extensionStatus: ColorSpec;
 		sessionDuration: ColorSpec;
+		username: ColorSpec;
+		time: ColorSpec;
+		os: ColorSpec;
 		editorAccent?: ColorSpec;
 		editorPrompt?: ColorSpec;
 		editorBorder?: ColorSpec;
@@ -95,10 +105,40 @@ export type PolishedTuiConfig = {
 	extensionStatuses: ExtensionStatusesConfig;
 };
 
+/**
+ * Canonical footer format variable names. In a `footerFormat` string these
+ * are written as `$name` or `${name}`.
+ */
+export const FOOTER_FORMAT_VARIABLES = [
+	"cwd",
+	"git_branch",
+	"git_status",
+	"runtime",
+	"session_duration",
+	"username",
+	"os",
+	"time",
+	"context",
+	"tokens",
+	"cost",
+] as const;
+
+/**
+ * Alias → canonical variable name mapping for `footerFormat`.
+ * `$fill` is special (not a variable) and handled by the parser.
+ */
+export const FOOTER_FORMAT_ALIASES: Record<string, string> = {
+	directory: "cwd",
+	branch: "git_branch",
+	status: "git_status",
+	duration: "session_duration",
+};
+
 export const configPath = join(getAgentDir(), "zentui.json");
 
 export const defaultConfig: PolishedTuiConfig = {
 	projectRefreshIntervalMs: DEFAULT_PROJECT_REFRESH_INTERVAL_MS,
+	footerFormat: "",
 	icons: {
 		cwd: "󰝰",
 		git: "",
@@ -116,6 +156,9 @@ export const defaultConfig: PolishedTuiConfig = {
 		cacheHit: "󰆼",
 		editorPrompt: "",
 		rail: "│",
+		username: "",
+		time: "",
+		os: "",
 	},
 	colors: {
 		cwd: "bold cyan",
@@ -130,6 +173,9 @@ export const defaultConfig: PolishedTuiConfig = {
 		runtimePrefix: "",
 		extensionStatus: "bright-black",
 		sessionDuration: "yellow",
+		username: "bold yellow",
+		time: "bold yellow",
+		os: "bold white",
 	},
 	colorSources: {
 		starship: "theme",
@@ -151,6 +197,9 @@ export const defaultConfig: PolishedTuiConfig = {
 		tokens: true,
 		cost: true,
 		sessionDuration: false,
+		username: false,
+		time: false,
+		os: false,
 	},
 	extensionStatuses: {
 		defaultPlacement: "right",
@@ -175,6 +224,9 @@ const iconKeys = [
 	"typechanged",
 	"cacheHit",
 	"editorPrompt",
+	"username",
+	"time",
+	"os",
 ] as const satisfies readonly (keyof PolishedTuiConfig["icons"])[];
 
 type ConfigRecord = Record<string, unknown>;
@@ -263,6 +315,9 @@ function normalizeColors(record: Record<string, unknown>): Partial<PolishedTuiCo
 		runtimePrefix: colorValue(record, "runtimePrefix"),
 		extensionStatus: colorValue(record, "extensionStatus"),
 		sessionDuration: colorValue(record, "sessionDuration"),
+		username: colorValue(record, "username"),
+		time: colorValue(record, "time"),
+		os: colorValue(record, "os"),
 		editorAccent: colorValue(record, "editorAccent"),
 		editorPrompt: colorValue(record, "editorPrompt"),
 		editorBorder: colorValue(record, "editorBorder"),
@@ -304,6 +359,9 @@ function normalizeFooterSegments(record: Record<string, unknown>): FooterSegment
 		tokens: footerSegmentValue(record, "tokens"),
 		cost: footerSegmentValue(record, "cost"),
 		sessionDuration: footerSegmentValue(record, "sessionDuration"),
+		username: footerSegmentValue(record, "username"),
+		time: footerSegmentValue(record, "time"),
+		os: footerSegmentValue(record, "os"),
 	};
 }
 
@@ -361,7 +419,10 @@ function isFooterSegmentKey(value: string): value is keyof FooterSegmentsConfig
 		value === "context" ||
 		value === "tokens" ||
 		value === "cost" ||
-		value === "sessionDuration"
+		value === "sessionDuration" ||
+		value === "username" ||
+		value === "time" ||
+		value === "os"
 	);
 }
 
@@ -430,6 +491,7 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 		: defaultConfig.extensionStatuses;
 	return {
 		projectRefreshIntervalMs: parseProjectRefreshIntervalMs(config.projectRefreshIntervalMs),
+		footerFormat: stringValue(config, "footerFormat") ?? "",
 		icons: {
 			...defaultConfig.icons,
 			...icons,
@@ -521,6 +583,13 @@ export function saveFooterSegmentsPatch(
 	return mergeConfig(record);
 }
 
+export function saveFooterFormatPatch(value: string, path = configPath): PolishedTuiConfig {
+	const record = readConfigRecord(path);
+	record.footerFormat = typeof value === "string" ? value : "";
+	writeFileSync(path, `${JSON.stringify(record, null, 2)}\n`, "utf8");
+	return mergeConfig(record);
+}
+
 export function saveExtensionStatusPlacement(
 	key: string,
 	placement: ExtensionStatusPlacement,

package/extensions/zentui/footer-format.ts

@@ -0,0 +1,121 @@
+/**
+ * Starship-style footer format string parser and renderer.
+ *
+ * Pure module (no TUI/config imports) so it is fully unit-testable.
+ */
+
+export type FormatToken =
+	| { kind: "text"; value: string }
+	| { kind: "var"; name: string }
+	| { kind: "fill" };
+
+const TOKEN_REGEX = /\$\{([a-zA-Z_][a-zA-Z0-9_]*)\}|\$([a-zA-Z_][a-zA-Z0-9_]*)/g;
+
+/**
+ * Tokenize a format string into text/var/fill tokens.
+ *
+ * `$name` and `${name}` both produce a variable token. A variable named
+ * `fill` becomes a fill token instead. Text between/around variables is
+ * preserved exactly (including spaces). Empty input produces an empty array.
+ */
+export function parseFooterFormat(format: string): FormatToken[] {
+	if (!format) return [];
+
+	const tokens: FormatToken[] = [];
+	let lastIndex = 0;
+
+	for (const match of format.matchAll(TOKEN_REGEX)) {
+		if (match.index !== undefined && match.index > lastIndex) {
+			tokens.push({ kind: "text", value: format.slice(lastIndex, match.index) });
+		}
+		const name = match[1] ?? match[2];
+		if (name === "fill") {
+			tokens.push({ kind: "fill" });
+		} else {
+			tokens.push({ kind: "var", name });
+		}
+		lastIndex = (match.index ?? 0) + match[0].length;
+	}
+
+	if (lastIndex < format.length) {
+		tokens.push({ kind: "text", value: format.slice(lastIndex) });
+	}
+
+	return tokens;
+}
+
+/**
+ * Render tokens into `{ left, middle, right }` based on `$fill` markers.
+ *
+ * - No fill: everything → `left`; `middle` and `right` are `""`.
+ * - One fill: tokens before → `left`, tokens after → `right`; `middle` is `""`.
+ * - Two fills: before the first → `left`, between the two → `middle`
+ *   (centered by the caller via the existing middle-zone logic), after the
+ *   second → `right`.
+ * - Additional fills beyond the first two are ignored.
+ *
+ * Text tokens contribute their `value` verbatim (unstyled/plain); var tokens
+ * contribute `renderVariable(name)` (already styled by caller). No automatic
+ * spaces are inserted — the user controls all spacing.
+ */
+export function renderFormatSplit(
+	tokens: FormatToken[],
+	renderVariable: (name: string) => string,
+): { left: string; middle: string; right: string } {
+	const fillIndices: number[] = [];
+	for (let index = 0; index < tokens.length; index++) {
+		if (tokens[index]?.kind === "fill") fillIndices.push(index);
+	}
+
+	if (fillIndices.length === 0) {
+		return {
+			left: renderTokenSlice(tokens, 0, tokens.length, renderVariable),
+			middle: "",
+			right: "",
+		};
+	}
+
+	const first = fillIndices[0];
+	const second = fillIndices[1];
+
+	if (first === undefined) {
+		return {
+			left: renderTokenSlice(tokens, 0, tokens.length, renderVariable),
+			middle: "",
+			right: "",
+		};
+	}
+
+	if (second === undefined) {
+		return {
+			left: renderTokenSlice(tokens, 0, first, renderVariable),
+			middle: "",
+			right: renderTokenSlice(tokens, first + 1, tokens.length, renderVariable),
+		};
+	}
+
+	return {
+		left: renderTokenSlice(tokens, 0, first, renderVariable),
+		middle: renderTokenSlice(tokens, first + 1, second, renderVariable),
+		right: renderTokenSlice(tokens, second + 1, tokens.length, renderVariable),
+	};
+}
+
+function renderTokenSlice(
+	tokens: FormatToken[],
+	start: number,
+	end: number,
+	renderVariable: (name: string) => string,
+): string {
+	let result = "";
+	for (let i = start; i < end; i++) {
+		const token = tokens[i];
+		if (!token) continue;
+		if (token.kind === "text") {
+			result += token.value;
+		} else if (token.kind === "var") {
+			result += renderVariable(token.name);
+		}
+	}
+	return result;
+}

package/extensions/zentui/footer.ts

@@ -1,8 +1,17 @@
 import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { PolishedTuiConfig } from "./config";
+import { FOOTER_FORMAT_ALIASES } from "./config";
 import { collectExtensionStatusSegments, type ExtensionStatusSegment } from "./extension-status";
-import { buildSessionDurationLabel, formatCwdLabel, formatRuntimeSegment } from "./format";
+import { parseFooterFormat, renderFormatSplit } from "./footer-format";
+import {
+	buildSessionDurationLabel,
+	formatCwdLabel,
+	formatOsLabel,
+	formatRuntimeSegment,
+	formatTimeLabel,
+	formatUsernameHostLabel,
+} from "./format";
 import type { FooterState } from "./state";
 import { renderStyleForSource } from "./style";
 
@@ -207,6 +216,67 @@ export function installFooter(
 				})();
 				const statusBlock =
 					allStatus || aheadBehind ? gitStatusColor(`[${allStatus}${aheadBehind}]`) : "";
+				const renderVariable = (name: string): string => {
+					const canonical = FOOTER_FORMAT_ALIASES[name] ?? name;
+					switch (canonical) {
+						case "cwd":
+							return cwdLabel;
+						case "git_branch":
+							return branch ? (gitIcon ? `${gitIcon} ${gitColor(branch)}` : gitColor(branch)) : "";
+						case "git_status":
+							return statusBlock;
+						case "runtime": {
+							if (!state.runtime) return "";
+							const label = state.runtime.version
+								? `${state.runtime.symbol} ${state.runtime.version}`
+								: state.runtime.symbol;
+							return renderStyleForSource(theme, colorSource, state.runtime.style, label);
+						}
+						case "session_duration":
+							return state.sessionStartEpoch
+								? renderStyleForSource(
+										theme,
+										colorSource,
+										config.colors.sessionDuration,
+										buildSessionDurationLabel(state.sessionStartEpoch),
+									)
+								: "";
+						case "username":
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								config.colors.username,
+								formatUsernameHostLabel(config.icons.username),
+							);
+						case "os":
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								config.colors.os,
+								formatOsLabel(config.icons.os),
+							);
+						case "time":
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								config.colors.time,
+								formatTimeLabel(config.icons.time),
+							);
+						case "context":
+							return renderStyleForSource(theme, colorSource, contextColor, state.contextLabel);
+						case "tokens":
+							return renderStyleForSource(
+								theme,
+								colorSource,
+								config.colors.tokens,
+								state.tokenLabel,
+							);
+						case "cost":
+							return renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel);
+						default:
+							return "";
+					}
+				};
 				const branchParts =
 					config.footerSegments.gitBranch && branch
 						? ["on", gitIcon, gitColor(branch)].filter(Boolean)
@@ -229,7 +299,25 @@ export function installFooter(
 					);
 					return `${prefix} ${time}`;
 				})();
+				const usernameSegment = config.footerSegments.username
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							config.colors.username,
+							formatUsernameHostLabel(config.icons.username),
+						)
+					: "";
+				const osSegment = config.footerSegments.os
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							config.colors.os,
+							formatOsLabel(config.icons.os),
+						)
+					: "";
 				const left = [
+					osSegment,
+					usernameSegment,
 					config.footerSegments.cwd ? cwdLabel : "",
 					branchLabel,
 					runtimeLabel,
@@ -238,6 +326,14 @@ export function installFooter(
 					.filter(Boolean)
 					.join(" ");
 
+				const timeSegment = config.footerSegments.time
+					? renderStyleForSource(
+							theme,
+							colorSource,
+							config.colors.time,
+							formatTimeLabel(config.icons.time),
+						)
+					: "";
 				const right = [
 					config.footerSegments.context
 						? renderStyleForSource(theme, colorSource, contextColor, state.contextLabel)
@@ -248,10 +344,25 @@ export function installFooter(
 					config.footerSegments.cost
 						? renderStyleForSource(theme, colorSource, config.colors.cost, state.costLabel)
 						: "",
+					timeSegment,
 				]
 					.filter(Boolean)
 					.join(separator);
 
+				let contentLeft = left;
+				let contentMiddle = "";
+				let contentRight = right;
+				if (config.footerFormat) {
+					const {
+						left: fmtLeft,
+						middle: fmtMiddle,
+						right: fmtRight,
+					} = renderFormatSplit(parseFooterFormat(config.footerFormat), renderVariable);
+					contentLeft = fmtLeft;
+					contentMiddle = fmtMiddle;
+					contentRight = fmtRight;
+				}
+
 				const extensionStatuses = collectExtensionStatusSegments(
 					footerData.getExtensionStatuses(),
 					config,
@@ -260,11 +371,15 @@ export function installFooter(
 					segment.colorMode === "original"
 						? segment.text
 						: renderStyleForSource(theme, colorSource, config.colors.extensionStatus, segment.text);
+				const extensionMiddleSegments = extensionStatuses.middle.map(renderExtensionStatus);
+				const middleSegments = contentMiddle
+					? [contentMiddle, ...extensionMiddleSegments]
+					: extensionMiddleSegments;
 				const content = composeFooterContent(
-					left,
-					right,
+					contentLeft,
+					contentRight,
 					extensionStatuses.left.map(renderExtensionStatus),
-					extensionStatuses.middle.map(renderExtensionStatus),
+					middleSegments,
 					extensionStatuses.right.map(renderExtensionStatus),
 					separator,
 					innerWidth,

package/extensions/zentui/format.ts

@@ -1,3 +1,4 @@
+import { hostname, userInfo } from "node:os";
 import type { AssistantMessage } from "@earendil-works/pi-ai";
 import type { ExtensionContext, Theme } from "@earendil-works/pi-coding-agent";
 import type { ColorSource, ColorSpec } from "./config";
@@ -129,3 +130,33 @@ export function formatCwdLabel(cwd: string, cwdIcon: string): string {
 	const last = parts[parts.length - 1] ?? cwd;
 	return cwdIcon ? `${cwdIcon} ${last}` : last;
 }
+
+export function formatUsernameHostLabel(icon: string): string {
+	try {
+		const user = userInfo().username;
+		const host = hostname();
+		if (!user || !host) return "";
+		const label = `${user}@${host}`;
+		return icon ? `${icon} ${label}` : label;
+	} catch {
+		return "";
+	}
+}
+
+export function formatTimeLabel(icon: string): string {
+	const now = new Date();
+	const hours = String(now.getHours()).padStart(2, "0");
+	const minutes = String(now.getMinutes()).padStart(2, "0");
+	const label = `${hours}:${minutes}`;
+	return icon ? `${icon} ${label}` : label;
+}
+
+const osIconMap: Record<string, string> = {
+	darwin: "\uf179",
+	linux: "\uf17c",
+	win32: "\uf17a",
+};
+
+export function formatOsLabel(defaultIcon: string): string {
+	return osIconMap[process.platform] ?? defaultIcon;
+}

package/extensions/zentui/index.ts

@@ -16,6 +16,7 @@ import {
 	saveColorSourcesPatch,
 	saveExtensionStatusColorMode,
 	saveExtensionStatusPlacement,
+	saveFooterFormatPatch,
 	saveFooterSegmentsPatch,
 	saveUiFeaturesPatch,
 	type UiFeaturesConfig,
@@ -124,8 +125,21 @@ export default function (pi: ExtensionAPI) {
 		stopSessionTimer();
 		lastDurationLabel = "";
 		const timer = setInterval(() => {
-			if (!(currentConfig.features.statusLine && currentConfig.footerSegments.sessionDuration))
+			const segments = currentConfig.footerSegments;
+			const formatNeedsTimer =
+				currentConfig.footerFormat &&
+				/\$\{?(?:time|session_duration|duration)\b/.test(currentConfig.footerFormat);
+			if (
+				!(
+					currentConfig.features.statusLine &&
+					(segments.sessionDuration || segments.time || formatNeedsTimer)
+				)
+			)
 				return;
+			if (segments.time || formatNeedsTimer) {
+				refresh();
+				return;
+			}
 			const label = state.sessionStartEpoch
 				? buildSessionDurationLabel(state.sessionStartEpoch)
 				: "";
@@ -376,6 +390,9 @@ export default function (pi: ExtensionAPI) {
 		setFooterSegments(patch: Partial<FooterSegmentsConfig>) {
 			currentConfig = saveFooterSegmentsPatch(patch);
 		},
+		setFooterFormat(value: string) {
+			currentConfig = saveFooterFormatPatch(value);
+		},
 		getActiveExtensionStatuses() {
 			return getActiveExtensionStatuses();
 		},

package/extensions/zentui/settings-command.ts

@@ -51,6 +51,7 @@ type SettingsCommandDeps = {
 		ctx: ExtensionContext,
 	) => { applied: boolean; reason?: string };
 	setFooterSegments: (patch: Partial<FooterSegmentsConfig>) => void;
+	setFooterFormat: (value: string) => void;
 	getActiveExtensionStatuses: () => ReadonlyMap<string, string>;
 	setExtensionStatusPlacement: (key: string, placement: ExtensionStatusPlacement) => void;
 	setExtensionStatusColorMode: (key: string, colorMode: ExtensionStatusColorMode) => void;
@@ -90,6 +91,9 @@ const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	gitStatus: "Git status",
 	gitCounts: "Git counts",
 	sessionDuration: "Session duration",
+	username: "Username@host",
+	time: "Current time",
+	os: "OS icon",
 	runtime: "Runtime",
 	context: "Context usage",
 	tokens: "Token counts",
@@ -103,6 +107,9 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 	gitCounts:
 		"Show numeric ahead/behind and stash counts (requires the Git status segment to be enabled).",
 	sessionDuration: "Show session running time on the left, after the runtime.",
+	username: "Show user@hostname on the left.",
+	time: "Show the current time (HH:MM) on the right.",
+	os: "Show an operating-system icon on the left.",
 	runtime: "Show or hide the detected runtime/language segment on the left.",
 	context: "Show or hide context usage on the right.",
 	tokens: "Show or hide input/output token counts on the right.",
@@ -119,6 +126,8 @@ const directCommandSuggestions = [
 	"copy-friendly enable",
 	"copy-friendly disable",
 	"copy-friendly toggle",
+	"format clear",
+	"format $cwd on $git_branch $fill $context",
 ];
 
 const sectionLabels: Record<SettingsSection, string> = {
@@ -154,7 +163,10 @@ function isFooterSegmentSettingId(value: string): value is FooterSegmentSettingI
 		value === "runtime" ||
 		value === "context" ||
 		value === "tokens" ||
-		value === "cost"
+		value === "cost" ||
+		value === "username" ||
+		value === "time" ||
+		value === "os"
 	);
 }
 
@@ -198,7 +210,7 @@ function footerSegmentPatch(
 }
 
 function usageText(): string {
-	return "Usage: /zentui [editor|statusline|copy-friendly] [enable|disable|toggle]";
+	return 'Usage: /zentui [editor|statusline|copy-friendly] [enable|disable|toggle] or /zentui format "<template>"';
 }
 
 function featureNotification(
@@ -242,6 +254,18 @@ function parseDirectFeatureCommand(
 	};
 }
 
+function parseFormatCommand(args: string): { value: string | undefined } | undefined {
+	const trimmed = args.trim();
+	if (!trimmed.toLowerCase().startsWith("format")) return undefined;
+
+	const rest = trimmed.slice("format".length).trim();
+	if (!rest || rest.toLowerCase() === "clear") return { value: undefined };
+
+	const unquoted =
+		rest.startsWith('"') && rest.endsWith('"') && rest.length >= 2 ? rest.slice(1, -1) : rest;
+	return { value: unquoted };
+}
+
 function argumentCompletions(prefix: string): AutocompleteItem[] | null {
 	const trimmedPrefix = prefix.trimStart().toLowerCase();
 	const items = directCommandSuggestions.map((value) => ({ value, label: value }));
@@ -383,6 +407,26 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 		getArgumentCompletions: argumentCompletions,
 		handler: async (_args, ctx) => {
 			const args = typeof _args === "string" ? _args : "";
+
+			const formatCommand = parseFormatCommand(args);
+			if (formatCommand) {
+				try {
+					deps.setFooterFormat(formatCommand.value ?? "");
+					deps.requestRender();
+					if (ctx.hasUI) {
+						if (formatCommand.value === undefined) {
+							ctx.ui.notify("Footer format cleared (using default layout)", "info");
+						} else {
+							ctx.ui.notify(`Footer format: ${formatCommand.value}`, "info");
+						}
+					}
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					if (ctx.hasUI) ctx.ui.notify(`Could not update footer format: ${message}`, "error");
+				}
+				return;
+			}
+
 			const directCommand = parseDirectFeatureCommand(args, deps.getConfig());
 			if (directCommand) {
 				try {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "pi-zentui",
-	"version": "0.3.3",
+	"version": "0.4.0",
 	"description": "A Starship-inspired statusline and Opencode-style TUI for Pi.",
 	"type": "module",
 	"license": "MIT",