@diegopetrucci/pi-minimal-footer 0.1.2

package/README.md

@@ -0,0 +1,74 @@
+# minimal-footer
+
+A minimal custom footer for pi.
+
+![minimal-footer preview](https://raw.githubusercontent.com/diegopetrucci/pi-extensions/main/assets/minimal-footer-preview.png)
+
+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
+- current repo name
+- current context percentage
+- current model and thinking level
+
+## Layout
+
+On wide terminals it renders two lines:
+
+```text
+<git-branch>                                         <repo-name>
+<context-%>                                     <model> • <thinking>
+```
+
+Example:
+
+```text
+fix/remove-detached-image-tasks                     SendItToMy
+44.1%                                              gpt-5.4 • high
+```
+
+On narrow terminals it falls back to one item per line.
+
+## Install
+
+### Standalone npm package
+
+```bash
+pi install npm:@diegopetrucci/pi-minimal-footer
+```
+
+### Collection package
+
+```bash
+pi install npm:@diegopetrucci/pi-extensions
+```
+
+### GitHub package
+
+```bash
+pi install git:github.com/diegopetrucci/pi-extensions
+```
+
+Then reload pi:
+
+```text
+/reload
+```
+
+## What it shows
+
+- **Top left:** current git branch
+- **Top right:** current repo directory name
+- **Bottom left:** current context usage percentage
+- **Bottom right:** model id and thinking level
+
+## Publishing notes
+
+This extension also lives inside the broader [`pi-extensions`](../../README.md) collection, but it is set up to be publishable as its own npm package too.
+
+## Notes
+
+- Replaces pi's built-in footer entirely.
+- Uses pi footer data for git branch updates.
+- Shows only context percentage, not context window size.
+- Shows the model id rather than a provider-specific display label.

package/index.ts

@@ -0,0 +1,54 @@
+import { basename } from "node:path";
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { truncateToWidth, visibleWidth } from "@mariozechner/pi-tui";
+
+export default function (pi: ExtensionAPI) {
+	pi.on("session_start", async (_event, ctx) => {
+		ctx.ui.setFooter((tui, theme, footerData) => {
+			const unsub = footerData.onBranchChange(() => tui.requestRender());
+
+			return {
+				dispose: unsub,
+				invalidate() {},
+				render(width: number): string[] {
+					const repo = basename(ctx.cwd);
+					const branch = footerData.getGitBranch() ?? "";
+
+					const usage = ctx.getContextUsage();
+					const context = usage?.percent == null ? "?" : `${usage.percent.toFixed(1)}%`;
+
+					const model = ctx.model?.id ?? "no-model";
+					const thinking = pi.getThinkingLevel();
+					const modelText = thinking === "off" ? model : `${model} • ${thinking}`;
+
+					const branchStyled = theme.fg("dim", branch);
+					const repoStyled = theme.fg("dim", repo);
+					const contextStyled = theme.fg("dim", context);
+					const modelStyled = theme.fg("dim", modelText);
+
+					const renderSplitLine = (left: string, right: string): string => {
+						const gap = " ".repeat(Math.max(2, width - visibleWidth(left) - visibleWidth(right)));
+						return truncateToWidth(left + gap + right, width);
+					};
+
+					const line1Fits = visibleWidth(branchStyled) + visibleWidth(repoStyled) + 2 <= width;
+					const line2Fits = visibleWidth(contextStyled) + visibleWidth(modelStyled) + 2 <= width;
+
+					if (line1Fits && line2Fits) {
+						return [
+							renderSplitLine(branchStyled, repoStyled),
+							renderSplitLine(contextStyled, modelStyled),
+						];
+					}
+
+					return [
+						truncateToWidth(branchStyled, width),
+						truncateToWidth(repoStyled, width),
+						truncateToWidth(contextStyled, width),
+						truncateToWidth(modelStyled, width),
+					];
+				},
+			};
+		});
+	});
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@diegopetrucci/pi-minimal-footer",
+  "version": "0.1.2",
+  "description": "A minimal custom footer for pi.",
+  "keywords": ["pi-package", "pi", "terminal", "footer"],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/diegopetrucci/pi-extensions.git",
+    "directory": "extensions/minimal-footer"
+  },
+  "files": [
+    "index.ts",
+    "README.md"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "index.ts"
+    ],
+    "image": "https://raw.githubusercontent.com/diegopetrucci/pi-extensions/main/assets/minimal-footer-preview.png"
+  },
+  "peerDependencies": {
+    "@mariozechner/pi-coding-agent": "*",
+    "@mariozechner/pi-tui": "*"
+  }
+}