@agnishc/edb-global-footer 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Changelog
+
+## [Unreleased]
+
+### Added
+- Initial release: two-line footer with path, git branch, token stats, cost, context %, and model
+- Optional third line for extension statuses
+- Git dirty/ahead/behind indicators refreshed after every turn

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agnish Chakraborty
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,27 @@
+# @agnishc/edb-global-footer
+
+A Pi CLI extension that renders a persistent two-line (plus optional third line) status footer at the bottom of every session.
+
+```
+~/Developer/my-project  main *  ↑2  my-session-name
+↑12.4k ↓3.2k R8.1k $0.042  (anthropic)  claude-sonnet-4
+⊕ 2 snippets  → 3 active  ✓ 5 done
+```
+
+**Line 1** — Working directory · git branch (dirty `*`, ahead `↑N`, behind `↓N`) · session name
+
+**Line 2** — Token usage (input/output/cache-read/cache-write) · cost · context window % · model name · thinking level
+
+**Line 3** — Active extension statuses (shown only when extensions set a status)
+
+Git status is refreshed after every turn and on branch change events.
+
+## Install
+
+```bash
+pi install npm:@agnishc/edb-global-footer
+```
+
+## License
+
+[MIT](LICENSE) © Agnish Chakraborty

package/package.json

@@ -0,0 +1,27 @@
+{
+	"name": "@agnishc/edb-global-footer",
+	"version": "0.1.0",
+	"description": "Pi extension: two-line status footer showing path, git branch, token usage, and model",
+	"keywords": ["pi-package", "pi-extension", "edb"],
+	"type": "module",
+	"license": "MIT",
+	"author": "Agnish Chakraborty",
+	"repository": {
+		"type": "git",
+		"url": "git+https://github.com/agnishcc/pi-extention-monorepo.git",
+		"directory": "packages/edb-global-footer"
+	},
+	"homepage": "https://github.com/agnishcc/pi-extention-monorepo/tree/main/packages/edb-global-footer#readme",
+	"bugs": { "url": "https://github.com/agnishcc/pi-extention-monorepo/issues" },
+	"publishConfig": { "access": "public" },
+	"scripts": { "test": "vitest run" },
+	"files": ["src", "README.md", "LICENSE", "CHANGELOG.md"],
+	"pi": {
+		"extensions": ["./src/index.ts"]
+	},
+	"peerDependencies": {
+		"@mariozechner/pi-ai": "*",
+		"@mariozechner/pi-coding-agent": "*",
+		"@mariozechner/pi-tui": "*"
+	}
+}

package/src/footer.ts

