rinco-pi-hud 1.1.0 → 1.1.1

package/README.md

@@ -70,6 +70,10 @@ The HUD footer is enabled by default. Run `/zentui` to open the interactive sett
 /zentui statusline enable
 /zentui statusline disable
 /zentui statusline toggle
+/zentui row project toggle
+/zentui row session disable
+/zentui row activity enable
+/zentui row usage toggle
 /zentui format clear
 /zentui format "$model · $context · $cost · $git_branch( $git_commit) · $session_duration"
 /codex-status
@@ -121,6 +125,14 @@ Open `/zentui`, then select **Built-in segments** to enable or disable individua
 
 Existing configs using the former aggregate `tokens`, `toolActivity`, or `agentActivity` switches are migrated automatically. The whole footer can still be controlled with `/zentui statusline enable|disable|toggle`.
 
+In the default four-row layout, each semantic row can also be controlled directly:
+
+```text
+/zentui row <project|session|activity|usage> <enable|disable|toggle>
+```
+
+Row switches are persisted in `footerRows`. They do not affect a custom single-line `footerFormat`.
+
 ### Extension statuses
 
 Third-party extensions publish statuses that the HUD footer can display. Configure placement (`left`, `middle`, `right`, `off`) and color mode (`zentui`, `original`) for each extension status key.
@@ -164,11 +176,10 @@ Check types:
 npm run typecheck
 ```
 
-Verify tests and package contents:
+Verify formatting, types, lint rules, tests, and package contents:
 
 ```bash
-npm test
-npm run typecheck
+npm run verify
 npm run pack:check
 ```
 

package/docs/CONTRIBUTING.md

@@ -39,11 +39,12 @@ Pi loads the TypeScript extension directly, so this project has no separate buil
 Before submitting a change, run:
 
 ```bash
-npm test
-npm run typecheck
+npm run verify
 npm run pack:check
 ```
 
+`npm run verify` checks Prettier formatting, TypeScript types, ESLint rules, and the Vitest suite.
+
 Tests live in `tests/`:
 
 - `zentui-status.test.ts` — Config counts, MCP status parsing, and extension status helpers.
@@ -51,6 +52,7 @@ Tests live in `tests/`:
 - `footer-layout.test.ts` — Four-group categorized layout, segment wrapping, and narrow-width budget.
 - `footer-groups.test.ts` — Semantic Project, Session, Activity, and Usage segment ordering.
 - `footer-segment-controls.test.ts` — Independent status controls and legacy-config migration.
+- `footer-row-controls.test.ts` — Per-row command parsing, persistence, and configuration defaults.
 - `model-switch-statusline.test.ts` — Model switch statusline integration.
 - `model-usage-refresh.test.ts` — Model usage refresh integration.
 - `token-switch-usage.test.ts` — Token Switch balance formatting.
@@ -67,10 +69,19 @@ In addition to automated tests, validate HUD behavior in a real Pi TUI across di
 
 ## Code style
 
-The project currently has no configured linter, formatter, or pre-commit hook. Follow the existing conventions:
+The project uses ESLint for code-quality checks and Prettier for deterministic formatting:
+
+```bash
+npm run lint
+npm run lint:fix
+npm run format:check
+npm run format
+```
+
+Follow the configured conventions:
 
 - Use TypeScript ESM and explicit types.
-- Use two-space indentation, double quotes, and semicolons.
+- Use tab indentation, double quotes, and semicolons.
 - Keep extension lifecycle handling clear and release timers and UI state during `session_shutdown`.
 - Do not edit content enclosed by `AUTO-GENERATED` markers manually; regenerate it from the source identified in the marker.
 
@@ -116,8 +127,7 @@ Before opening a pull request, confirm that:
 
 - [ ] The change has a focused scope and contains no unrelated files.
 - [ ] New behavior or bug fixes include appropriate tests.
-- [ ] `npm test` passes.
-- [ ] `npm run typecheck` passes.
+- [ ] `npm run verify` passes (format, types, lint, and tests).
 - [ ] `npm run pack:check` passes and the package contains the expected files.
 - [ ] Affected HUD behavior was verified in a real Pi TUI.
 - [ ] Related documentation was synchronized from its source of truth.

package/docs/README.zh-CN.md

@@ -70,6 +70,10 @@ HUD 脚注默认启用。运行 `/zentui` 打开交互式设置。
 /zentui statusline enable
 /zentui statusline disable
 /zentui statusline toggle
+/zentui row project toggle
+/zentui row session disable
+/zentui row activity enable
+/zentui row usage toggle
 /zentui format clear
 /zentui format "$model · $context · $cost · $git_branch( $git_commit) · $session_duration"
 /codex-status
@@ -121,6 +125,14 @@ HUD 脚注默认启用。运行 `/zentui` 打开交互式设置。
 
 使用旧版聚合开关 `tokens`、`toolActivity` 或 `agentActivity` 的配置会自动迁移。仍可通过 `/zentui statusline enable|disable|toggle` 控制整个脚注。
 
+默认四行布局中的每个语义行也可以通过命令单独控制：
+
+```text
+/zentui row <project|session|activity|usage> <enable|disable|toggle>
+```
+
+行开关会持久化到 `footerRows`。使用自定义单行 `footerFormat` 时，这些开关不生效。
+
 ### 扩展状态
 
 第三方扩展发布的状态可由 HUD 脚注显示。可为每个扩展状态键配置位置（`left`、`middle`、`right`、`off`）和颜色模式（`zentui`、`original`）。
@@ -164,11 +176,10 @@ npm test
 npm run typecheck
 ```
 
