pi-zentui 0.3.1 → 0.3.3

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025
+Copyright (c) 2025-2026 Luka
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -163,7 +163,8 @@ Default config values — copy this and change any value you want:
 		"deleted": "✘",
 		"typechanged": "T",
 		"cacheHit": "󰆼",
-		"editorPrompt": ""
+		"editorPrompt": "",
+		"rail": "│"
 	},
 	"colors": {
 		"cwd": "bold cyan",
@@ -218,7 +219,7 @@ Default config values — copy this and change any value you want:
 
 - Style values can be Starship/terminal strings (`bold purple`, `fg:202`, `#89b4fa`, `bg:blue fg:bright-green`) or Pi theme tokens (`accent`, `borderMuted`, `thinkingHigh`).
 - `projectRefreshIntervalMs`: project status polling interval; `0` disables polling.
-- `icons`: every shown icon key is configurable; omit any key to use the Zentui default. `editorPrompt` controls an optional copy-friendly editor prompt glyph; the default is `""` so copy-friendly mode stays rail-free.
+- `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`.

package/extensions/zentui/config.ts

@@ -22,10 +22,12 @@ export type FooterSegmentsConfig = {
 	cwd: boolean;
 	gitBranch: boolean;
 	gitStatus: boolean;
+	gitCounts: boolean;
 	runtime: boolean;
 	context: boolean;
 	tokens: boolean;
 	cost: boolean;
+	sessionDuration: boolean;
 };
 
 export type ExtensionStatusPlacement = "off" | "left" | "middle" | "right";
@@ -60,6 +62,7 @@ export type PolishedTuiConfig = {
 		typechanged: string;
 		cacheHit: string;
 		editorPrompt: string;
+		rail: string;
 	};
 	colors: {
 		cwd: ColorSpec;
@@ -73,6 +76,7 @@ export type PolishedTuiConfig = {
 		separator: ColorSpec;
 		runtimePrefix: ColorSpec;
 		extensionStatus: ColorSpec;
+		sessionDuration: ColorSpec;
 		editorAccent?: ColorSpec;
 		editorPrompt?: ColorSpec;
 		editorBorder?: ColorSpec;
@@ -111,6 +115,7 @@ export const defaultConfig: PolishedTuiConfig = {
 		typechanged: "T",
 		cacheHit: "󰆼",
 		editorPrompt: "",
+		rail: "│",
 	},
 	colors: {
 		cwd: "bold cyan",
@@ -124,6 +129,7 @@ export const defaultConfig: PolishedTuiConfig = {
 		separator: "bright-black",
 		runtimePrefix: "",
 		extensionStatus: "bright-black",
+		sessionDuration: "yellow",
 	},
 	colorSources: {
 		starship: "theme",
@@ -139,10 +145,12 @@ export const defaultConfig: PolishedTuiConfig = {
 		cwd: true,
 		gitBranch: true,
 		gitStatus: true,
+		gitCounts: false,
 		runtime: true,
 		context: true,
 		tokens: true,
 		cost: true,
+		sessionDuration: false,
 	},
 	extensionStatuses: {
 		defaultPlacement: "right",
@@ -187,6 +195,10 @@ function parseProjectRefreshIntervalMs(value: unknown): number {
 		: defaultConfig.projectRefreshIntervalMs;
 }
 
+function railValue(value: unknown): string {
+	return typeof value === "string" && value.trim().length > 0 ? value : defaultConfig.icons.rail;
+}
+
 function stringValue(record: Record<string, unknown>, key: string): string | undefined {
 	const value = record[key];
 	return typeof value === "string" ? value : undefined;
@@ -250,6 +262,7 @@ function normalizeColors(record: Record<string, unknown>): Partial<PolishedTuiCo
 		separator: colorValue(record, "separator"),
 		runtimePrefix: colorValue(record, "runtimePrefix"),
 		extensionStatus: colorValue(record, "extensionStatus"),
+		sessionDuration: colorValue(record, "sessionDuration"),
 		editorAccent: colorValue(record, "editorAccent"),
 		editorPrompt: colorValue(record, "editorPrompt"),
 		editorBorder: colorValue(record, "editorBorder"),
@@ -285,10 +298,12 @@ function normalizeFooterSegments(record: Record<string, unknown>): FooterSegment
 		cwd: footerSegmentValue(record, "cwd"),
 		gitBranch: footerSegmentValue(record, "gitBranch"),
 		gitStatus: footerSegmentValue(record, "gitStatus"),
+		gitCounts: footerSegmentValue(record, "gitCounts"),
 		runtime: footerSegmentValue(record, "runtime"),
 		context: footerSegmentValue(record, "context"),
 		tokens: footerSegmentValue(record, "tokens"),
 		cost: footerSegmentValue(record, "cost"),
+		sessionDuration: footerSegmentValue(record, "sessionDuration"),
 	};
 }
 
@@ -341,10 +356,12 @@ function isFooterSegmentKey(value: string): value is keyof FooterSegmentsConfig
 		value === "cwd" ||
 		value === "gitBranch" ||
 		value === "gitStatus" ||
+		value === "gitCounts" ||
 		value === "runtime" ||
 		value === "context" ||
 		value === "tokens" ||
-		value === "cost"
+		value === "cost" ||
+		value === "sessionDuration"
 	);
 }
 
@@ -394,9 +411,8 @@ export function ensureConfigExists(): void {
 
 export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 	const config = isRecord(parsed) ? parsed : {};
-	const icons = isRecord(config.icons)
-		? normalizeIcons(config.icons as Record<string, unknown>)
-		: {};
+	const iconsRecord = isRecord(config.icons) ? (config.icons as Record<string, unknown>) : {};
+	const icons = normalizeIcons(iconsRecord);
 	const colors = isRecord(config.colors)
 		? normalizeColors(config.colors as Record<string, unknown>)
 		: {};
@@ -417,6 +433,7 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 		icons: {
 			...defaultConfig.icons,
 			...icons,
+			rail: railValue(iconsRecord.rail),
 		},
 		colors: {
 			...defaultConfig.colors,

package/extensions/zentui/footer.ts

@@ -2,7 +2,7 @@ import type { ExtensionContext } from "@earendil-works/pi-coding-agent";
 import { truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
 import type { PolishedTuiConfig } from "./config";
 import { collectExtensionStatusSegments, type ExtensionStatusSegment } from "./extension-status";
-import { formatCwdLabel, formatRuntimeSegment } from "./format";
+import { buildSessionDurationLabel, formatCwdLabel, formatRuntimeSegment } from "./format";
 import type { FooterState } from "./state";
 import { renderStyleForSource } from "./style";
 
@@ -176,9 +176,16 @@ export function installFooter(
 				const gitStatusColor = (text: string) =>
 					renderStyleForSource(theme, colorSource, config.colors.gitStatus, text);
 				const gitIcon = config.icons.git ? gitColor(config.icons.git) : "";
+				const gitCounts = config.footerSegments.gitCounts;
+				const stashLabel =
+					state.stashed > 0
+						? gitCounts
+							? `${config.icons.stashed}${state.stashed}`
+							: config.icons.stashed
+						: "";
 				const allStatus = [
 					state.conflicted > 0 ? config.icons.conflicted : "",
-					state.stashed ? config.icons.stashed : "",
+					stashLabel,
 					state.deleted > 0 ? config.icons.deleted : "",
 					state.renamed > 0 ? config.icons.renamed : "",
 					state.modified > 0 ? config.icons.modified : "",
@@ -186,14 +193,18 @@ export function installFooter(
 					state.staged > 0 ? config.icons.staged : "",
 					state.untracked > 0 ? config.icons.untracked : "",
 				].join("");
-				const aheadBehind =
-					state.ahead > 0 && state.behind > 0
-						? config.icons.diverged
-						: state.ahead > 0
-							? config.icons.ahead
-							: state.behind > 0
-								? config.icons.behind
-								: "";
+				const aheadBehind = (() => {
+					if (state.ahead > 0 && state.behind > 0) {
+						return gitCounts
+							? `${config.icons.ahead}${state.ahead}${config.icons.behind}${state.behind}`
+							: config.icons.diverged;
+					}
+					if (state.ahead > 0)
+						return gitCounts ? `${config.icons.ahead}${state.ahead}` : config.icons.ahead;
+					if (state.behind > 0)
+						return gitCounts ? `${config.icons.behind}${state.behind}` : config.icons.behind;
+					return "";
+				})();
 				const statusBlock =
 					allStatus || aheadBehind ? gitStatusColor(`[${allStatus}${aheadBehind}]`) : "";
 				const branchParts =
@@ -206,9 +217,27 @@ export function installFooter(
 					? formatRuntimeSegment(theme, state.runtime, config.colors.runtimePrefix, colorSource)
 					: "";
 
-				const left = [config.footerSegments.cwd ? cwdLabel : "", branchLabel, runtimeLabel]
+				const sessionDurationSegment = (() => {
+					if (!config.footerSegments.sessionDuration || !state.sessionStartEpoch) return "";
+					const timeLabel = buildSessionDurationLabel(state.sessionStartEpoch);
+					const prefix = renderStyleForSource(theme, colorSource, "", "up for");
+					const time = renderStyleForSource(
+						theme,
+						colorSource,
+						config.colors.sessionDuration,
+						timeLabel,
+					);
+					return `${prefix} ${time}`;
+				})();
+				const left = [
+					config.footerSegments.cwd ? cwdLabel : "",
+					branchLabel,
+					runtimeLabel,
+					sessionDurationSegment,
+				]
 					.filter(Boolean)
 					.join(" ");
+
 				const right = [
 					config.footerSegments.context
 						? renderStyleForSource(theme, colorSource, contextColor, state.contextLabel)
@@ -222,6 +251,7 @@ export function installFooter(
 				]
 					.filter(Boolean)
 					.join(separator);
+
 				const extensionStatuses = collectExtensionStatusSegments(
 					footerData.getExtensionStatuses(),
 					config,

package/extensions/zentui/format.ts

@@ -91,6 +91,16 @@ export function buildCostLabel(totals: UsageTotals): string {
 	return `$${totals.cost.toFixed(3)}`;
 }
 
+export function buildSessionDurationLabel(startEpoch: number): string {
+	const totalSeconds = Math.max(0, Math.floor((Date.now() - startEpoch) / 1000));
+	const hours = Math.floor(totalSeconds / 3600);
+	const minutes = Math.floor((totalSeconds % 3600) / 60);
+	const seconds = totalSeconds % 60;
+	if (hours > 0) return `${hours}h ${minutes}m`;
+	if (minutes > 0) return `${minutes}m ${seconds}s`;
+	return `${seconds}s`;
+}
+
 export function buildContextLabel(ctx: ExtensionContext): string {
 	const usage = ctx.getContextUsage();
 	const contextWindow = ctx.model?.contextWindow ?? usage?.contextWindow;

package/extensions/zentui/git.ts

@@ -11,7 +11,7 @@ export type GitStatusSummary = {
 	behind: number;
 	conflicted: number;
 	untracked: number;
-	stashed: boolean;
+	stashed: number;
 	modified: number;
 	staged: number;
 	renamed: number;
@@ -27,7 +27,7 @@ export function emptyGitStatus(): GitStatusSummary {
 		behind: 0,
 		conflicted: 0,
 		untracked: 0,
-		stashed: false,
+		stashed: 0,
 		modified: 0,
 		staged: 0,
 		renamed: 0,
@@ -36,9 +36,9 @@ export function emptyGitStatus(): GitStatusSummary {
 	};
 }
 
-export function parseGitStatusPorcelain(stdoutText: string, hasStash: boolean): GitStatusSummary {
+export function parseGitStatusPorcelain(stdoutText: string, stashCount: number): GitStatusSummary {
 	const status = emptyGitStatus();
-	status.stashed = hasStash;
+	status.stashed = stashCount;
 
 	for (const line of stdoutText.split(/\r?\n/)) {
 		if (!line) continue;
@@ -93,7 +93,7 @@ export async function readGitStatus(cwd: string): Promise<GitStatusSummary> {
 				cwd,
 				timeout: GIT_COMMAND_TIMEOUT_MS,
 			}),
-			execFileAsync("git", ["rev-parse", "--verify", "--quiet", "refs/stash"], {
+			execFileAsync("git", ["stash", "list"], {
 				cwd,
 				timeout: GIT_COMMAND_TIMEOUT_MS,
 			}).catch(() => ({ stdout: "" })),
@@ -101,7 +101,8 @@ export async function readGitStatus(cwd: string): Promise<GitStatusSummary> {
 		const stdoutText = typeof statusStdout === "string" ? statusStdout : String(statusStdout);
 		const stashStdout =
 			typeof stashResult.stdout === "string" ? stashResult.stdout : String(stashResult.stdout);
-		return parseGitStatusPorcelain(stdoutText, stashStdout.trim().length > 0);
+		const stashCount = stashStdout.split(/\r?\n/).filter((line) => line.trim().length > 0).length;
+		return parseGitStatusPorcelain(stdoutText, stashCount);
 	} catch {
 		return emptyGitStatus();
 	}

package/extensions/zentui/index.ts

@@ -21,6 +21,7 @@ import {
 	type UiFeaturesConfig,
 } from "./config";
 import { installFooter } from "./footer";
+import { buildSessionDurationLabel } from "./format";
 import { emptyGitStatus, readGitStatus } from "./git";
 import {
 	createProjectRefreshScheduler,
@@ -83,6 +84,8 @@ export default function (pi: ExtensionAPI) {
 	let installedEditorFactory: EditorFactory | undefined;
 	let wrappedEditorFactory: EditorFactory | undefined;
 	let prototypePatchesInstalled = false;
+	let stopSessionTimer: () => void = () => {};
+	let lastDurationLabel = "";
 
 	const refresh = () => requestFooterRender?.();
 	const getActiveTheme = () => activeTheme;
@@ -117,6 +120,25 @@ export default function (pi: ExtensionAPI) {
 		projectRefreshScheduler.stop();
 	};
 
+	const startSessionTimer = () => {
+		stopSessionTimer();
+		lastDurationLabel = "";
+		const timer = setInterval(() => {
+			if (!(currentConfig.features.statusLine && currentConfig.footerSegments.sessionDuration))
+				return;
+			const label = state.sessionStartEpoch
+				? buildSessionDurationLabel(state.sessionStartEpoch)
+				: "";
+			if (label === lastDurationLabel) return;
+			lastDurationLabel = label;
+			refresh();
+		}, 1000);
+		stopSessionTimer = () => {
+			clearInterval(timer);
+			stopSessionTimer = () => {};
+		};
+	};
+
 	const installPrototypePatches = () => {
 		if (prototypePatchesInstalled) return;
 		const cleanupSelectorBorderStyle = installSelectorBorderStyle(getActiveTheme, getCurrentConfig);
@@ -239,9 +261,11 @@ export default function (pi: ExtensionAPI) {
 		);
 		scheduleProjectRefresh(ctx, { force: true });
 		refresh();
+		startSessionTimer();
 	};
 
 	const uninstallStatusLine = (ctx: ExtensionContext) => {
+		stopSessionTimer();
 		stopProjectRefresh();
 		ctx.ui.setFooter(undefined);
 		footerInstalled = false;
@@ -297,6 +321,7 @@ export default function (pi: ExtensionAPI) {
 
 	const cleanupUi = (ctx?: ExtensionContext) => {
 		uninstallPrototypePatches();
+		stopSessionTimer();
 		stopProjectRefresh();
 		requestFooterRender = undefined;
 		getActiveExtensionStatuses = () => new Map();
@@ -328,6 +353,7 @@ export default function (pi: ExtensionAPI) {
 	};
 
 	pi.on("session_start", async (_event, ctx) => {
+		state.sessionStartEpoch = Date.now();
 		installUi(ctx);
 		scheduleEditorReconciliation(ctx);
 	});

package/extensions/zentui/settings-command.ts

@@ -88,6 +88,8 @@ const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	cwd: "Current directory",
 	gitBranch: "Git branch",
 	gitStatus: "Git status",
+	gitCounts: "Git counts",
+	sessionDuration: "Session duration",
 	runtime: "Runtime",
 	context: "Context usage",
 	tokens: "Token counts",
@@ -98,6 +100,9 @@ const footerSegmentSettingDescriptions: Record<FooterSegmentSettingId, string> =
 	cwd: "Show or hide the current working directory segment on the left.",
 	gitBranch: "Show or hide the git branch name on the left.",
 	gitStatus: "Show or hide git status icons and ahead/behind markers.",
+	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.",
 	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.",
@@ -144,6 +149,8 @@ function isFooterSegmentSettingId(value: string): value is FooterSegmentSettingI
 		value === "cwd" ||
 		value === "gitBranch" ||
 		value === "gitStatus" ||
+		value === "gitCounts" ||
+		value === "sessionDuration" ||
 		value === "runtime" ||
 		value === "context" ||
 		value === "tokens" ||

package/extensions/zentui/state.ts

@@ -16,6 +16,7 @@ export type FooterState = GitStatusSummary & {
 	tokenLabel: string;
 	costLabel: string;
 	runtime?: RuntimeInfo;
+	sessionStartEpoch?: number;
 };
 
 export function createInitialState(gitDefaults: GitStatusSummary): FooterState {
@@ -26,6 +27,7 @@ export function createInitialState(gitDefaults: GitStatusSummary): FooterState {
 		tokenLabel: "↑0 ↓0",
 		costLabel: "$0.000",
 		runtime: undefined,
+		sessionStartEpoch: Date.now(),
 		...gitDefaults,
 	};
 }

package/extensions/zentui/ui.ts

@@ -111,7 +111,7 @@ function getEditorChromeWidths(config: PolishedTuiConfig, uiTheme: Theme, reset:
 				config.colorSources.editor,
 				config.colors.editorAccent,
 				EDITOR_ACCENT_FALLBACK,
-				"│",
+				config.icons.rail,
 			)}${reset} `;
 	return {
 		prompt,

package/extensions/zentui/user-message.ts

@@ -87,6 +87,7 @@ function getUserMessageConfigKey(config: PolishedTuiConfig): string {
 		config.colorSources.userMessages,
 		config.colors.editorAccent ?? "",
 		config.colors.editorBorder ?? "",
+		config.icons.rail,
 	].join("\0");
 }
 
@@ -126,6 +127,7 @@ function fillLine(content: string, width: number): string {
 
 function renderPromptBoxRail(theme: Theme | undefined, config: PolishedTuiConfig): string {
 	if (config.features.copyFriendly) return "";
+	const railGlyph = config.icons.rail;
 
 	return `${
 		theme
@@ -134,9 +136,9 @@ function renderPromptBoxRail(theme: Theme | undefined, config: PolishedTuiConfig
 					config.colorSources.userMessages,
 					config.colors.editorAccent,
 					EDITOR_ACCENT_FALLBACK,
-					"│",
+					railGlyph,
 				)
-			: "│"
+			: railGlyph
 	} `;
 }
 

package/package.json

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