@henryqw/pi-footer 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Henry Wang
+
+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,64 @@
+# `@henryqw/pi-footer`
+
+Henry's opinionated Pi footer style: concise checkout identity plus essential usage and extension status details.
+
+## Install
+
+```bash
+pi install npm:@henryqw/pi-footer
+```
+
+## With
+
+| Package | Why |
+| --- | --- |
+| `@henryqw/pi-multi-codex` | Adds active Codex subscription quota and reset status. |
+| `@henryqw/pi-open-in` | Adds `/open` and `/set-open-in` commands for editor configuration. |
+
+## Use
+
+| Surface | Type | Purpose |
+| --- | --- | --- |
+| Footer | UI | Show checkout, usage, model, thinking, and extension statuses. |
+
+```text
+pi-packages · clear-field-f8d2
+↑ 12.4k · ↓ 2.1k · ↺ 84.3% · $ 0.127 · ◔ 36.8%    gpt-5.6-luna • high
+Codex #1 · 50% · 7d 1d 1h 22m
+```
+
+First line shows repository and branch. Linked-worktree branches drop generated `worktree/` prefix.
+
+Second line shows cumulative input tokens, output tokens, latest cache-hit rate, estimated cost, and context usage. Unavailable values render as `—` without a misleading percent sign. Active model and thinking level are right-aligned.
+
+`off` uses the same dim grey as the model name. Active levels use an ANSI-256 gradient: green `minimal`, yellow-green `low`, lime `medium`, yellow `high`, orange `xhigh`, and red `max`. `ultra` renders as a rainbow when the runtime supplies it. Pi 0.84.2 does not yet accept `ultra`, so that footer path remains unreachable until Pi adds it.
+
+Final line renders every non-empty status emitted through `ctx.ui.setStatus()`, sorted by status key. Producer text, spacing, colors, links, and glyphs are preserved, including Ponytail mode, GitHub PR state, and Codex quota.
+
+## Clickable checkout
+
+When `pi-open-in.json` command is exactly `code`, the accent-colored checkout name is an OSC 8 `vscode://` link to the current path. Other configured commands remain plain because terminal links cannot run arbitrary shell commands.
+
+Use Pi fullscreen TUI so Pi handles the custom URI:
+
+```json
+{
+  "tuiMode": "fullscreen"
+}
+```
+
+Set this through `/settings`, or launch with `--tui-mode fullscreen`. Then use normal primary click. Regular TUI delegates OSC 8 activation to the terminal; Ghostty uses `Cmd+click` but may not open custom URI schemes.
+
+## Remove
+
+```bash
+pi remove npm:@henryqw/pi-footer
+```
+
+## Development
+
+```bash
+npm test --workspace @henryqw/pi-footer
+npm run typecheck --workspace @henryqw/pi-footer
+npm run pack:check --workspace @henryqw/pi-footer
+```

package/extensions/footer.ts