-验证测试与发布内容：
+验证格式、类型、Lint、测试与发布内容：
 
 ```bash
-npm test
-npm run typecheck
+npm run verify
 npm run pack:check
 ```
 

package/docs/footer.md

@@ -13,6 +13,17 @@ Usage    · 35%/200k · ↑ 4.2k · ↓ 1.1k · $ 0.030
 
 The category column is sized from visible text so every separator aligns. When a row exceeds the terminal width, complete status segments move to an indented continuation line. Only a single segment that is wider than the available content area is truncated. Third-party extension statuses appear on the Activity group in configured `left`, `middle`, then `right` order.
 
+Control each default-layout row independently:
+
+```text
+/zentui row project enable
+/zentui row session disable
+/zentui row activity toggle
+/zentui row usage toggle
+```
+
+The command shape is `/zentui row <project|session|activity|usage> <enable|disable|toggle>`. Values persist under `footerRows`; all four default to `true`. Row switches apply only to the default layout and do not alter a custom single-line `footerFormat`.
+
 ## Built-in status segments
 
 | Key | Default | Group | Description |

package/extensions/hud/commands/settings-controller.ts

@@ -6,6 +6,7 @@ import {
 	saveExtensionStatusColorMode,
 	saveExtensionStatusPlacement,
 	saveFooterFormatPatch,
+	saveFooterRowsPatch,
 	saveFooterSegmentsPatch,
 	saveGitBranchPatch,
 	saveIconsModePatch,
@@ -39,6 +40,9 @@ export function registerSettingsController(pi: ExtensionAPI, deps: SettingsContr
 			updateConfig(saveUiFeaturesPatch(patch));
 			deps.applyConfiguredUi(ctx);
 		},
+		setFooterRows(patch) {
+			updateConfig(saveFooterRowsPatch(patch));
+		},
 		setFooterSegments(patch) {
 			updateConfig(saveFooterSegmentsPatch(patch));
 			deps.restartSessionTimer();

package/extensions/hud/commands/settings.ts

@@ -15,6 +15,7 @@ import {
 	type ContextStyle,
 	type ExtensionStatusColorMode,
 	type ExtensionStatusPlacement,
+	type FooterRowsConfig,
 	type FooterSegmentsConfig,
 	type GitBranchConfig,
 	type GitBranchMaxLength,
@@ -64,20 +65,13 @@ type FeatureSettingId = keyof UiFeaturesConfig;
 type FooterSegmentSettingId = keyof FooterSegmentsConfig;
 type SettingsSection = (typeof settingsSections)[number];
 type LayoutSettingId =
-	| "contextStyle"
-	| "separator"
-	| "pathDisplay"
-	| "pathDepth"
-	| "branchLength"
-	| "iconMode";
+	"contextStyle" | "separator" | "pathDisplay" | "pathDepth" | "branchLength" | "iconMode";
 
 type SettingsCommandDeps = {
 	getConfig: () => PolishedTuiConfig;
 	setColorSources: (patch: Partial<ColorSourcesConfig>) => void;
-	setUiFeatures: (
-		patch: Partial<UiFeaturesConfig>,
-		ctx: ExtensionContext,
-	) => void;
+	setUiFeatures: (patch: Partial<UiFeaturesConfig>, ctx: ExtensionContext) => void;
+	setFooterRows: (patch: Partial<FooterRowsConfig>) => void;
 	setFooterSegments: (patch: Partial<FooterSegmentsConfig>) => void;
 	setFooterFormat: (value: string) => void;
 	setIconMode: (mode: IconMode) => void;
@@ -109,6 +103,13 @@ const featureSettingDescriptions: Record<FeatureSettingId, string> = {
 	statusLine: "Enable or disable Zentui's custom footer/status line.",
 };
 
+const footerRowLabels: Record<keyof FooterRowsConfig, string> = {
+	project: "Project row",
+	session: "Session row",
+	activity: "Activity row",
+	usage: "Usage row",
+};
+
 const footerSegmentSettingLabels: Record<FooterSegmentSettingId, string> = {
 	cwd: "Current directory",
 	gitBranch: "Git branch",
@@ -183,6 +184,11 @@ const directCommandSuggestions = [
 	"statusline enable",
 	"statusline disable",
 	"statusline toggle",
+	...Object.keys(footerRowLabels).flatMap((row) => [
+		`row ${row} enable`,
+		`row ${row} disable`,
+		`row ${row} toggle`,
+	]),
 	"format clear",
 	"format $cwd on $git_branch $fill $context",
 	"format $cwd( on $git_branch)($git_status)$fill($context)( | $cost)",
@@ -317,7 +323,28 @@ function footerSegmentPatch(
 }
 
 function usageText(): string {
-	return 'Usage: /zentui statusline [enable|disable|toggle] or /zentui format "<template>"';
+	return 'Usage: /zentui statusline [enable|disable|toggle], /zentui row [project|session|activity|usage] [enable|disable|toggle], or /zentui format "<template>"';
+}
+
+function isFooterRow(value: string): value is keyof FooterRowsConfig {
+	return value === "project" || value === "session" || value === "activity" || value === "usage";
+}
+
+function parseDirectRowCommand(
+	args: string,
+	config: PolishedTuiConfig,
+): { row: keyof FooterRowsConfig; enabled: boolean } | undefined {
+	const normalized = args.trim().toLowerCase().replaceAll(/[_-]+/g, " ");
+	const [command, row, action, ...rest] = normalized.split(/\s+/g);
+	if (command !== "row" || !row || !isFooterRow(row) || !action || rest.length > 0) {
+		return undefined;
+	}
+	if (action !== "enable" && action !== "disable" && action !== "toggle") return undefined;
+
+	return {
+		row,
+		enabled: action === "toggle" ? !config.footerRows[row] : action === "enable",
+	};
 }
 
 function parseDirectFeatureCommand(
@@ -329,9 +356,8 @@ function parseDirectFeatureCommand(
 
 	const words = normalized.split(/\s+/g).filter(Boolean);
 	const hasWord = (value: string) => words.includes(value);
-	const feature = hasWord("footer") || hasWord("statusline") || hasWord("status")
-		? "statusLine"
-		: undefined;
+	const feature =
+		hasWord("footer") || hasWord("statusline") || hasWord("status") ? "statusLine" : undefined;
 	const action = hasWord("toggle")
 		? "toggle"
 		: hasWord("enable") || hasWord("enabled") || hasWord("on")
@@ -568,6 +594,24 @@ export function registerZentuiSettingsCommand(pi: ExtensionAPI, deps: SettingsCo
 				return;
 			}
 
+			const directRowCommand = parseDirectRowCommand(args, deps.getConfig());
+			if (directRowCommand) {
+				try {
+					deps.setFooterRows({ [directRowCommand.row]: directRowCommand.enabled });
+					deps.requestRender();
+					if (ctx.hasUI) {
+						ctx.ui.notify(
+							`${footerRowLabels[directRowCommand.row]}: ${featureValue(directRowCommand.enabled)}`,
+							"info",
+						);
+					}
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					if (ctx.hasUI) ctx.ui.notify(`Could not update Zentui settings: ${message}`, "error");
+				}
+				return;
+			}
+
 			const directCommand = parseDirectFeatureCommand(args, deps.getConfig());
 			if (directCommand) {
 				try {

package/extensions/hud/config/config-counts.ts

@@ -35,11 +35,12 @@ function getPiAgentDir(): string {
 function resolveAgentDir(options: ConfigCountOptions): string {
 	let agentDir = "";
 	try {
-		agentDir = typeof options.agentDir === "string"
-			? options.agentDir
-			: options.getAgentDir
-				? options.getAgentDir()
-				: getPiAgentDir();
+		agentDir =
+			typeof options.agentDir === "string"
+				? options.agentDir
+				: options.getAgentDir
+					? options.getAgentDir()
+					: getPiAgentDir();
 	} catch {
 		return "";
 	}

package/extensions/hud/config/config.ts

@@ -19,6 +19,7 @@ export type {
 	ExtensionStatusColorMode,
 	ExtensionStatusesConfig,
 	ExtensionStatusPlacement,
+	FooterRowsConfig,
 	FooterSegmentsConfig,
 	GitBranchConfig,
 	GitBranchMaxLength,
@@ -56,6 +57,7 @@ export {
 	saveExtensionStatusColorMode,
 	saveExtensionStatusPlacement,
 	saveFooterFormatPatch,
+	saveFooterRowsPatch,
 	saveFooterSegmentsPatch,
 	saveGitBranchPatch,
 	saveIconsModePatch,

package/extensions/hud/config/normalize.ts

@@ -25,6 +25,7 @@ import {
 	type ExtensionStatusColorMode,
 	type ExtensionStatusesConfig,
 	type ExtensionStatusPlacement,
+	type FooterRowsConfig,
 	type FooterSegmentsConfig,
 	type GitBranchConfig,
 	type GitBranchMaxLength,
@@ -218,6 +219,18 @@ function normalizeUiFeatures(record: Record<string, unknown>): UiFeaturesConfig
 	return { statusLine: booleanValue(record, "statusLine") };
 }
 
+function normalizeFooterRows(record: Record<string, unknown>): FooterRowsConfig {
+	return {
+		project:
+			typeof record.project === "boolean" ? record.project : defaultConfig.footerRows.project,
+		session:
+			typeof record.session === "boolean" ? record.session : defaultConfig.footerRows.session,
+		activity:
+			typeof record.activity === "boolean" ? record.activity : defaultConfig.footerRows.activity,
+		usage: typeof record.usage === "boolean" ? record.usage : defaultConfig.footerRows.usage,
+	};
+}
+
 function normalizeFooterSegments(record: Record<string, unknown>): FooterSegmentsConfig {
 	return {
 		cwd: footerSegmentValue(record, "cwd"),
@@ -335,6 +348,9 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 	const features = isRecord(config.features)
 		? normalizeUiFeatures(config.features as Record<string, unknown>)
 		: defaultConfig.features;
+	const footerRows = isRecord(config.footerRows)
+		? normalizeFooterRows(config.footerRows as Record<string, unknown>)
+		: defaultConfig.footerRows;
 	const footerSegments = isRecord(config.footerSegments)
 		? normalizeFooterSegments(config.footerSegments as Record<string, unknown>)
 		: defaultConfig.footerSegments;
@@ -363,6 +379,7 @@ export function mergeConfig(parsed: unknown): PolishedTuiConfig {
 		},
 		colorSources: { ...colorSources },
 		features: { ...features },
+		footerRows: { ...footerRows },
 		footerSegments: { ...footerSegments },
 		gitCommit,
 		gitMetrics,

package/extensions/hud/config/persist.ts

@@ -24,6 +24,7 @@ import {
 	type ContextThresholds,
 	type ExtensionStatusColorMode,
 	type ExtensionStatusPlacement,
+	type FooterRowsConfig,
 	type FooterSegmentsConfig,
 	type GitBranchConfig,
 	type IconMode,
@@ -41,6 +42,10 @@ function isUiFeatureKey(value: string): value is keyof UiFeaturesConfig {
 	return value === "statusLine";
 }
 
+function isFooterRowKey(value: string): value is keyof FooterRowsConfig {
+	return value === "project" || value === "session" || value === "activity" || value === "usage";
+}
+
 function isFooterSegmentKey(value: string): value is keyof FooterSegmentsConfig {
 	return (
 		value === "cwd" ||
@@ -94,6 +99,15 @@ function validUiFeatureEntries(record: Record<string, unknown>): Partial<UiFeatu
 	) as Partial<UiFeaturesConfig>;
 }
 
+function validFooterRowEntries(record: Record<string, unknown>): Partial<FooterRowsConfig> {
+	return Object.fromEntries(
+		Object.entries(record).filter((entry): entry is [keyof FooterRowsConfig, boolean] => {
+			const [key, value] = entry;
+			return isFooterRowKey(key) && typeof value === "boolean";
+		}),
+	) as Partial<FooterRowsConfig>;
+}
+
 function validFooterSegmentEntries(record: Record<string, unknown>): Partial<FooterSegmentsConfig> {
 	return Object.fromEntries(
 		Object.entries(record).filter((entry): entry is [keyof FooterSegmentsConfig, boolean] => {
@@ -133,6 +147,21 @@ export function saveUiFeaturesPatch(
 	});
 }
 
+export function saveFooterRowsPatch(
+	patch: Partial<FooterRowsConfig>,
+	path = configPath,
+): PolishedTuiConfig {
+	return mutateConfig(path, (record) => {
+		const existing = isRecord(record.footerRows)
+			? { ...(record.footerRows as Record<string, unknown>) }
+			: {};
+		record.footerRows = {
+			...existing,
+			...validFooterRowEntries(patch),
+		};
+	});
+}
+
 export function saveFooterSegmentsPatch(
 	patch: Partial<FooterSegmentsConfig>,
 	path = configPath,

package/extensions/hud/config/schema.ts

@@ -43,6 +43,13 @@ export type UiFeaturesConfig = {
 	statusLine: boolean;
 };
 
+export type FooterRowsConfig = {
+	project: boolean;
+	session: boolean;
+	activity: boolean;
+	usage: boolean;
+};
+
 export type FooterSegmentsConfig = {
 	cwd: boolean;
 	gitBranch: boolean;
@@ -142,6 +149,7 @@ export type PolishedTuiConfig = {
 	};
 	colorSources: ColorSourcesConfig;
 	features: UiFeaturesConfig;
+	footerRows: FooterRowsConfig;
 	footerSegments: FooterSegmentsConfig;
 	gitCommit: GitCommitConfig;
 	gitMetrics: GitMetricsConfig;
@@ -258,6 +266,12 @@ export const defaultConfig: PolishedTuiConfig = {
 	features: {
 		statusLine: true,
 	},
+	footerRows: {
+		project: true,
+		session: true,
+		activity: true,
+		usage: true,
+	},
 	footerSegments: {
 		cwd: true,
 		gitBranch: true,

package/extensions/hud/footer/index.ts

@@ -184,11 +184,7 @@ export function installFooter(
 							return gitStateBlock;
 						case "runtime": {
 							if (!safeRuntime) return "";
-							const symbol = resolveRuntimeSymbol(
-								safeRuntime.name,
-								safeRuntime.symbol,
-								iconMode,
-							);
+							const symbol = resolveRuntimeSymbol(safeRuntime.name, safeRuntime.symbol, iconMode);
 							const label = safeRuntime.version ? `${symbol} ${safeRuntime.version}` : symbol;
 							return renderStyleForSource(theme, colorSource, safeRuntime.style, label);
 						}
@@ -263,12 +259,7 @@ export function installFooter(
 							);
 						case "git_tag":
 							return config.gitCommit.showTag && safeCommit?.tag
-								? renderStyleForSource(
-										theme,
-										colorSource,
-										config.colors.gitCommit,
-										safeCommit.tag,
-									)
+								? renderStyleForSource(theme, colorSource, config.colors.gitCommit, safeCommit.tag)
 								: "";
 						case "git_metrics":
 							return formatGitMetricsSegment(
@@ -533,7 +524,12 @@ export function installFooter(
 						time: timeSegment,
 					},
 				});
-				const contents = composeCategorizedFooterRows(groups, separator, innerWidth);
+				const contents = composeCategorizedFooterRows(
+					groups,
+					separator,
+					innerWidth,
+					config.footerRows,
+				);
 				return contents.map(frame);
 			},
 		};

package/extensions/hud/footer/layout.ts

@@ -7,6 +7,14 @@ export type CategorizedFooterRows = {
 	usage: string[];
 };
 
+export type CategorizedFooterRowVisibility = Record<keyof CategorizedFooterRows, boolean>;
+
+const DEFAULT_ROW_VISIBILITY: CategorizedFooterRowVisibility = {
+	project: true,
+	session: true,
+	activity: true,
+	usage: true,
+};
 const MIN_WRAPPED_CONTENT_WIDTH = 4;
 
 function joinStatusTexts(statusTexts: string[], separator: string): string {
@@ -45,7 +53,11 @@ function prependStatusArea(base: string, statusText: string, separator: string):
 	return `${statusText}${separator}${base}`;
 }
 
-export function composeBuiltInFooterContent(left: string, right: string, innerWidth: number): string {
+export function composeBuiltInFooterContent(
+	left: string,
+	right: string,
+	innerWidth: number,
+): string {
 	const leftWidth = visibleWidth(left);
 	const rightWidth = visibleWidth(right);
 	if (!right) return truncateToWidth(left, innerWidth, "");
@@ -69,17 +81,11 @@ export function composeBuiltInFooterContent(left: string, right: string, innerWi
 	let fittedLeft = truncateToWidth(left, leftBudget, "");
 	let fittedRight = truncateToWidth(right, rightBudget, "");
 	for (let pass = 0; pass < 2; pass += 1) {
-		let spare = Math.max(
-			0,
-			available - visibleWidth(fittedLeft) - visibleWidth(fittedRight),
-		);
+		let spare = Math.max(0, available - visibleWidth(fittedLeft) - visibleWidth(fittedRight));
 		if (spare === 0) break;
 		if (visibleWidth(fittedLeft) < leftWidth) {
 			fittedLeft = truncateToWidth(left, visibleWidth(fittedLeft) + spare, "");
-			spare = Math.max(
-				0,
-				available - visibleWidth(fittedLeft) - visibleWidth(fittedRight),
-			);
+			spare = Math.max(0, available - visibleWidth(fittedLeft) - visibleWidth(fittedRight));
 		}
 		if (spare > 0 && visibleWidth(fittedRight) < rightWidth) {
 			fittedRight = truncateToWidth(right, visibleWidth(fittedRight) + spare, "");
@@ -231,10 +237,21 @@ export function composeCategorizedFooterRows(
 	rows: CategorizedFooterRows,
 	separator: string,
 	innerWidth: number,
+	visibility: CategorizedFooterRowVisibility = DEFAULT_ROW_VISIBILITY,
 ): string[] {
-	const groups = [rows.project, rows.session, rows.activity, rows.usage];
-	const categoryWidth = Math.max(...groups.map((parts) => visibleWidth(categoryLabel(parts))));
-	return groups.flatMap((parts) =>
+	const groups = [
+		{ id: "project", parts: rows.project },
+		{ id: "session", parts: rows.session },
+		{ id: "activity", parts: rows.activity },
+		{ id: "usage", parts: rows.usage },
+	] as const;
+	const visibleGroups = groups.filter(({ id }) => visibility[id]);
+	if (visibleGroups.length === 0) return [];
+
+	const categoryWidth = Math.max(
+		...visibleGroups.map(({ parts }) => visibleWidth(categoryLabel(parts))),
+	);
+	return visibleGroups.flatMap(({ parts }) =>
 		composeWrappedCategorizedRow(parts, separator, innerWidth, categoryWidth),
 	);
 }

package/extensions/hud/footer/render-labels.ts

@@ -27,12 +27,9 @@ export function safeStatusText(value: string | null | undefined, maxLength = 256
 export type SanitizedFooterInputs = {
 	safeCwd: string;
 	safeRuntime:
-		| { name: string; symbol: string; style: string; version: string | undefined }
-		| undefined;
+		{ name: string; symbol: string; style: string; version: string | undefined } | undefined;
 	safePackageVersion: { ecosystem: string; version: string } | undefined;
-	safeCommit:
-		| { oid: string | null; detached: boolean; tag: string | null }
-		| undefined;
+	safeCommit: { oid: string | null; detached: boolean; tag: string | null } | undefined;
 };
 
 /** Sanitize the state/ctx fields that flow into the terminal so a malicious
@@ -178,13 +175,19 @@ export function buildTelemetryLabels(
 	const usageCategoryLabel = statusStyle(config.colors.contextNormal, "Usage");
 
 	const sessionName = safeStatusText(state.telemetry.sessionName, 256);
-	const sessionNameLabel = statusStyle(config.colors.gitBranch, sessionName ? `◈ ${sessionName}` : "");
+	const sessionNameLabel = statusStyle(
+		config.colors.gitBranch,
+		sessionName ? `◈ ${sessionName}` : "",
+	);
 
 	const providerId = safeStatusText(ctx.model?.provider, 128);
 	const modelId = safeStatusText(ctx.model?.id, 256);
 	const modelText = providerId && modelId ? `${providerId}/${modelId}` : modelId || providerId;
 	const modelValueLabel = statusStyle(config.colors.runtimePrefix, modelText);
-	const modelStatusLabel = statusStyle(config.colors.runtimePrefix, modelText ? `λ ${modelText}` : "");
+	const modelStatusLabel = statusStyle(
+		config.colors.runtimePrefix,
+		modelText ? `λ ${modelText}` : "",
+	);
 
 	const thinkingLabel = state.telemetry.modelSupportsReasoning
 		? statusStyle(config.colors.extensionStatus, `Thinking level: ${state.telemetry.thinkingLevel}`)

package/extensions/hud/index.ts

@@ -99,7 +99,8 @@ export default function (pi: ExtensionAPI) {
 		if (
 			!currentConfig.features.statusLine ||
 			!(needsWallClock || needsDuration || needsActivityClock)
-		) return;
+		)
+			return;
 
 		const timer = setInterval(() => {
 			if (!sessionLifecycle.isCurrent()) return;

package/extensions/hud/segments/git.ts

@@ -7,11 +7,7 @@ const execFileAsync = promisify(execFile);
 const GIT_COMMAND_TIMEOUT_MS = 2_000;
 
 export type GitOperationState =
-	| "REBASING"
-	| "MERGING"
-	| "CHERRY-PICKING"
-	| "REVERTING"
-	| "BISECTING";
+	"REBASING" | "MERGING" | "CHERRY-PICKING" | "REVERTING" | "BISECTING";
 
 /**
  * Starship `git_commit`-style info derived from the existing porcelain probe.
@@ -57,9 +53,7 @@ export type GitStatusSummary = {
 };
 
 export type GitReadResult =
-	| { kind: "ok"; status: GitStatusSummary }
-	| { kind: "not_a_repo" }
-	| { kind: "error" };
+	{ kind: "ok"; status: GitStatusSummary } | { kind: "not_a_repo" } | { kind: "error" };
 
 export type GitStatePaths = {
 	rebaseMerge?: string;

package/extensions/hud/segments/mcp-status.ts

@@ -18,7 +18,8 @@ export function parseMcpStatus(text: string | undefined): McpStatus | undefined
 	const total = Number(enabledMatch ? enabledMatch[1] : legacyMatch![2]);
 	const disabled = enabledMatch?.[3] === undefined ? 0 : Number(enabledMatch[3]);
 	if (![connected, total, disabled].every(Number.isSafeInteger)) return undefined;
-	if (connected < 0 || total < 0 || connected > total || total > 10_000 || disabled > 10_000) return undefined;
+	if (connected < 0 || total < 0 || connected > total || total > 10_000 || disabled > 10_000)
+		return undefined;
 	return { connected, total };
 }
 

package/extensions/hud/segments/package-version.ts

@@ -41,8 +41,7 @@ export type PackageVersionResult = {
 };
 
 export type PackageVersionReadResult =
-	| { kind: "ok"; result: PackageVersionResult | null }
-	| { kind: "error" };
+	{ kind: "ok"; result: PackageVersionResult | null } | { kind: "error" };
 
 /**
  * A single manifest source. `kind` selects the lookup mode:

package/extensions/hud/segments/runtime.ts

@@ -103,9 +103,9 @@ function matchesDetection(
 	if (spec.excludedFiles && hasAnyFile(cwd, spec.excludedFiles)) return false;
 	return Boolean(
 		(spec.files && hasAnyFile(cwd, spec.files)) ||
-			(spec.folders && hasAnyFolder(cwd, spec.folders)) ||
-			(spec.extensions && hasAnyExtension(entries, spec.extensions)) ||
-			spec.env?.(env),
+		(spec.folders && hasAnyFolder(cwd, spec.folders)) ||
+		(spec.extensions && hasAnyExtension(entries, spec.extensions)) ||
+		spec.env?.(env),
 	);
 }
 

package/extensions/hud/segments/skill-activity.ts

@@ -119,7 +119,11 @@ export class SkillActivityTracker {
 				}
 				continue;
 			}
-			if (message.role !== "toolResult" || message.toolName !== "read" || message.isError === true) {
+			if (
+				message.role !== "toolResult" ||
+				message.toolName !== "read" ||
+				message.isError === true
+			) {
 				continue;
 			}
 			const id = typeof message.toolCallId === "string" ? message.toolCallId : undefined;

package/extensions/hud/state/telemetry.ts

@@ -46,7 +46,7 @@ export type TelemetryUpdate =
 			name: string;
 			args?: Record<string, unknown> | null;
 			at: number;
-		}
+	  }
 	| { type: "tool-result"; toolCallId: string; isError: boolean; at: number }
 	| { type: "agent-start"; at: number }
 	| { type: "agent-end"; at: number };
@@ -80,7 +80,9 @@ function normalizeThinkingLevel(value: string | undefined): string {
 
 export function createTelemetryState(initial: TelemetryInitialValues = {}): TelemetryState {
 	return {
-		sessionName: initial.sessionName ? sanitizeExternalText(initial.sessionName) || undefined : undefined,
+		sessionName: initial.sessionName
+			? sanitizeExternalText(initial.sessionName) || undefined
+			: undefined,
 		turnIndex: initial.turnIndex ?? 0,
 		thinkingLevel: normalizeThinkingLevel(initial.thinkingLevel),
 		modelSupportsReasoning: initial.modelSupportsReasoning ?? false,
@@ -118,11 +120,12 @@ export function findToolTarget(state: TelemetryState, toolCallId: string): strin
 
 function getToolTarget(args: Record<string, unknown> | null | undefined): string | undefined {
 	if (!args) return undefined;
-	const value = typeof args.path === "string"
-		? args.path
-		: typeof args.filePath === "string"
-			? args.filePath
-			: undefined;
+	const value =
+		typeof args.path === "string"
+			? args.path
+			: typeof args.filePath === "string"
+				? args.filePath
+				: undefined;
 	return value === undefined ? undefined : sanitizeToolTarget(value);
 }
 
@@ -205,7 +208,10 @@ function finishLatestAgentRun(state: TelemetryState, at: number): TelemetryState
 	return { ...state, agentRuns };
 }
 
-export function updateTelemetryState(state: TelemetryState, update: TelemetryUpdate): TelemetryState {
+export function updateTelemetryState(
+	state: TelemetryState,
+	update: TelemetryUpdate,
+): TelemetryState {
 	switch (update.type) {
 		case "metadata":
 			return updateMetadata(state, update);

package/extensions/hud/telemetry/codex-usage/app-server-client.ts

@@ -63,7 +63,8 @@ class CodexAppServerClient {
 
 	start(): Promise<void> {
 		if (this.startPromise) return this.startPromise;
-		if (this.signal?.aborted) return Promise.reject(new Error("Codex app-server query was cancelled."));
+		if (this.signal?.aborted)
+			return Promise.reject(new Error("Codex app-server query was cancelled."));
 		this.signal?.addEventListener("abort", this.abortHandler, { once: true });
 
 		this.startPromise = new Promise((resolve, reject) => {
@@ -100,7 +101,10 @@ class CodexAppServerClient {
 
 			child.stderr.setEncoding("utf8");
 			child.stderr.on("data", (chunk: string) => {
-				this.stderr = truncateEnd(`${this.stderr}${chunk.slice(0, MAX_ERROR_BODY_CHARS)}`, MAX_ERROR_BODY_CHARS);
+				this.stderr = truncateEnd(
+					`${this.stderr}${chunk.slice(0, MAX_ERROR_BODY_CHARS)}`,
+					MAX_ERROR_BODY_CHARS,
+				);
 			});
 			child.stderr.on("error", () => undefined);
 			child.stdin.on("error", (error) => this.rejectAll(error));

package/extensions/hud/telemetry/codex-usage/format.ts

@@ -205,10 +205,7 @@ function isPrimaryCodexSnapshot(snapshot: NormalizedRateLimitSnapshot): boolean
 	);
 }
 
-function formatWindowLine(
-	window: NormalizedRateLimitWindow,
-	fallback: "5h" | "weekly",
-): string {
+function formatWindowLine(window: NormalizedRateLimitWindow, fallback: "5h" | "weekly"): string {
 	const label = `${formatWindowLabel(window, fallback, false)} limit:`;
 	return `  ${label.padEnd(LIMIT_VALUE_COLUMN)}${formatWindow(window)}`;
 }

package/extensions/hud/telemetry/codex-usage/safety.ts

@@ -8,18 +8,18 @@ const SECRET_QUERY_PATTERN =
 	/([?&](?:access_token|refresh_token|id_token|session_token|client_secret|api_key|password)=)[^&#\s]+/gi;
 
 export function sanitizeCodexText(value: unknown, maxChars = 600): string {
-	let text = typeof value === "string" ? value : value instanceof Error ? value.message : String(value);
-	text = stripVTControlCharacters(text.slice(0, Math.max(maxChars * 4, maxChars)))
-		.replace(/[\u0000-\u001f\u007f-\u009f]/g, "");
+	let text =
+		typeof value === "string" ? value : value instanceof Error ? value.message : String(value);
+	text = stripVTControlCharacters(text.slice(0, Math.max(maxChars * 4, maxChars))).replace(
+		/[\u0000-\u001f\u007f-\u009f]/g,
+		"",
+	);
 	text = text
 		.replace(BEARER_PATTERN, "Bearer <redacted>")
 		.replace(SECRET_FIELD_PATTERN, "$1<redacted>")
 		.replace(COOKIE_PATTERN, "$1<redacted>")
 		.replace(SECRET_QUERY_PATTERN, "$1<redacted>");
-	return text
-		.replace(/\s+/g, " ")
-		.trim()
-		.slice(0, maxChars);
+	return text.replace(/\s+/g, " ").trim().slice(0, maxChars);
 }
 
 export function safeCodexErrorMessage(error: unknown): string {

package/extensions/hud/telemetry/codex-usage/types.ts

@@ -17,8 +17,7 @@ export type CachedReport = {
 };
 
 export type QueryUsageResult =
-	| { ok: true; report: CodexUsageReport }
-	| { ok: false; errors: UsageQueryError[] };
+	{ ok: true; report: CodexUsageReport } | { ok: false; errors: UsageQueryError[] };
 
 export type UsageQueryError = {
 	source: UsageSource;

package/extensions/hud/telemetry/token-switch.ts

@@ -13,9 +13,7 @@ type QueryTokenSwitchBalanceOptions = {
 	signal?: AbortSignal;
 };
 
-export function isTokenSwitchModel(
-	model: Pick<TokenSwitchModel, "provider"> | undefined,
-): boolean {
+export function isTokenSwitchModel(model: Pick<TokenSwitchModel, "provider"> | undefined): boolean {
 	return model?.provider === TOKEN_SWITCH_PROVIDER_ID;
 }
 
@@ -92,10 +90,7 @@ export async function queryTokenSwitchBalance({
 	};
 
 	try {
-		const subscriptionPayload = await fetchPayload(
-			TOKEN_SWITCH_SUBSCRIPTION_URL,
-			"subscription",
-		);
+		const subscriptionPayload = await fetchPayload(TOKEN_SWITCH_SUBSCRIPTION_URL, "subscription");
 		const usagePayload = await fetchPayload(TOKEN_SWITCH_USAGE_URL, "usage");
 		return parseTokenSwitchBalance(subscriptionPayload, usagePayload);
 	} catch (error) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rinco-pi-hud",
-  "version": "1.1.0",
+  "version": "1.1.1",
   "description": "A dynamic HUD footer for Pi, ported from Sakura Zentui Footer.",
   "type": "module",
   "license": "MIT",
@@ -30,11 +30,11 @@
     "test": "vitest run",
     "test:watch": "vitest",
     "typecheck": "tsc --noEmit",
-    "lint": "biome lint .",
-    "lint:fix": "biome lint --write .",
-    "format:check": "biome format .",
-    "format": "biome format --write .",
-    "verify": "npm run typecheck && npm run lint && npm run test",
+    "lint": "eslint extensions tests",
+    "lint:fix": "eslint extensions tests --fix",
+    "format:check": "prettier --check \"extensions/**/*.ts\" \"tests/**/*.ts\" \"eslint.config.js\" \"prettier.config.js\"",
+    "format": "prettier --write \"extensions/**/*.ts\" \"tests/**/*.ts\" \"eslint.config.js\" \"prettier.config.js\"",
+    "verify": "npm run format:check && npm run typecheck && npm run lint && npm run test",
     "pack:check": "npm pack --dry-run"
   },
   "peerDependencies": {
@@ -47,10 +47,14 @@
     ]
   },
   "devDependencies": {
-    "@biomejs/biome": "^2.5.7",
     "@earendil-works/pi-ai": "^0.83.0",
+    "@eslint/js": "^10.0.1",
     "@types/node": "^24.12.4",
+    "eslint": "^10.8.1",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.9.6",
     "typescript": "^5.9.3",
+    "typescript-eslint": "^8.67.0",
     "vitest": "^4.1.9"
   }
 }