@diegopetrucci/pi-extensions 0.1.50 → 0.1.51

package/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/README.md

@@ -16,7 +16,7 @@ A collection of [pi](https://github.com/earendil-works/pi-mono) agent extensions
 - [`inline-bash`](./extensions/inline-bash): Expands `!{command}` snippets in user prompts by running them through bash before the prompt reaches the agent.
 - [`illustrations-to-explain-things`](./extensions/illustrations-to-explain-things): Adds a skill for generating clean, absurd Xiaohei-style article illustrations, shot lists, image edits, and visual metaphors.
 - [`librarian`](./extensions/librarian): Adds a GitHub research scout with a local repo checkout cache disabled by default under the OS user cache directory, toggleable with `/librarian-cache`, configurable subagent model/thinking defaults via `/librarian-config`, and cached repos expiring after 7 days of non-use.
-- [`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`, optional `xp` marker, 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 plus cached git dirty/ahead/PR status and repo on the first line, context/model on the second, optional `DUMB ZONE`, optional `xp` marker, plus OpenAI Codex 5-hour and 7-day usage when available.
 - [`notify`](./extensions/notify): Sends configurable terminal, desktop, bell, and sound notifications when pi finishes and is ready for input.
 - [`openai-fast`](./extensions/openai-fast): Adds `/fast` to enable OpenAI Codex Fast mode for ChatGPT-auth GPT-5.4 and GPT-5.5 by injecting the priority service tier.
 - [`oracle`](./extensions/oracle): Adds an Amp-style read-only oracle tool that auto-selects the strongest reasoning model on the current provider/subscription, supports persisted `/oracle` model/thinking defaults, requests xhigh reasoning by default and clamps to model capabilities, and shows live status while running.

package/extensions/agent-workflow-audit/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/agent-workflow-audit/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-agent-workflow-audit",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that runs an isolated repo workflow audit and returns only the final report to the main session.",
   "keywords": [
     "pi-package",

package/extensions/annotate-git-diff/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/annotate-git-diff/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-annotate-git-diff",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A standalone pi extension that adds /annotate-git-diff, a native Glimpse UI for annotating git diffs and sending feedback to the editor.",
   "keywords": [
     "pi-package",

package/extensions/annotate-last-message/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/annotate-last-message/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-annotate-last-message",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A standalone pi extension that adds /annotate-last-message, a native Glimpse UI for annotating the latest assistant reply.",
   "keywords": [
     "pi-package",

package/extensions/brrr/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/brrr/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-brrr",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that sends brrr push notifications when pi is ready for input.",
   "keywords": [
     "pi-package",

package/extensions/claude-fast/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/claude-fast/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-claude-fast",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that enables Anthropic Claude Fast mode for supported Claude Opus models by injecting speed=fast.",
   "keywords": [
     "pi-package",

package/extensions/confirm-destructive/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/confirm-destructive/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-confirm-destructive",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that confirms destructive session actions.",
   "keywords": [
     "pi-package",

package/extensions/context-cap/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/context-cap/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-context-cap",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that caps effective model context windows at 200k tokens for earlier auto-compaction.",
   "keywords": [
     "pi-package",

package/extensions/context-inspector/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/context-inspector/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-context-inspector",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that opens a local HTML dashboard explaining where the current session context is going.",
   "keywords": [
     "pi-package",

package/extensions/dirty-repo-guard/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/dirty-repo-guard/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-dirty-repo-guard",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that prompts before session changes when the current git repo has uncommitted changes.",
   "keywords": [
     "pi-package",

package/extensions/git-footer/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/git-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-git-footer",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "A TLH-style git status add-on for pi's built-in footer.",
   "keywords": [
     "pi-package",

package/extensions/gnosis/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/gnosis/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-gnosis",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that exposes the gnosis repo-local knowledge base CLI as an agent tool.",
   "keywords": [
     "pi-package",

package/extensions/illustrations-to-explain-things/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/illustrations-to-explain-things/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-illustrations-to-explain-things",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "A pi skill for generating clean, absurd Xiaohei-style article illustrations, shot lists, and visual metaphors.",
   "keywords": [
     "pi-package",

package/extensions/inline-bash/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/inline-bash/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-inline-bash",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that expands inline bash commands in user prompts.",
   "keywords": [
     "pi-package",

package/extensions/librarian/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/librarian/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-librarian",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A pi GitHub research scout with a toggleable local repo checkout cache under the user's OS cache directory.",
   "keywords": [
     "pi-package",

package/extensions/minimal-footer/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/minimal-footer/README.md

@@ -7,6 +7,7 @@ A minimal custom footer for pi.
 It replaces pi's built-in footer with a cleaner two-line layout that focuses on the information I care about most:
 
 - current git branch
+- TLH-style git dirty counts, ahead/behind counts, and optional PR number
 - current repo name
 - current context percentage
 - red `DUMB ZONE` indicator when context usage is above 200k tokens
@@ -19,7 +20,7 @@ It replaces pi's built-in footer with a cleaner two-line layout that focuses on
 On wide terminals it renders two lines:
 
 ```text
-<git-branch>                                         <repo-name>
+<git-branch> · <git-status>                          <repo-name>
 <context-%>                                     <model> <thinking>
 ```
 
@@ -30,6 +31,14 @@ fix/remove-detached-image-tasks                     SendItToMy
 44.1%                                              gpt-5.4 high
 ```
 
+When the project is trusted and the repo has local or remote git state, the top-left line includes the same cached summary as `git-footer`:
+
+```text
+main · +1 ~2 ?3 ↑1 • PR #42
+```
+
+The markers are `!` conflicts, `+` staged, `~` unstaged, `?` untracked, `↑` ahead, and `↓` behind. PR numbers are fetched best-effort with `gh pr view`. Git polling is skipped until Pi reports that the project is trusted, and `git status` is run with fsmonitor disabled.
+
 When context usage is above 200k tokens, the bottom-left line includes a red warning:
 
 ```text
@@ -119,6 +128,12 @@ Example:
     "enabled": true,
     "label": "xp",
     "color": "warning"
+  },
+  "gitStatus": {
+    "enabled": true,
+    "refreshIntervalMs": 8000,
+    "gitTimeoutMs": 1500,
+    "ghTimeoutMs": 3000
   }
 }
 ```
@@ -169,6 +184,16 @@ Disable the experimental-features marker:
 }
 ```
 
+Disable git dirty/ahead/PR status:
+
+```json
+{
+  "gitStatus": {
+    "enabled": false
+  }
+}
+```
+
 ### Config fields
 
 - `context.showPercent`: show the context percentage
@@ -186,10 +211,14 @@ Disable the experimental-features marker:
 - `experimentalMarker.enabled`: show the marker when `PI_EXPERIMENTAL=1`
 - `experimentalMarker.label`: marker text
 - `experimentalMarker.color`: theme color for the marker (`error`, `warning`, `accent`, `text`, or `dim`)
+- `gitStatus.enabled`: show cached git dirty counts, ahead/behind counts, and optional PR number for trusted projects
+- `gitStatus.refreshIntervalMs`: background git status refresh interval
+- `gitStatus.gitTimeoutMs`: timeout for `git status --porcelain=v2 --branch`
+- `gitStatus.ghTimeoutMs`: timeout for best-effort `gh pr view`
 
 ## What it shows
 
-- **Top left:** current git branch
+- **Top left:** current git branch plus dirty/ahead/PR status when available
 - **Top right:** current repo directory name
 - **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
@@ -203,7 +232,7 @@ This extension also lives inside the broader [`pi-extensions`](../../README.md)
 ## Notes
 
 - Replaces pi's built-in footer entirely.
-- Uses pi footer data for git branch updates.
+- Uses pi footer data for git branch updates, plus background cached git/gh checks for dirty counts and PR number after project trust is granted.
 - 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.

package/extensions/minimal-footer/index.ts

@@ -1,4 +1,5 @@
 import { existsSync, readFileSync } from "node:fs";
+import { spawn } from "node:child_process";
 import { basename, dirname, join } from "node:path";
 import {
 	AuthStorage,
@@ -46,6 +47,12 @@ const DEFAULT_CONFIG: MinimalFooterConfig = {
 		label: "xp",
 		color: "warning",
 	},
+	gitStatus: {
+		enabled: true,
+		refreshIntervalMs: 8_000,
+		gitTimeoutMs: 1_500,
+		ghTimeoutMs: 3_000,
+	},
 };
 
 const DUMB_ZONE_COLORS = new Set<DumbZoneColor>([
@@ -92,6 +99,12 @@ interface MinimalFooterConfig {
 		label: string;
 		color: DumbZoneColor;
 	};
+	gitStatus: {
+		enabled: boolean;
+		refreshIntervalMs: number;
+		gitTimeoutMs: number;
+		ghTimeoutMs: number;
+	};
 }
 
 type UsageSessionState = {
@@ -103,6 +116,7 @@ type UsageSessionState = {
 	error?: string;
 	inflight?: Promise<void>;
 	requestRender?: () => void;
+	gitCache?: GitFooterCache;
 };
 
 type ProjectConfigContext = {
@@ -110,6 +124,67 @@ type ProjectConfigContext = {
 	isProjectTrusted?: () => boolean;
 };
 
+type GitStatusSnapshot = {
+	branch?: string;
+	staged: number;
+	unstaged: number;
+	untracked: number;
+	conflict: number;
+	ahead: number;
+	behind: number;
+};
+
+type PullRequestSnapshot = {
+	number?: number | string;
+	state?: string;
+	isDraft?: boolean;
+	url?: string;
+	title?: string;
+};
+
+type CommandResult = {
+	stdout: string;
+	stderr: string;
+	exitCode: number | null;
+};
+
+type CommandRunner = (
+	command: string,
+	args: readonly string[],
+	options: { cwd: string; signal: AbortSignal },
+) => Promise<CommandResult>;
+
+type TimerHandle = unknown;
+
+type Clock = {
+	setInterval(callback: () => void, ms: number): TimerHandle;
+	clearInterval(handle: TimerHandle): void;
+};
+
+type GitFooterCacheOptions = {
+	cwd: () => string;
+	canRun?: () => boolean;
+	runner?: CommandRunner;
+	clock?: Clock;
+	refreshIntervalMs?: number;
+	gitTimeoutMs?: number;
+	ghTimeoutMs?: number;
+	onChange?: () => void;
+};
+
+const BRANCH_HEAD_PREFIX = "# branch.head ";
+const BRANCH_AB_PREFIX = "# branch.ab ";
+const STATUS_SEPARATOR = " • ";
+const GIT_STATUS_ARGS = [
+	"--no-optional-locks",
+	"-c",
+	"core.fsmonitor=false",
+	"status",
+	"--porcelain=v2",
+	"--branch",
+] as const;
+const GH_PR_VIEW_ARGS = ["pr", "view", "--json", "number,state,isDraft,url,title"] as const;
+
 function readConfigFile(path: string): RecursivePartial<MinimalFooterConfig> {
 	if (!existsSync(path)) return {};
 
@@ -131,6 +206,7 @@ function mergeConfig(
 	const primaryWindow = codexUsage?.windows?.primary;
 	const secondaryWindow = codexUsage?.windows?.secondary;
 	const experimentalMarker = overrides.experimentalMarker;
+	const gitStatus = overrides.gitStatus;
 
 	return {
 		context: {
@@ -183,6 +259,21 @@ function mergeConfig(
 				base.experimentalMarker.color,
 			),
 		},
+		gitStatus: {
+			enabled: normalizeBoolean(gitStatus?.enabled, base.gitStatus.enabled),
+			refreshIntervalMs: normalizePositiveNumber(
+				gitStatus?.refreshIntervalMs,
+				base.gitStatus.refreshIntervalMs,
+			),
+			gitTimeoutMs: normalizePositiveNumber(
+				gitStatus?.gitTimeoutMs,
+				base.gitStatus.gitTimeoutMs,
+			),
+			ghTimeoutMs: normalizePositiveNumber(
+				gitStatus?.ghTimeoutMs,
+				base.gitStatus.ghTimeoutMs,
+			),
+		},
 	};
 }
 
@@ -239,6 +330,410 @@ function shouldShowExperimentalMarker(config: MinimalFooterConfig): boolean {
 	return config.experimentalMarker.enabled && process.env.PI_EXPERIMENTAL === "1";
 }
 
+function shouldShowGitStatus(config: MinimalFooterConfig): boolean {
+	return config.gitStatus.enabled;
+}
+
+function canRunProjectGit(ctx: ProjectConfigContext): boolean {
+	return canReadProjectConfig(ctx);
+}
+
+function createEmptyGitStatus(): GitStatusSnapshot {
+	return {
+		branch: undefined,
+		staged: 0,
+		unstaged: 0,
+		untracked: 0,
+		conflict: 0,
+		ahead: 0,
+		behind: 0,
+	};
+}
+
+function positiveCount(value: number): number {
+	return Number.isFinite(value) && value > 0 ? Math.trunc(value) : 0;
+}
+
+function addTrackedStatusCounts(status: GitStatusSnapshot, xy: string): void {
+	if (xy.length !== 2) return;
+	if (xy[0] !== ".") status.staged += 1;
+	if (xy[1] !== ".") status.unstaged += 1;
+}
+
+function parseBranchAheadBehind(line: string, status: GitStatusSnapshot): void {
+	const match = /^# branch\.ab \+(\d+) -(\d+)$/.exec(line);
+	if (!match) return;
+	status.ahead = Number.parseInt(match[1]!, 10);
+	status.behind = Number.parseInt(match[2]!, 10);
+}
+
+function normalizeBranchHead(value: string): string {
+	const branch = value.trim();
+	return branch === "(detached)" ? "detached" : branch;
+}
+
+function parseGitStatusPorcelainV2(output: string): GitStatusSnapshot {
+	const status = createEmptyGitStatus();
+
+	for (const rawLine of output.split("\n")) {
+		const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
+		if (!line) continue;
+
+		if (line.startsWith(BRANCH_HEAD_PREFIX)) {
+			status.branch = normalizeBranchHead(line.slice(BRANCH_HEAD_PREFIX.length)) || undefined;
+			continue;
+		}
+
+		if (line.startsWith(BRANCH_AB_PREFIX)) {
+			parseBranchAheadBehind(line, status);
+			continue;
+		}
+
+		if (line.startsWith("1 ") || line.startsWith("2 ")) {
+			addTrackedStatusCounts(status, line.slice(2, 4));
+			continue;
+		}
+
+		if (line.startsWith("u ")) {
+			status.conflict += 1;
+			continue;
+		}
+
+		if (line.startsWith("? ")) status.untracked += 1;
+	}
+
+	return status;
+}
+
+function formatGitStatusFooterSegment(status: GitStatusSnapshot | undefined): string | undefined {
+	if (!status) return undefined;
+
+	const parts: string[] = [];
+	const indicators: Array<[string, number]> = [
+		["!", positiveCount(status.conflict)],
+		["+", positiveCount(status.staged)],
+		["~", positiveCount(status.unstaged)],
+		["?", positiveCount(status.untracked)],
+		["↑", positiveCount(status.ahead)],
+		["↓", positiveCount(status.behind)],
+	];
+
+	for (const [prefix, count] of indicators) {
+		if (count > 0) parts.push(`${prefix}${count}`);
+	}
+
+	return parts.length > 0 ? parts.join(" ") : undefined;
+}
+
+function formatPullRequestFooterSegment(pullRequest: PullRequestSnapshot | undefined): string | undefined {
+	const value = pullRequest?.number;
+	if (Number.isSafeInteger(value) && Number(value) > 0) return `PR #${value}`;
+	if (typeof value === "string") {
+		const trimmed = value.trim();
+		if (/^[1-9]\d*$/.test(trimmed)) return `PR #${trimmed}`;
+	}
+	return undefined;
+}
+
+function formatGitFooterStatus(
+	status: GitStatusSnapshot | undefined,
+	pullRequest: PullRequestSnapshot | undefined,
+): string | undefined {
+	const parts = [
+		formatGitStatusFooterSegment(status),
+		formatPullRequestFooterSegment(pullRequest),
+	].filter((part): part is string => !!part);
+	return parts.length > 0 ? parts.join(STATUS_SEPARATOR) : undefined;
+}
+
+function parsePullRequestJson(stdout: string): PullRequestSnapshot | undefined {
+	const trimmed = stdout.trim();
+	if (!trimmed) return undefined;
+	let parsed: unknown;
+	try {
+		parsed = JSON.parse(trimmed);
+	} catch {
+		return undefined;
+	}
+	if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) return undefined;
+
+	const record = parsed as Record<string, unknown>;
+	const snapshot: PullRequestSnapshot = {};
+	if (typeof record.number === "number" || typeof record.number === "string") {
+		snapshot.number = record.number;
+	}
+	if (typeof record.state === "string") snapshot.state = record.state;
+	if (typeof record.isDraft === "boolean") snapshot.isDraft = record.isDraft;
+	if (typeof record.url === "string") snapshot.url = record.url;
+	if (typeof record.title === "string") snapshot.title = record.title;
+	return snapshot;
+}
+
+function gitStatusSnapshotsEqual(
+	left: GitStatusSnapshot | undefined,
+	right: GitStatusSnapshot | undefined,
+): boolean {
+	return (
+		left?.branch === right?.branch
+		&& left?.staged === right?.staged
+		&& left?.unstaged === right?.unstaged
+		&& left?.untracked === right?.untracked
+		&& left?.conflict === right?.conflict
+		&& left?.ahead === right?.ahead
+		&& left?.behind === right?.behind
+	);
+}
+
+function pullRequestSnapshotsEqual(
+	left: PullRequestSnapshot | undefined,
+	right: PullRequestSnapshot | undefined,
+): boolean {
+	return (
+		left?.number === right?.number
+		&& left?.state === right?.state
+		&& left?.isDraft === right?.isDraft
+		&& left?.url === right?.url
+		&& left?.title === right?.title
+	);
+}
+
+function defaultRunner(
+	command: string,
+	args: readonly string[],
+	options: { cwd: string; signal: AbortSignal },
+): Promise<CommandResult> {
+	return new Promise((resolve, reject) => {
+		let child;
+		try {
+			child = spawn(command, [...args], {
+				cwd: options.cwd,
+				stdio: ["ignore", "pipe", "pipe"],
+				windowsHide: true,
+			});
+		} catch (error) {
+			reject(error);
+			return;
+		}
+
+		let stdout = "";
+		let stderr = "";
+		let settled = false;
+
+		const finish = (result: CommandResult | Error) => {
+			if (settled) return;
+			settled = true;
+			options.signal.removeEventListener("abort", onAbort);
+			if (result instanceof Error) reject(result);
+			else resolve(result);
+		};
+
+		const onAbort = () => {
+			try {
+				child.kill("SIGTERM");
+			} catch {
+				// Ignore: process may already be gone.
+			}
+			finish(new Error("aborted"));
+		};
+
+		child.stdout?.on("data", (chunk: Buffer | string) => {
+			stdout += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+		});
+		child.stderr?.on("data", (chunk: Buffer | string) => {
+			stderr += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+		});
+		child.on("error", finish);
+		child.on("close", (code) => finish({ stdout, stderr, exitCode: code }));
+
+		if (options.signal.aborted) {
+			onAbort();
+			return;
+		}
+		options.signal.addEventListener("abort", onAbort, { once: true });
+	});
+}
+
+function defaultClock(): Clock {
+	return {
+		setInterval(callback, ms) {
+			const handle = setInterval(callback, ms);
+			(handle as { unref?: () => void }).unref?.();
+			return handle;
+		},
+		clearInterval(handle) {
+			clearInterval(handle as ReturnType<typeof setInterval>);
+		},
+	};
+}
+
+class GitFooterCache {
+	private readonly cwd: () => string;
+	private readonly canRun: () => boolean;
+	private readonly runner: CommandRunner;
+	private readonly clock: Clock;
+	private readonly refreshIntervalMs: number;
+	private readonly gitTimeoutMs: number;
+	private readonly ghTimeoutMs: number;
+	private readonly onChange: (() => void) | undefined;
+
+	private intervalHandle: TimerHandle | undefined;
+	private readonly inflightControllers = new Set<AbortController>();
+	private disposed = false;
+	private refreshInFlight: Promise<void> | undefined;
+	private statusSnapshot: GitStatusSnapshot | undefined;
+	private pullRequestSnapshot: PullRequestSnapshot | undefined;
+	private lastSeenBranch: string | undefined;
+
+	constructor(options: GitFooterCacheOptions) {
+		this.cwd = options.cwd;
+		this.canRun = options.canRun ?? (() => true);
+		this.runner = options.runner ?? defaultRunner;
+		this.clock = options.clock ?? defaultClock();
+		this.refreshIntervalMs = options.refreshIntervalMs ?? DEFAULT_CONFIG.gitStatus.refreshIntervalMs;
+		this.gitTimeoutMs = options.gitTimeoutMs ?? DEFAULT_CONFIG.gitStatus.gitTimeoutMs;
+		this.ghTimeoutMs = options.ghTimeoutMs ?? DEFAULT_CONFIG.gitStatus.ghTimeoutMs;
+		this.onChange = options.onChange;
+
+		this.intervalHandle = this.clock.setInterval(() => {
+			void this.refresh();
+		}, this.refreshIntervalMs);
+		void this.refresh();
+	}
+
+	getStatusSnapshot(): GitStatusSnapshot | undefined {
+		return this.statusSnapshot;
+	}
+
+	getPullRequestSnapshot(): PullRequestSnapshot | undefined {
+		return this.pullRequestSnapshot;
+	}
+
+	refresh(): Promise<void> {
+		if (this.disposed) return Promise.resolve();
+		if (!this.canRun()) {
+			const previousStatusSnapshot = this.statusSnapshot;
+			const previousPullRequestSnapshot = this.pullRequestSnapshot;
+			this.statusSnapshot = undefined;
+			this.pullRequestSnapshot = undefined;
+			this.lastSeenBranch = undefined;
+			this.emitChangeIfSnapshotsChanged(previousStatusSnapshot, previousPullRequestSnapshot);
+			return Promise.resolve();
+		}
+		if (this.refreshInFlight) return this.refreshInFlight;
+		const run = this.runRefresh()
+			.finally(() => {
+				this.refreshInFlight = undefined;
+			})
+			.catch(() => undefined);
+		this.refreshInFlight = run;
+		return run;
+	}
+
+	private async runRefresh(): Promise<void> {
+		const previousStatusSnapshot = this.statusSnapshot;
+		const previousPullRequestSnapshot = this.pullRequestSnapshot;
+
+		const result = await this.fetchGitStatus();
+		if (this.disposed) return;
+		if (result.kind === "transient") return;
+		if (result.kind === "not-a-repo") {
+			this.statusSnapshot = undefined;
+			this.pullRequestSnapshot = undefined;
+			this.lastSeenBranch = undefined;
+			this.emitChangeIfSnapshotsChanged(previousStatusSnapshot, previousPullRequestSnapshot);
+			return;
+		}
+
+		const status = result.status;
+		this.statusSnapshot = status;
+
+		const branch = typeof status.branch === "string" ? status.branch : undefined;
+		const isValidBranch = !!branch && branch !== "detached";
+		const branchChanged = branch !== this.lastSeenBranch;
+
+		if (branchChanged) this.pullRequestSnapshot = undefined;
+		this.lastSeenBranch = branch;
+
+		if (!isValidBranch) {
+			this.pullRequestSnapshot = undefined;
+			this.emitChangeIfSnapshotsChanged(previousStatusSnapshot, previousPullRequestSnapshot);
+			return;
+		}
+
+		const pr = await this.fetchPullRequest();
+		if (this.disposed) return;
+		if (pr !== undefined) this.pullRequestSnapshot = pr;
+		else if (branchChanged) this.pullRequestSnapshot = undefined;
+
+		this.emitChangeIfSnapshotsChanged(previousStatusSnapshot, previousPullRequestSnapshot);
+	}
+
+	private emitChangeIfSnapshotsChanged(
+		previousStatusSnapshot: GitStatusSnapshot | undefined,
+		previousPullRequestSnapshot: PullRequestSnapshot | undefined,
+	): void {
+		if (this.disposed) return;
+		if (
+			gitStatusSnapshotsEqual(previousStatusSnapshot, this.statusSnapshot)
+			&& pullRequestSnapshotsEqual(previousPullRequestSnapshot, this.pullRequestSnapshot)
+		) {
+			return;
+		}
+		try {
+			this.onChange?.();
+		} catch {
+			// Rendering hooks should not break refreshes.
+		}
+	}
+
+	private async fetchGitStatus(): Promise<
+		| { kind: "ok"; status: GitStatusSnapshot }
+		| { kind: "not-a-repo" }
+		| { kind: "transient" }
+	> {
+		const result = await this.runCommandSafely("git", GIT_STATUS_ARGS, this.gitTimeoutMs);
+		if (!result) return { kind: "transient" };
+		if (result.exitCode !== 0) return { kind: "not-a-repo" };
+		return { kind: "ok", status: parseGitStatusPorcelainV2(result.stdout) };
+	}
+
+	private async fetchPullRequest(): Promise<PullRequestSnapshot | undefined> {
+		const result = await this.runCommandSafely("gh", GH_PR_VIEW_ARGS, this.ghTimeoutMs);
+		if (!result || result.exitCode !== 0) return undefined;
+		return parsePullRequestJson(result.stdout);
+	}
+
+	private async runCommandSafely(
+		command: string,
+		args: readonly string[],
+		timeoutMs: number,
+	): Promise<CommandResult | undefined> {
+		if (this.disposed) return undefined;
+		const controller = new AbortController();
+		this.inflightControllers.add(controller);
+		const timeoutId = setTimeout(() => controller.abort(), timeoutMs);
+		try {
+			return await this.runner(command, args, { cwd: this.cwd(), signal: controller.signal });
+		} catch {
+			return undefined;
+		} finally {
+			clearTimeout(timeoutId);
+			this.inflightControllers.delete(controller);
+		}
+	}
+
+	dispose(): void {
+		if (this.disposed) return;
+		this.disposed = true;
+		if (this.intervalHandle !== undefined) {
+			this.clock.clearInterval(this.intervalHandle);
+			this.intervalHandle = undefined;
+		}
+		for (const controller of this.inflightControllers) controller.abort();
+		this.inflightControllers.clear();
+	}
+}
+
 function clearUsageState(state: UsageSessionState): void {
 	state.snapshot = undefined;
 	state.lastFetchedAt = undefined;
@@ -302,6 +797,28 @@ async function refreshUsageIfNeeded(
 export default function (pi: ExtensionAPI) {
 	const states = new WeakMap<object, UsageSessionState>();
 
+	function disposeGitCache(state: UsageSessionState): void {
+		state.gitCache?.dispose();
+		state.gitCache = undefined;
+	}
+
+	function ensureGitCache(ctx: ExtensionContext, state: UsageSessionState): void {
+		if (!shouldShowGitStatus(state.config) || !canRunProjectGit(ctx)) {
+			disposeGitCache(state);
+			return;
+		}
+
+		if (state.gitCache) return;
+		state.gitCache = new GitFooterCache({
+			cwd: () => ctx.cwd,
+			canRun: () => canRunProjectGit(ctx),
+			refreshIntervalMs: state.config.gitStatus.refreshIntervalMs,
+			gitTimeoutMs: state.config.gitStatus.gitTimeoutMs,
+			ghTimeoutMs: state.config.gitStatus.ghTimeoutMs,
+			onChange: () => state.requestRender?.(),
+		});
+	}
+
 	pi.on("session_start", (_event, ctx) => {
 		const state: UsageSessionState = {
 			authStorage: AuthStorage.create(),
@@ -310,6 +827,8 @@ export default function (pi: ExtensionAPI) {
 		};
 		states.set(ctx.sessionManager, state);
 
+		ensureGitCache(ctx, state);
+
 		ctx.ui.setFooter((tui, theme, footerData) => {
 			const unsub = footerData.onBranchChange(() => tui.requestRender());
 			state.requestRender = () => tui.requestRender();
@@ -318,12 +837,22 @@ export default function (pi: ExtensionAPI) {
 			return {
 				dispose() {
 					if (state.requestRender) state.requestRender = undefined;
+					disposeGitCache(state);
 					unsub();
 				},
 				invalidate() {},
 				render(width: number): string[] {
 					const repo = basename(ctx.cwd);
-					const branch = footerData.getGitBranch() ?? "";
+					const gitStatus = shouldShowGitStatus(state.config)
+						? formatGitFooterStatus(
+							state.gitCache?.getStatusSnapshot(),
+							state.gitCache?.getPullRequestSnapshot(),
+						)
+						: undefined;
+					const branch = footerData.getGitBranch()
+						?? state.gitCache?.getStatusSnapshot()?.branch
+						?? "";
+					const branchText = gitStatus ? [branch, gitStatus].filter(Boolean).join(" · ") : branch;
 
 					const usage = ctx.getContextUsage();
 					const context = usage?.percent == null ? "?" : `${usage.percent.toFixed(1)}%`;
@@ -337,7 +866,7 @@ export default function (pi: ExtensionAPI) {
 					const thinking = pi.getThinkingLevel();
 					const modelText = thinking === "off" ? model : `${model} ${thinking}`;
 
-					const branchStyled = theme.fg("dim", branch);
+					const branchStyled = theme.fg("dim", branchText);
 					const repoStyled = theme.fg("dim", repo);
 					const contextParts: string[] = [];
 					if (state.config.context.showPercent) contextParts.push(theme.fg("dim", context));
@@ -386,5 +915,13 @@ export default function (pi: ExtensionAPI) {
 		const state = states.get(ctx.sessionManager);
 		if (!state) return;
 		void refreshUsageIfNeeded(ctx, state);
+		ensureGitCache(ctx, state);
+		void state.gitCache?.refresh();
+	});
+
+	pi.on("session_shutdown", (_event, ctx) => {
+		const state = states.get(ctx.sessionManager);
+		if (!state) return;
+		disposeGitCache(state);
 	});
 }

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

@@ -27,5 +27,11 @@
     "enabled": true,
     "label": "xp",
     "color": "warning"
+  },
+  "gitStatus": {
+    "enabled": true,
+    "refreshIntervalMs": 8000,
+    "gitTimeoutMs": 1500,
+    "ghTimeoutMs": 3000
   }
 }

package/extensions/minimal-footer/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-minimal-footer",
-  "version": "0.1.10",
+  "version": "0.1.11",
   "description": "A minimal custom footer for pi.",
   "keywords": [
     "pi-package",

package/extensions/notify/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/notify/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-notify",
-  "version": "0.1.6",
+  "version": "0.1.7",
   "description": "A pi extension that sends a notification when the agent is ready for input.",
   "keywords": [
     "pi-package",

package/extensions/openai-fast/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/openai-fast/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-openai-fast",
-  "version": "0.1.5",
+  "version": "0.1.6",
   "description": "A pi extension that enables OpenAI Codex Fast mode for ChatGPT-auth GPT-5.4 and GPT-5.5 by injecting the priority service tier.",
   "keywords": [
     "pi-package",

package/extensions/oracle/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/oracle/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-oracle",
-  "version": "0.1.14",
+  "version": "0.1.15",
   "description": "An Amp-style oracle extension for pi that consults the strongest reasoning model on your current provider.",
   "keywords": [
     "pi-package",

package/extensions/permission-gate/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/permission-gate/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-permission-gate",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that prompts before dangerous bash commands.",
   "keywords": [
     "pi-package",

package/extensions/quiet-tools/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/quiet-tools/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-quiet-tools",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that visually compacts collapsed built-in tool rows in the TUI without changing tool results sent to the model.",
   "keywords": [
     "pi-package",

package/extensions/review/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/review/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-review",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A standalone pi extension that adds /review and /end-review commands adapted from mitsuhiko/agent-stuff.",
   "keywords": [
     "pi-package",

package/extensions/todo/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/todo/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-todo",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "A pi extension that adds a branch-aware todo tool and /todos viewer.",
   "keywords": [
     "pi-package",

package/extensions/triage-comments/.pi-fleet-tested-version

@@ -1 +1 @@
-0.78.0
+0.79.10

package/extensions/triage-comments/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-triage-comments",
-  "version": "0.1.3",
+  "version": "0.1.4",
   "description": "A pi extension that adds /triage-comments and a read-only triage_comments subagent tool for review-comment triage.",
   "keywords": [
     "pi-package",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@diegopetrucci/pi-extensions",
-  "version": "0.1.50",
+  "version": "0.1.51",
   "description": "A collection of pi extensions and skills for annotation UIs, context management, workflow audits, review-comment triage, notifications, brrr push alerts, safety guards, GitHub research, repo-local knowledge, todos, tool rendering, model/provider helpers, and Xiaohei-style article illustrations.",
   "keywords": [
     "pi-package",