@diegopetrucci/pi-extensions 0.1.12 → 0.1.13

package/README.md

@@ -2,7 +2,7 @@
 
 A collection of [pi](https://github.com/badlogic/pi-mono) agent extensions I made:
 
-- [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal two-line layout: branch/repo on the first line, context/model on the second, plus OpenAI Codex 5-hour and 7-day usage when available.
+- [`minimal-footer`](./extensions/minimal-footer): Replaces pi's built-in footer with a minimal configurable two-line layout: branch/repo on the first line, context/model on the second, optional `DUMB ZONE`, plus OpenAI Codex 5-hour and 7-day usage when available.
 - [`oracle`](./extensions/oracle): Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, covers pi’s built-in providers with hardcoded rankings, sets reasoning to xhigh by default, and shows live status while running.
 - [`permission-gate`](./extensions/permission-gate): Prompts for confirmation before dangerous bash commands like `rm -rf`, `sudo`, and `chmod 777`.
 - [`confirm-destructive`](./extensions/confirm-destructive): Confirms before destructive session actions like clear, switch, and fork.
@@ -21,7 +21,7 @@ pi install npm:@diegopetrucci/pi-extensions
 Or pin the GitHub package to this release:
 
 ```bash
-pi install git:github.com/diegopetrucci/pi-extensions@v0.1.12
+pi install git:github.com/diegopetrucci/pi-extensions@v0.1.13
 ```
 
 Or a specific extension:

package/extensions/minimal-footer/README.md

@@ -9,6 +9,7 @@ It replaces pi's built-in footer with a cleaner two-line layout that focuses on
 - current git branch
 - current repo name
 - current context percentage
+- red `DUMB ZONE` indicator when context usage is above 200k tokens
 - current model and thinking level
 - OpenAI Codex 5-hour and 7-day usage when available
 
@@ -28,6 +29,12 @@ fix/remove-detached-image-tasks                     SendItToMy
 44.1%                                              gpt-5.4 high
 ```
 
+When context usage is above 200k tokens, the bottom-left line includes a red warning:
+
+```text
+44.1% · DUMB ZONE
+```
+
 When using `openai-codex`, the bottom-left line also includes subscription usage:
 
 ```text
@@ -62,11 +69,102 @@ Then reload pi:
 /reload
 ```
 
+## Configuration
+
+Config files are merged, with project config overriding global config:
+
+- `~/.pi/agent/extensions/minimal-footer.json`
+- `<project>/.pi/minimal-footer.json`
+
+A ready-to-copy sample file is included at [`minimal-footer.example.json`](./minimal-footer.example.json).
+
+Example:
+
+```json
+{
+  "context": {
+    "showPercent": true,
+    "dumbZone": {
+      "enabled": true,
+      "thresholdTokens": 200000,
+      "label": "DUMB ZONE",
+      "color": "error"
+    }
+  },
+  "codexUsage": {
+    "enabled": true,
+    "cacheTtlMs": 300000,
+    "requestTimeoutMs": 10000,
+    "windows": {
+      "primary": {
+        "enabled": true,
+        "label": "5h"
+      },
+      "secondary": {
+        "enabled": true,
+        "label": "7d"
+      }
+    }
+  }
+}
+```
+
+Disable `DUMB ZONE`:
+
+```json
+{
+  "context": {
+    "dumbZone": {
+      "enabled": false
+    }
+  }
+}
+```
+
+Disable OpenAI Codex session-limit usage entirely:
+
+```json
+{
+  "codexUsage": {
+    "enabled": false
+  }
+}
+```
+
+Disable one session-limit window:
+
+```json
+{
+  "codexUsage": {
+    "windows": {
+      "secondary": {
+        "enabled": false
+      }
+    }
+  }
+}
+```
+
+### Config fields
+
+- `context.showPercent`: show the context percentage
+- `context.dumbZone.enabled`: show `DUMB ZONE` when context tokens exceed the threshold
+- `context.dumbZone.thresholdTokens`: token threshold for `DUMB ZONE`
+- `context.dumbZone.label`: warning text
+- `context.dumbZone.color`: theme color for the warning (`error`, `warning`, `accent`, `text`, or `dim`)
+- `codexUsage.enabled`: show OpenAI Codex session-limit usage when using `openai-codex`
+- `codexUsage.cacheTtlMs`: in-memory usage cache duration
+- `codexUsage.requestTimeoutMs`: usage request timeout
+- `codexUsage.windows.primary.enabled`: show the primary usage window
+- `codexUsage.windows.primary.label`: label for the primary usage window
+- `codexUsage.windows.secondary.enabled`: show the secondary usage window
+- `codexUsage.windows.secondary.label`: label for the secondary usage window
+
 ## What it shows
 
 - **Top left:** current git branch
 - **Top right:** current repo directory name
-- **Bottom left:** current context usage percentage
+- **Bottom left:** current context usage percentage, plus red `DUMB ZONE` above 200k context tokens
 - **Bottom left on `openai-codex`:** current context usage percentage plus 5-hour and 7-day Codex usage
 - **Bottom right:** model id and thinking level
 
@@ -79,6 +177,7 @@ This extension also lives inside the broader [`pi-extensions`](../../README.md)
 - Replaces pi's built-in footer entirely.
 - Uses pi footer data for git branch updates.
 - Shows only context percentage, not context window size.
+- Shows `DUMB ZONE` only while context usage is above 200k tokens.
 - Shows the model id rather than a provider-specific display label.
 - For `openai-codex`, reads pi's stored OAuth login and fetches usage from ChatGPT's backend usage endpoint.
 - Usage is cached briefly in memory and refreshed after turns.

package/extensions/minimal-footer/index.ts

@@ -1,6 +1,8 @@
-import { basename } from "node:path";
+import { existsSync, readFileSync } from "node:fs";
+import { basename, dirname, join } from "node:path";
 import {
 	AuthStorage,
+	getAgentDir,
 	type ExtensionAPI,
 	type ExtensionContext,
 } from "@mariozechner/pi-coding-agent";
@@ -12,11 +14,77 @@ import {
 	type UsageSnapshot,
 } from "./openai-usage";
 
-const USAGE_CACHE_TTL_MS = 5 * 60 * 1000;
-const USAGE_REQUEST_TIMEOUT_MS = 10 * 1000;
+const DEFAULT_CONFIG: MinimalFooterConfig = {
+	context: {
+		showPercent: true,
+		dumbZone: {
+			enabled: true,
+			thresholdTokens: 200_000,
+			label: "DUMB ZONE",
+			color: "error",
+		},
+	},
+	codexUsage: {
+		enabled: true,
+		cacheTtlMs: 5 * 60 * 1000,
+		requestTimeoutMs: 10 * 1000,
+		windows: {
+			primary: {
+				enabled: true,
+				label: "5h",
+			},
+			secondary: {
+				enabled: true,
+				label: "7d",
+			},
+		},
+	},
+};
+
+const DUMB_ZONE_COLORS = new Set<DumbZoneColor>([
+	"error",
+	"warning",
+	"accent",
+	"text",
+	"dim",
+]);
+
+type RecursivePartial<T> = {
+	[P in keyof T]?: T[P] extends object ? RecursivePartial<T[P]> : T[P];
+};
+
+type DumbZoneColor = "error" | "warning" | "accent" | "text" | "dim";
+
+interface MinimalFooterConfig {
+	context: {
+		showPercent: boolean;
+		dumbZone: {
+			enabled: boolean;
+			thresholdTokens: number;
+			label: string;
+			color: DumbZoneColor;
+		};
+	};
+	codexUsage: {
+		enabled: boolean;
+		cacheTtlMs: number;
+		requestTimeoutMs: number;
+		windows: {
+			primary: {
+				enabled: boolean;
+				label: string;
+			};
+			secondary: {
+				enabled: boolean;
+				label: string;
+			};
+		};
+	};
+}
 
 type UsageSessionState = {
 	authStorage: AuthStorage;
+	config: MinimalFooterConfig;
 	snapshot?: UsageSnapshot;
 	lastFetchedAt?: number;
 	loading: boolean;
@@ -25,6 +93,115 @@ type UsageSessionState = {
 	requestRender?: () => void;
 };
 
+function readConfigFile(path: string): RecursivePartial<MinimalFooterConfig> {
+	if (!existsSync(path)) return {};
+
+	try {
+		return JSON.parse(readFileSync(path, "utf-8")) as RecursivePartial<MinimalFooterConfig>;
+	} catch (error) {
+		console.error(`Warning: Could not parse ${path}: ${error}`);
+		return {};
+	}
+}
+
+function mergeConfig(
+	base: MinimalFooterConfig,
+	overrides: RecursivePartial<MinimalFooterConfig>,
+): MinimalFooterConfig {
+	const context = overrides.context;
+	const dumbZone = context?.dumbZone;
+	const codexUsage = overrides.codexUsage;
+	const primaryWindow = codexUsage?.windows?.primary;
+	const secondaryWindow = codexUsage?.windows?.secondary;
+
+	return {
+		context: {
+			showPercent: normalizeBoolean(context?.showPercent, base.context.showPercent),
+			dumbZone: {
+				enabled: normalizeBoolean(dumbZone?.enabled, base.context.dumbZone.enabled),
+				thresholdTokens: normalizeNonNegativeNumber(
+					dumbZone?.thresholdTokens,
+					base.context.dumbZone.thresholdTokens,
+				),
+				label: normalizeLabel(dumbZone?.label, base.context.dumbZone.label),
+				color: normalizeDumbZoneColor(dumbZone?.color, base.context.dumbZone.color),
+			},
+		},
+		codexUsage: {
+			enabled: normalizeBoolean(codexUsage?.enabled, base.codexUsage.enabled),
+			cacheTtlMs: normalizeNonNegativeNumber(
+				codexUsage?.cacheTtlMs,
+				base.codexUsage.cacheTtlMs,
+			),
+			requestTimeoutMs: normalizePositiveNumber(
+				codexUsage?.requestTimeoutMs,
+				base.codexUsage.requestTimeoutMs,
+			),
+			windows: {
+				primary: {
+					enabled: normalizeBoolean(
+						primaryWindow?.enabled,
+						base.codexUsage.windows.primary.enabled,
+					),
+					label: normalizeLabel(primaryWindow?.label, base.codexUsage.windows.primary.label),
+				},
+				secondary: {
+					enabled: normalizeBoolean(
+						secondaryWindow?.enabled,
+						base.codexUsage.windows.secondary.enabled,
+					),
+					label: normalizeLabel(secondaryWindow?.label, base.codexUsage.windows.secondary.label),
+				},
+			},
+		},
+	};
+}
+
+function normalizeBoolean(value: unknown, fallback: boolean): boolean {
+	return typeof value === "boolean" ? value : fallback;
+}
+
+function normalizeNonNegativeNumber(value: unknown, fallback: number): number {
+	return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : fallback;
+}
+
+function normalizePositiveNumber(value: unknown, fallback: number): number {
+	return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : fallback;
+}
+
+function normalizeLabel(value: unknown, fallback: string): string {
+	return typeof value === "string" && value.trim() ? value.trim() : fallback;
+}
+
+function normalizeDumbZoneColor(value: unknown, fallback: DumbZoneColor): DumbZoneColor {
+	return DUMB_ZONE_COLORS.has(value as DumbZoneColor) ? (value as DumbZoneColor) : fallback;
+}
+
+function findProjectConfigPath(cwd: string): string {
+	let current = cwd;
+	while (true) {
+		const candidate = join(current, ".pi", "minimal-footer.json");
+		if (existsSync(candidate)) return candidate;
+
+		const parent = dirname(current);
+		if (parent === current) return join(cwd, ".pi", "minimal-footer.json");
+		current = parent;
+	}
+}
+
+function loadConfig(cwd: string): MinimalFooterConfig {
+	const globalConfig = readConfigFile(join(getAgentDir(), "extensions", "minimal-footer.json"));
+	const projectConfig = readConfigFile(findProjectConfigPath(cwd));
+	return mergeConfig(mergeConfig(DEFAULT_CONFIG, globalConfig), projectConfig);
+}
+
+function shouldShowCodexUsage(config: MinimalFooterConfig): boolean {
+	return (
+		config.codexUsage.enabled &&
+		(config.codexUsage.windows.primary.enabled || config.codexUsage.windows.secondary.enabled)
+	);
+}
+
 function clearUsageState(state: UsageSessionState): void {
 	state.snapshot = undefined;
 	state.lastFetchedAt = undefined;
@@ -37,7 +214,8 @@ async function refreshUsageIfNeeded(
 	state: UsageSessionState,
 	force = false,
 ): Promise<void> {
-	if (!isOpenAICodexProvider(ctx.model?.provider)) {
+	const config = state.config;
+	if (!shouldShowCodexUsage(config) || !isOpenAICodexProvider(ctx.model?.provider)) {
 		clearUsageState(state);
 		state.requestRender?.();
 		return;
@@ -47,7 +225,7 @@ async function refreshUsageIfNeeded(
 	if (
 		!force &&
 		state.lastFetchedAt &&
-		now - state.lastFetchedAt < USAGE_CACHE_TTL_MS
+		now - state.lastFetchedAt < config.codexUsage.cacheTtlMs
 	) {
 		return;
 	}
@@ -61,7 +239,7 @@ async function refreshUsageIfNeeded(
 	state.inflight = (async () => {
 		try {
 			const snapshot = await fetchOpenAICodexUsage(state.authStorage, {
-				timeoutMs: USAGE_REQUEST_TIMEOUT_MS,
+				timeoutMs: config.codexUsage.requestTimeoutMs,
 			});
 			if (snapshot) {
 				state.snapshot = snapshot;
@@ -90,6 +268,7 @@ export default function (pi: ExtensionAPI) {
 	pi.on("session_start", (_event, ctx) => {
 		const state: UsageSessionState = {
 			authStorage: AuthStorage.create(),
+			config: loadConfig(ctx.cwd),
 			loading: false,
 		};
 		states.set(ctx.sessionManager, state);
@@ -111,10 +290,11 @@ export default function (pi: ExtensionAPI) {
 
 					const usage = ctx.getContextUsage();
 					const context = usage?.percent == null ? "?" : `${usage.percent.toFixed(1)}%`;
-					const usageSummary = isOpenAICodexProvider(ctx.model?.provider)
-						? formatUsageSummary(state.snapshot)
+					const dumbZone = state.config.context.dumbZone;
+					const inDumbZone = dumbZone.enabled && (usage?.tokens ?? 0) > dumbZone.thresholdTokens;
+					const usageSummary = shouldShowCodexUsage(state.config) && isOpenAICodexProvider(ctx.model?.provider)
+						? formatUsageSummary(state.snapshot, state.config.codexUsage.windows)
 						: undefined;
-					const contextText = usageSummary ? `${context} · ${usageSummary}` : context;
 
 					const model = ctx.model?.id ?? "no-model";
 					const thinking = pi.getThinkingLevel();
@@ -122,7 +302,11 @@ export default function (pi: ExtensionAPI) {
 
 					const branchStyled = theme.fg("dim", branch);
 					const repoStyled = theme.fg("dim", repo);
-					const contextStyled = theme.fg("dim", contextText);
+					const contextParts: string[] = [];
+					if (state.config.context.showPercent) contextParts.push(theme.fg("dim", context));
+					if (inDumbZone) contextParts.push(theme.fg(dumbZone.color, dumbZone.label));
+					if (usageSummary) contextParts.push(theme.fg("dim", usageSummary));
+					const contextStyled = contextParts.join(theme.fg("dim", " · "));
 					const modelStyled = theme.fg("dim", modelText);
 
 					const renderSplitLine = (left: string, right: string): string => {

package/extensions/minimal-footer/minimal-footer.example.json

@@ -0,0 +1,26 @@
+{
+  "context": {
+    "showPercent": true,
+    "dumbZone": {
+      "enabled": true,
+      "thresholdTokens": 200000,
+      "label": "DUMB ZONE",
+      "color": "error"
+    }
+  },
+  "codexUsage": {
+    "enabled": true,
+    "cacheTtlMs": 300000,
+    "requestTimeoutMs": 10000,
+    "windows": {
+      "primary": {
+        "enabled": true,
+        "label": "5h"
+      },
+      "secondary": {
+        "enabled": true,
+        "label": "7d"
+      }
+    }
+  }
+}

package/extensions/minimal-footer/openai-usage.ts

@@ -25,6 +25,17 @@ export interface UsageSnapshot {
 	fetchedAt: number;
 }
 
+export interface UsageSummaryWindowsConfig {
+	primary: {
+		enabled: boolean;
+		label: string;
+	};
+	secondary: {
+		enabled: boolean;
+		label: string;
+	};
+}
+
 function normalizeUsedPercent(value?: number): number | undefined {
 	if (typeof value !== "number" || !Number.isFinite(value)) return undefined;
 	return Math.min(100, Math.max(0, value));
@@ -68,15 +79,18 @@ export function isOpenAICodexProvider(provider?: string): boolean {
 	return provider === PROVIDER_ID;
 }
 
-export function formatUsageSummary(snapshot?: UsageSnapshot): string | undefined {
+export function formatUsageSummary(
+	snapshot: UsageSnapshot | undefined,
+	windows: UsageSummaryWindowsConfig,
+): string | undefined {
 	if (!snapshot) return undefined;
 
 	const primary = formatUsagePercent(snapshot.primary?.usedPercent);
 	const secondary = formatUsagePercent(snapshot.secondary?.usedPercent);
 	const parts: string[] = [];
 
-	if (primary) parts.push(`5h ${primary}`);
-	if (secondary) parts.push(`7d ${secondary}`);
+	if (windows.primary.enabled && primary) parts.push(`${windows.primary.label} ${primary}`);
+	if (windows.secondary.enabled && secondary) parts.push(`${windows.secondary.label} ${secondary}`);
 
 	return parts.length > 0 ? parts.join(" · ") : undefined;
 }

package/extensions/minimal-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-minimal-footer",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "A minimal custom footer for pi.",
   "keywords": ["pi-package", "pi", "terminal", "footer"],
   "license": "MIT",
@@ -12,6 +12,7 @@
   "files": [
     "index.ts",
     "openai-usage.ts",
+    "minimal-footer.example.json",
     "README.md"
   ],
   "publishConfig": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.12",
+  "version": "0.1.13",
   "description": "A collection of pi extensions, including a minimal custom footer, an Amp-style oracle, a permission gate for dangerous bash commands, confirm-before-destructive session actions, and terminal notifications when pi is ready for input.",
   "keywords": ["pi-package", "pi", "terminal", "agent"],
   "license": "MIT",