@@ -0,0 +1,122 @@
+import type { AssistantMessage } from "@mariozechner/pi-ai";
+import { truncateToWidth } from "@mariozechner/pi-tui";
+import {
+	formatThinkingLabel,
+	formatTokens,
+	getThinkingLevel,
+	renderFooterLine,
+	sanitizeStatusText,
+	shortenPath,
+} from "./format";
+import type { GitStatus } from "./types";
+
+// ── Footer renderer factory ────────────────────────────────────────────────────
+
+/**
+ * Returns the footer descriptor object accepted by ctx.ui.setFooter().
+ * Encapsulates all render logic for the two-line status footer.
+ */
+export function createFooterRenderer(ctx: any, getGitStatus: () => GitStatus | null, requestRender: () => void) {
+	return (_tui: any, theme: any, footerData: any) => {
+		const unsub = footerData.onBranchChange(() => {
+			requestRender();
+		});
+
+		return {
+			dispose() {
+				unsub();
+			},
+			invalidate() {},
+			render(width: number): string[] {
+				const sep = theme.fg("dim", " · ");
+				const sessionName = ctx.sessionManager.getSessionName();
+				const gitStatus = getGitStatus();
+
+				// ── Line 1: path · branch · session name ──────────────────────
+				const locationParts: string[] = [theme.fg("accent", shortenPath(ctx.cwd))];
+
+				if (gitStatus?.branch) {
+					let gitText = theme.fg(gitStatus.dirty ? "warning" : "success", gitStatus.branch);
+					if (gitStatus.dirty) gitText += theme.fg("warning", " *");
+					if (gitStatus.ahead) gitText += theme.fg("success", ` ↑${gitStatus.ahead}`);
+					if (gitStatus.behind) gitText += theme.fg("error", ` ↓${gitStatus.behind}`);
+					locationParts.push(gitText);
+				} else {
+					const branch = footerData.getGitBranch();
+					if (branch) locationParts.push(theme.fg("muted", branch));
+				}
+
+				if (sessionName) locationParts.push(theme.fg("muted", sessionName));
+				const locationLine = truncateToWidth(locationParts.join(sep), width);
+
+				// ── Line 2: token stats · model ───────────────────────────────
+				let totalInput = 0;
+				let totalOutput = 0;
+				let totalCacheRead = 0;
+				let totalCacheWrite = 0;
+				let totalCost = 0;
+				for (const entry of ctx.sessionManager.getEntries()) {
+					if (entry.type === "message" && entry.message.role === "assistant") {
+						const msg = entry.message as AssistantMessage;
+						totalInput += msg.usage.input;
+						totalOutput += msg.usage.output;
+						totalCacheRead += msg.usage.cacheRead;
+						totalCacheWrite += msg.usage.cacheWrite;
+						totalCost += msg.usage.cost.total;
+					}
+				}
+
+				const statsParts: string[] = [];
+				if (totalInput) statsParts.push(`↑${formatTokens(totalInput)}`);
+				if (totalOutput) statsParts.push(`↓${formatTokens(totalOutput)}`);
+				if (totalCacheRead) statsParts.push(`R${formatTokens(totalCacheRead)}`);
+				if (totalCacheWrite) statsParts.push(`W${formatTokens(totalCacheWrite)}`);
+
+				const usingSubscription = ctx.model ? ctx.modelRegistry.isUsingOAuth(ctx.model) : false;
+				if (totalCost || usingSubscription) {
+					statsParts.push(`$${totalCost.toFixed(3)}${usingSubscription ? " (sub)" : ""}`);
+				}
+
+				const contextUsage = ctx.getContextUsage();
+				if (contextUsage) {
+					const percentValue = contextUsage.percent ?? 0;
+					const percent = contextUsage.percent !== null ? `${contextUsage.percent.toFixed(1)}%` : "?";
+					const contextWindow = formatTokens(contextUsage.contextWindow);
+					const contextText = `${percent}/${contextWindow}`;
+					if (percentValue > 90) statsParts.push(theme.fg("error", contextText));
+					else if (percentValue > 70) statsParts.push(theme.fg("warning", contextText));
+					else statsParts.push(contextText);
+				}
+				const leftStats = statsParts.join(" ");
+
+				const model = ctx.model;
+				const rightParts: string[] = [];
+				if (model) {
+					if (model.provider && footerData.getAvailableProviderCount() > 1) {
+						rightParts.push(theme.fg("muted", `(${model.provider})`));
+					}
+					let modelText = theme.bold(model.id || "unknown");
+					if (model.reasoning) {
+						const thinking = formatThinkingLabel(getThinkingLevel(ctx));
+						if (thinking) modelText += `${sep}${theme.fg("dim", thinking)}`;
+					}
+					rightParts.push(modelText);
+				}
+				const statsLine = renderFooterLine(width, leftStats, rightParts.join(sep));
+
+				// ── Line 3 (optional): extension statuses ─────────────────────
+				const lines = [locationLine, statsLine];
+				const extensionStatuses = footerData.getExtensionStatuses();
+				if (extensionStatuses.size > 0) {
+					const statusLine = (Array.from(extensionStatuses.entries()) as [string, string][])
+						.sort(([a], [b]) => a.localeCompare(b))
+						.map(([, text]) => sanitizeStatusText(text))
+						.join(" ");
+					lines.push(truncateToWidth(statusLine, width, theme.fg("dim", "...")));
+				}
+
+				return lines.map((line) => truncateToWidth(line, width));
+			},
+		};
+	};
+}

package/src/format.ts

@@ -0,0 +1,71 @@
+import { buildSessionContext } from "@mariozechner/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+import type { ThinkingLevel } from "./types";
+
+// ── Format helpers ─────────────────────────────────────────────────────────────
+
+export function formatTokens(count: number): string {
+	if (count < 1000) return count.toString();
+	if (count < 10000) return `${(count / 1000).toFixed(1)}k`;
+	if (count < 1000000) return `${Math.round(count / 1000)}k`;
+	if (count < 10000000) return `${(count / 1000000).toFixed(1)}M`;
+	return `${Math.round(count / 1000000)}M`;
+}
+
+export function shortenPath(cwd: string): string {
+	const home = process.env.HOME || process.env.USERPROFILE;
+	if (home && cwd.startsWith(home)) return `~${cwd.slice(home.length)}`;
+	return cwd;
+}
+
+export function getThinkingLevel(ctx: {
+	sessionManager: {
+		getEntries(): unknown[];
+		getLeafId(): string | null;
+	};
+}): ThinkingLevel {
+	const context = buildSessionContext(ctx.sessionManager.getEntries() as any, ctx.sessionManager.getLeafId());
+	return (context.thinkingLevel || "off") as ThinkingLevel;
+}
+
+export function formatThinkingLabel(level: ThinkingLevel): string {
+	switch (level) {
+		case "minimal":
+			return "MI";
+		case "low":
+			return "L";
+		case "medium":
+			return "M";
+		case "high":
+			return "H";
+		case "xhigh":
+			return "XH";
+		default:
+			return "";
+	}
+}
+
+export function sanitizeStatusText(text: string): string {
+	return text
+		.replace(/[\r\n\t]/g, " ")
+		.replace(/ +/g, " ")
+		.trim();
+}
+
+export function renderFooterLine(width: number, left: string, right: string): string {
+	const leftWidth = visibleWidth(left);
+	const rightWidth = visibleWidth(right);
+	const minGap = 2;
+
+	if (leftWidth + minGap + rightWidth <= width) {
+		return left + " ".repeat(width - leftWidth - rightWidth) + right;
+	}
+
+	if (leftWidth + minGap + 10 <= width) {
+		const available = width - leftWidth - minGap;
+		const truncated = truncateToWidth(right, available, "");
+		return left + " ".repeat(Math.max(1, width - leftWidth - visibleWidth(truncated))) + truncated;
+	}
+
+	return truncateToWidth(left, width, "");
+}