@@ -0,0 +1,119 @@
+import { basename, dirname } from "node:path";
+import type { Usage } from "@earendil-works/pi-ai";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { hyperlink, truncateToWidth, visibleWidth } from "@earendil-works/pi-tui";
+import { configuredOpenUri } from "@henryqw/pi-open-in/open-uri";
+
+const THINKING_COLORS = {
+	minimal: 46,
+	low: 82,
+	medium: 118,
+	high: 220,
+	xhigh: 208,
+	max: 196,
+} as const;
+
+function formatTokens(count: number): string {
+	if (count < 1_000) return `${count}`;
+	if (count < 1_000_000) return `${(count / 1_000).toFixed(1)}k`;
+	return `${(count / 1_000_000).toFixed(1)}M`;
+}
+
+function sanitizeStatus(text: string): string {
+	return text.replace(/[\r\n]+/g, " ").trim();
+}
+
+function align(left: string, right: string, width: number, ellipsis: string): string {
+	const available = width - visibleWidth(left) - 2;
+	if (available <= 0) return truncateToWidth(left, width, ellipsis);
+	const clippedRight = truncateToWidth(right, available, "");
+	return left + " ".repeat(width - visibleWidth(left) - visibleWidth(clippedRight)) + clippedRight;
+}
+
+function color(text: string, ansi256: number): string {
+	return `\x1b[38;5;${ansi256}m${text}\x1b[39m`;
+}
+
+function rainbow(text: string): string {
+	const colors = [196, 220, 46, 39, 201];
+	return [...text].map((character, index) => color(character, colors[index % colors.length]!)).join("");
+}
+
+export default function footerExtension(pi: ExtensionAPI): void {
+	pi.on("session_start", async (_event, ctx) => {
+		if (ctx.mode !== "tui") return;
+
+		const git = await pi.exec(
+			"git",
+			["rev-parse", "--path-format=absolute", "--show-toplevel", "--git-common-dir"],
+			{ cwd: ctx.cwd },
+		);
+		const [root, commonDir] = git.stdout.trim().split(/\r?\n/);
+		const rootName = basename(root || ctx.cwd);
+		const commonName = commonDir && basename(commonDir) === ".git" ? basename(dirname(commonDir)) : undefined;
+		const repo = git.code === 0 ? commonName && commonName !== rootName ? commonName : rootName : basename(ctx.cwd);
+
+		ctx.ui.setFooter((tui, theme, data) => {
+			const unsubscribe = data.onBranchChange(() => tui.requestRender());
+			return {
+				dispose: unsubscribe,
+				invalidate() { },
+				render(width: number): string[] {
+					let input = 0;
+					let output = 0;
+					let cost = 0;
+					let cacheRate: number | undefined;
+					const add = (usage: Usage | undefined) => {
+						if (!usage) return;
+						input += usage.input;
+						output += usage.output;
+						cost += usage.cost.total;
+					};
+
+					for (const entry of ctx.sessionManager.getEntries()) {
+						if (entry.type === "message" && entry.message.role === "assistant") {
+							const usage = entry.message.usage;
+							const prompt = usage.input + usage.cacheRead + usage.cacheWrite;
+							cacheRate = prompt ? usage.cacheRead / prompt * 100 : 0;
+							add(usage);
+						} else if (entry.type === "message" && entry.message.role === "toolResult") {
+							add(entry.message.usage);
+						} else if (entry.type === "branch_summary" || entry.type === "compaction") {
+							add(entry.usage);
+						}
+					}
+
+					const branch = data.getGitBranch()?.replace(/^worktree\//, "");
+					const context = ctx.getContextUsage()?.percent;
+					const openUri = configuredOpenUri(ctx.cwd);
+					const statuses = [...data.getExtensionStatuses()]
+						.sort(([a], [b]) => a.localeCompare(b))
+						.map(([, text]) => sanitizeStatus(text))
+						.filter(Boolean);
+					const thinking = String(ctx.thinkingLevel ?? "off");
+					const thinkingColor = THINKING_COLORS[thinking as keyof typeof THINKING_COLORS];
+					const ellipsis = theme.fg("dim", "…");
+					const usage = theme.fg("dim", [
+						`↑ ${formatTokens(input)}`,
+						`↓ ${formatTokens(output)}`,
+						`↺ ${cacheRate === undefined ? "—" : `${cacheRate.toFixed(1)}%`}`,
+						`$ ${cost.toFixed(3)}`,
+						`◔ ${context == null ? "—" : `${context.toFixed(1)}%`}`,
+					].join(" · "));
+					const thinkingText = thinking === "ultra"
+						? rainbow(thinking)
+						: thinkingColor === undefined ? theme.fg("dim", thinking) : color(thinking, thinkingColor);
+					const model = theme.fg("dim", `${ctx.model?.id ?? "no-model"} • `) + thinkingText;
+					const identity = branch ? theme.fg("dim", `${repo} · `) : "";
+					const checkout = branch ?? repo;
+					const lines = [
+						identity + (openUri ? hyperlink(theme.fg("accent", checkout), openUri) : theme.fg("dim", checkout)),
+						align(usage, model, width, ellipsis),
+					];
+					if (statuses.length) lines.push(statuses.join(" "));
+					return lines.map((line) => truncateToWidth(line, width, ellipsis));
+				},
+			};
+		});
+	});
+}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@henryqw/pi-footer",
+  "version": "0.2.0",
+  "description": "Show concise repository, branch, and usage details in the Pi footer.",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "footer",
+    "worktree"
+  ],
+  "type": "module",
+  "engines": {
+    "node": ">=22.19.0"
+  },
+  "license": "MIT",
+  "files": [
+    "extensions",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "test": "node --test test/*.test.ts",
+    "typecheck": "tsc --noEmit --allowImportingTsExtensions --target ES2022 --module NodeNext --moduleResolution NodeNext --skipLibCheck extensions/*.ts test/*.test.ts",
+    "pack:check": "npm pack --dry-run"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-ai": "^0.84.2",
+    "@earendil-works/pi-coding-agent": "^0.84.2",
+    "@earendil-works/pi-tui": "^0.84.2"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/HenryQW/pi-packages.git",
+    "directory": "packages/pi-footer"
+  },
+  "bugs": {
+    "url": "https://github.com/HenryQW/pi-packages/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/footer.ts"
+    ]
+  },
+  "dependencies": {
+    "@henryqw/pi-open-in": "^0.2.0"
+  }
+}