pi-tropos 0.7.0 → 0.9.0

package/README.md

@@ -24,6 +24,10 @@ Personal pi customization bundle. One package, installable anywhere.
 - **Clean footer** — one line: `project branch` left; `↑in ↓out Rcache Wcache $cost` plus
   the dumbzone gauge right. Zero-valued counters hide; no full paths, no cache-hit %,
   no session titles. Auto-named sessions are sanitized (no markdown table junk).
+- **`/zen` mode** — reading mode for brainstorming: collapses all tool output and shrinks
+  the footer to `$cost` + the ctx gauge. `/zen` again restores your previous state.
+- **`/peek <path>`** — transient code viewer: syntax-highlighted, line-numbered overlay.
+  Scroll with ↑/↓/jk/PgUp/PgDn/g/G, Esc or q closes. Leaves no trace in the chat.
 - **Barista mascot** — the working spinner becomes a steaming cup of kaapi; every other
   brew cycle it's a boba 🧋. Hidden thinking blocks read "Steeping…".
 - **pi-smritikosh** — semantic codebase search, bundled as a dependency. One install
@@ -45,3 +49,20 @@ npm run typecheck
 ```
 
 No build step — pi loads the TypeScript directly.
+
+## Font (recommended)
+
+pi inherits the terminal's font — it can't set one. In VS Code (where pi usually runs):
+
+```jsonc
+// settings.json
+"terminal.integrated.fontFamily": "JetBrains Mono",
+"terminal.integrated.fontSize": 14,
+"terminal.integrated.lineHeight": 1.35,
+"terminal.integrated.fontLigatures.enabled": true
+```
+
+Good code-reading fonts: **JetBrains Mono** (free, tall x-height, superb at small sizes —
+`brew install --cask font-jetbrains-mono`), **SF Mono** (preinstalled on macOS),
+**Monaspace Neon** (GitHub's family — `brew install --cask font-monaspace`), **Berkeley
+Mono** (paid, beautiful). Size 13–14 + lineHeight 1.3–1.4 is the biggest readability win.

package/index.ts

@@ -3,12 +3,14 @@ import smritikosh from "pi-smritikosh/index.js";
 import barista from "./src/barista.js";
 import dumbzone from "./src/dumbzone.js";
 import footer from "./src/footer.js";
+import peek from "./src/peek.js";
 import sessions from "./src/sessions.js";
 
 export default function (pi: ExtensionAPI) {
 	barista(pi);
 	dumbzone(pi);
 	footer(pi);
+	peek(pi);
 	sessions(pi);
 	smritikosh(pi);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "pi-tropos",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "description": "Personal pi customization bundle — context-health indicator, session handoff, session browser",
   "type": "module",
   "keywords": [

package/src/footer.ts

@@ -1,12 +1,13 @@
 /**
- * Footer — clean one-line status bar.
+ * Footer — clean one-line status bar + /zen mode.
  *
- * Left:  project dir + git branch (dim)
- * Right: token & cost telemetry (dim, zero-values hidden) + extension
- *        statuses (e.g. the dumbzone ctx gauge, colored by health)
+ * Normal: `project branch` left; `↑in ↓out Rcache Wcache $cost` + extension
+ * statuses (e.g. the dumbzone ctx gauge) right. Zero-valued counters hide.
  *
- * Same data as the default footer, minus the noise: no full path, no
- * cache-hit %, no window size, no session title.
+ * /zen:  collapses all tool output and shrinks the footer to just
+ * `$cost` + the ctx gauge. Reading mode for brainstorming — the chat
+ * becomes the content. /zen again restores your previous state.
+ * (Zen lives here because the footer owns the chrome it minimizes.)
  */
 
 import type { ExtensionAPI, ExtensionContext } from "@earendil-works/pi-coding-agent";
@@ -20,38 +21,69 @@ interface Usage {
 	cost: { total: number };
 }
 
+interface Totals {
+	input: number;
+	output: number;
+	cacheRead: number;
+	cacheWrite: number;
+	cost: number;
+}
+
 function fmt(n: number) {
 	if (n >= 1_000_000) return `${(n / 1_000_000).toFixed(1)}M`;
 	if (n >= 1_000) return `${Math.round(n / 1_000)}k`;
 	return `${n}`;
 }
 
-function telemetry(ctx: ExtensionContext) {
-	let input = 0,
-		output = 0,
-		cacheRead = 0,
-		cacheWrite = 0,
-		cost = 0;
+function totals(ctx: ExtensionContext): Totals {
+	const t: Totals = { input: 0, output: 0, cacheRead: 0, cacheWrite: 0, cost: 0 };
 	for (const e of ctx.sessionManager.getBranch()) {
 		if (e.type !== "message" || e.message.role !== "assistant") continue;
 		const u = (e.message as { usage?: Usage }).usage;
 		if (!u) continue;
-		input += u.input;
-		output += u.output;
-		cacheRead += u.cacheRead ?? 0;
-		cacheWrite += u.cacheWrite ?? 0;
-		cost += u.cost?.total ?? 0;
+		t.input += u.input;
+		t.output += u.output;
+		t.cacheRead += u.cacheRead ?? 0;
+		t.cacheWrite += u.cacheWrite ?? 0;
+		t.cost += u.cost?.total ?? 0;
 	}
-	if (input === 0) return "";
-	const parts = [`↑${fmt(input)}`, `↓${fmt(output)}`];
-	if (cacheRead > 0) parts.push(`R${fmt(cacheRead)}`);
-	if (cacheWrite > 0) parts.push(`W${fmt(cacheWrite)}`);
-	parts.push(`$${cost.toFixed(2)}`);
+	return t;
+}
+
+function telemetryLine(t: Totals) {
+	if (t.input === 0) return "";
+	const parts = [`↑${fmt(t.input)}`, `↓${fmt(t.output)}`];
+	if (t.cacheRead > 0) parts.push(`R${fmt(t.cacheRead)}`);
+	if (t.cacheWrite > 0) parts.push(`W${fmt(t.cacheWrite)}`);
+	parts.push(`$${t.cost.toFixed(2)}`);
 	return parts.join(" ");
 }
 
+let zen = false;
+let wasExpanded = true;
+
 export default function footer(pi: ExtensionAPI) {
+	pi.registerCommand("zen", {
+		description: "Toggle zen mode — collapse tool noise, minimal footer",
+		handler: async (_args, ctx) => {
+			if (ctx.mode !== "tui") {
+				ctx.ui.notify("/zen needs interactive mode", "error");
+				return;
+			}
+			zen = !zen;
+			if (zen) {
+				wasExpanded = ctx.ui.getToolsExpanded();
+				ctx.ui.setToolsExpanded(false);
+				ctx.ui.notify("Zen ☁️ — Ctrl+T hides thinking · /zen to exit", "info");
+			} else {
+				ctx.ui.setToolsExpanded(wasExpanded);
+				ctx.ui.notify("Zen off — full telemetry restored", "info");
+			}
+		},
+	});
+
 	pi.on("session_start", (_event, ctx) => {
+		zen = false;
 		if (!ctx.hasUI) return;
 		ctx.ui.setFooter((tui, theme, footerData) => {
 			const unsub = footerData.onBranchChange(() => tui.requestRender());
@@ -59,13 +91,18 @@ export default function footer(pi: ExtensionAPI) {
 				dispose: unsub,
 				invalidate() {},
 				render(width: number): string[] {
+					const t = totals(ctx);
+					const statuses = [...footerData.getExtensionStatuses().values()].join(" ");
+
+					if (zen) {
+						const right = [t.cost > 0 ? `$${t.cost.toFixed(2)}` : "", statuses].filter(Boolean).join("  ");
+						return [truncateToWidth(theme.fg("dim", right), width)];
+					}
+
 					const dir = ctx.cwd.split("/").pop() ?? ctx.cwd;
 					const branch = footerData.getGitBranch();
 					const left = theme.fg("dim", branch ? `${dir} ${branch}` : dir);
-
-					const stats = telemetry(ctx);
-					const metrics = stats ? theme.fg("dim", stats) : "";
-					const statuses = [...footerData.getExtensionStatuses().values()].join(" ");
+					const metrics = theme.fg("dim", telemetryLine(t));
 					const right = [metrics, statuses].filter(Boolean).join("  ");
 
 					const pad = " ".repeat(Math.max(1, width - visibleWidth(left) - visibleWidth(right)));

package/src/peek.ts

@@ -0,0 +1,82 @@
+/**
+ * Peek — transient code viewer overlay. Leaves no trace in the chat.
+ *
+ *   /peek src/footer.ts
+ *
+ * Opens a centered overlay with the file syntax-highlighted (kaapi
+ * theme colors) and line-numbered. Scroll with ↑/↓, PgUp/PgDn, g/G;
+ * Esc or q closes. Nothing is appended to the transcript.
+ */
+
+import { readFileSync, statSync } from "node:fs";
+import { isAbsolute, join } from "node:path";
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent";
+import { getLanguageFromPath, highlightCode } from "@earendil-works/pi-coding-agent";
+import { ScrollView, truncateToWidth } from "@earendil-works/pi-tui";
+
+const MAX_BYTES = 200_000;
+
+export default function peek(pi: ExtensionAPI) {
+	pi.registerCommand("peek", {
+		description: "Peek at a file in a transient overlay — /peek <path>",
+		handler: async (args, ctx) => {
+			if (ctx.mode !== "tui") {
+				ctx.ui.notify("/peek needs interactive mode", "error");
+				return;
+			}
+			const target = args.trim();
+			if (!target) {
+				ctx.ui.notify("Usage: /peek <path>", "info");
+				return;
+			}
+			const path = isAbsolute(target) ? target : join(ctx.cwd, target);
+
+			let content: string;
+			try {
+				const stat = statSync(path);
+				if (!stat.isFile()) throw new Error("not a file");
+				if (stat.size > MAX_BYTES) throw new Error("file too large");
+				content = readFileSync(path, "utf-8");
+			} catch (err) {
+				ctx.ui.notify(`Cannot peek: ${err instanceof Error ? err.message : err}`, "error");
+				return;
+			}
+
+			const lang = getLanguageFromPath(path);
+			const highlighted = highlightCode(content, lang);
+
+			await ctx.ui.custom(
+				(tui, theme, _kb, done) => {
+					const gutter = String(highlighted.length).length;
+					const numbered = highlighted.map(
+						(line, i) => theme.fg("dim", `${String(i + 1).padStart(gutter)} │ `) + line,
+					);
+					const inner = {
+						invalidate() {},
+						render: (width: number) => numbered.map((l) => truncateToWidth(l, width - 2)),
+					};
+					const scroll = new ScrollView(inner, { follow: "none", overscroll: "contain" });
+
+					return {
+						invalidate() {},
+						render: (width: number) => scroll.render(width),
+						handleInput(data: string) {
+							if (data === "\x1b" || data === "q") return done(undefined);
+							if (data === "\x1b[A" || data === "k") scroll.scrollBy(-1);
+							else if (data === "\x1b[B" || data === "j") scroll.scrollBy(1);
+							else if (data === "\x1b[5~") scroll.scrollBy(-10);
+							else if (data === "\x1b[6~") scroll.scrollBy(10);
+							else if (data === "g") scroll.scrollToStart();
+							else if (data === "G") scroll.scrollToEnd();
+							tui.requestRender();
+						},
+					};
+				},
+				{
+					overlay: true,
+					overlayOptions: { width: "85%", maxHeight: "80%", anchor: "center" },
+				},
+			);
+		},
+	});
+}