package/src/git.ts

@@ -0,0 +1,45 @@
+import { execSync } from "node:child_process";
+import type { GitStatus } from "./types";
+
+// ── Git ────────────────────────────────────────────────────────────────────────
+
+export function parseGitStatus(output: string): GitStatus {
+	let branch: string | null = null;
+	let dirty = false;
+	let ahead = 0;
+	let behind = 0;
+
+	for (const line of output.split("\n")) {
+		if (!line) continue;
+		if (line.startsWith("# branch.head ")) {
+			const head = line.slice("# branch.head ".length).trim();
+			branch = head && head !== "(detached)" ? head : null;
+			continue;
+		}
+		if (line.startsWith("# branch.ab ")) {
+			const match = line.match(/^# branch\.ab \+(\d+) -(\d+)$/);
+			if (match) {
+				ahead = Number(match[1]) || 0;
+				behind = Number(match[2]) || 0;
+			}
+			continue;
+		}
+		if (!line.startsWith("# ")) dirty = true;
+	}
+
+	return { branch, dirty, ahead, behind };
+}
+
+export function readGitStatus(cwd: string): GitStatus | null {
+	try {
+		const output = execSync("git status --porcelain=v2 --branch 2>/dev/null", {
+			cwd,
+			encoding: "utf8",
+			timeout: 1000,
+			stdio: ["ignore", "pipe", "ignore"],
+		}).trimEnd();
+		return parseGitStatus(output);
+	} catch {
+		return null;
+	}
+}

package/src/index.ts

@@ -0,0 +1,60 @@
+/**
+ * pi-global-footer
+ *
+ * Renders a two-line status footer for every session:
+ *   Line 1 — working directory · git branch (dirty/ahead/behind) · session name
+ *   Line 2 — token usage · context window % · model name · thinking level
+ *   Line 3 — extension statuses (when any are active)
+ *
+ * Git status is refreshed after every turn and on branch change events.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { createFooterRenderer } from "./footer";
+import { readGitStatus } from "./git";
+import type { GitStatus } from "./types";
+
+// ── Extension ──────────────────────────────────────────────────────────────────
+
+export default function globalFooterExtension(pi: ExtensionAPI): void {
+	let tuiRef: { requestRender: () => void } | null = null;
+	let gitStatus: GitStatus | null = null;
+	let currentCwd = process.cwd();
+
+	const requestRender = () => tuiRef?.requestRender();
+	const refreshGit = () => {
+		gitStatus = readGitStatus(currentCwd);
+	};
+
+	pi.on("session_start", async (_event, ctx) => {
+		if (!ctx.hasUI) return;
+		currentCwd = ctx.cwd;
+		refreshGit();
+
+		ctx.ui.setFooter((tui, theme, footerData) => {
+			tuiRef = tui;
+
+			const descriptor = createFooterRenderer(ctx, () => gitStatus, requestRender)(tui, theme, footerData);
+
+			return {
+				dispose() {
+					descriptor.dispose();
+					if (tuiRef === tui) tuiRef = null;
+				},
+				invalidate: descriptor.invalidate,
+				render: descriptor.render,
+			};
+		});
+	});
+
+	pi.on("turn_end", async (_event, ctx) => {
+		currentCwd = ctx.cwd;
+		refreshGit();
+		requestRender();
+	});
+
+	pi.on("model_select", async (_event, ctx) => {
+		currentCwd = ctx.cwd;
+		requestRender();
+	});
+}

package/src/types.ts

@@ -0,0 +1,10 @@
+// ── Types ──────────────────────────────────────────────────────────────────────
+
+export type ThinkingLevel = "off" | "minimal" | "low" | "medium" | "high" | "xhigh";
+
+export interface GitStatus {
+	branch: string | null;
+	dirty: boolean;
+	ahead: number;
+	behind: number;
+}