chore: add .pi folder

.pi/extensions/diff.ts

@@ -0,0 +1,174 @@
+/**
+ * Diff Extension
+ *
+ * /diff command shows modified/deleted/new files from git status and opens
+ * the selected file in VS Code's diff view.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { DynamicBorder } from "@mariozechner/pi-coding-agent";
+import { Container, Key, matchesKey, type SelectItem, SelectList, Text } from "@mariozechner/pi-tui";
+
+interface FileInfo {
+	status: string;
+	statusLabel: string;
+	file: string;
+}
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("diff", {
+		description: "Show git changes and open in VS Code diff view",
+		handler: async (_args, ctx) => {
+			if (!ctx.hasUI) {
+				ctx.ui.notify("No UI available", "error");
+				return;
+			}
+
+			// Get changed files from git status
+			const result = await pi.exec("git", ["status", "--porcelain"], { cwd: ctx.cwd });
+
+			if (result.code !== 0) {
+				ctx.ui.notify(`git status failed: ${result.stderr}`, "error");
+				return;
+			}
+
+			if (!result.stdout || !result.stdout.trim()) {
+				ctx.ui.notify("No changes in working tree", "info");
+				return;
+			}
+
+			// Parse git status output
+			// Format: XY filename (where XY is two-letter status, then space, then filename)
+			const lines = result.stdout.split("\n");
+			const files: FileInfo[] = [];
+
+			for (const line of lines) {
+				if (line.length < 4) continue; // Need at least "XY f"
+
+				const status = line.slice(0, 2);
+				const file = line.slice(2).trimStart();
+
+				// Translate status codes to short labels
+				let statusLabel: string;
+				if (status.includes("M")) statusLabel = "M";
+				else if (status.includes("A")) statusLabel = "A";
+				else if (status.includes("D")) statusLabel = "D";
+				else if (status.includes("?")) statusLabel = "?";
+				else if (status.includes("R")) statusLabel = "R";
+				else if (status.includes("C")) statusLabel = "C";
+				else statusLabel = status.trim() || "~";
+
+				files.push({ status: statusLabel, statusLabel, file });
+			}
+
+			if (files.length === 0) {
+				ctx.ui.notify("No changes found", "info");
+				return;
+			}
+
+			const openSelected = async (fileInfo: FileInfo): Promise<void> => {
+				try {
+					// Open in VS Code diff view.
+					// For untracked files, git difftool won't work, so fall back to just opening the file.
+					if (fileInfo.status === "?") {
+						await pi.exec("code", ["-g", fileInfo.file], { cwd: ctx.cwd });
+						return;
+					}
+
+					const diffResult = await pi.exec("git", ["difftool", "-y", "--tool=vscode", fileInfo.file], {
+						cwd: ctx.cwd,
+					});
+					if (diffResult.code !== 0) {
+						await pi.exec("code", ["-g", fileInfo.file], { cwd: ctx.cwd });
+					}
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					ctx.ui.notify(`Failed to open ${fileInfo.file}: ${message}`, "error");
+				}
+			};
+
+			// Show file picker with SelectList
+			await ctx.ui.custom<void>((tui, theme, _kb, done) => {
+				const container = new Container();
+
+				// Top border
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+
+				// Title
+				container.addChild(new Text(theme.fg("accent", theme.bold(" Select file to diff")), 0, 0));
+
+				// Build select items with colored status
+				const items: SelectItem[] = files.map((f) => {
+					let statusColor: string;
+					switch (f.status) {
+						case "M":
+							statusColor = theme.fg("warning", f.status);
+							break;
+						case "A":
+							statusColor = theme.fg("success", f.status);
+							break;
+						case "D":
+							statusColor = theme.fg("error", f.status);
+							break;
+						case "?":
+							statusColor = theme.fg("muted", f.status);
+							break;
+						default:
+							statusColor = theme.fg("dim", f.status);
+					}
+					return {
+						value: f,
+						label: `${statusColor} ${f.file}`,
+					};
+				});
+
+				const visibleRows = Math.min(files.length, 15);
+				let currentIndex = 0;
+
+				const selectList = new SelectList(items, visibleRows, {
+					selectedPrefix: (t) => theme.fg("accent", t),
+					selectedText: (t) => t, // Keep existing colors
+					description: (t) => theme.fg("muted", t),
+					scrollInfo: (t) => theme.fg("dim", t),
+					noMatch: (t) => theme.fg("warning", t),
+				});
+				selectList.onSelect = (item) => {
+					void openSelected(item.value as FileInfo);
+				};
+				selectList.onCancel = () => done();
+				selectList.onSelectionChange = (item) => {
+					currentIndex = items.indexOf(item);
+				};
+				container.addChild(selectList);
+
+				// Help text
+				container.addChild(
+					new Text(theme.fg("dim", " ↑↓ navigate • ←→ page • enter open • esc close"), 0, 0),
+				);
+
+				// Bottom border
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+
+				return {
+					render: (w) => container.render(w),
+					invalidate: () => container.invalidate(),
+					handleInput: (data) => {
+						// Add paging with left/right
+						if (matchesKey(data, Key.left)) {
+							// Page up - clamp to 0
+							currentIndex = Math.max(0, currentIndex - visibleRows);
+							selectList.setSelectedIndex(currentIndex);
+						} else if (matchesKey(data, Key.right)) {
+							// Page down - clamp to last
+							currentIndex = Math.min(items.length - 1, currentIndex + visibleRows);
+							selectList.setSelectedIndex(currentIndex);
+						} else {
+							selectList.handleInput(data);
+						}
+						tui.requestRender();
+					},
+				};
+			});
+		},
+	});
+}

.pi/extensions/files.ts

@@ -0,0 +1,173 @@
+/**
+ * Files Extension
+ *
+ * /files command lists all files the model has read/written/edited in the active session branch,
+ * coalesced by path and sorted newest first. Selecting a file opens it in VS Code.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { DynamicBorder } from "@mariozechner/pi-coding-agent";
+import { Container, Key, matchesKey, type SelectItem, SelectList, Text } from "@mariozechner/pi-tui";
+
+interface FileEntry {
+	path: string;
+	operations: Set<"read" | "write" | "edit">;
+	lastTimestamp: number;
+}
+
+type FileToolName = "read" | "write" | "edit";
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("files", {
+		description: "Show files read/written/edited in this session",
+		handler: async (_args, ctx) => {
+			if (!ctx.hasUI) {
+				ctx.ui.notify("No UI available", "error");
+				return;
+			}
+
+			// Get the current branch (path from leaf to root)
+			const branch = ctx.sessionManager.getBranch();
+
+			// First pass: collect tool calls (id -> {path, name}) from assistant messages
+			const toolCalls = new Map<string, { path: string; name: FileToolName; timestamp: number }>();
+
+			for (const entry of branch) {
+				if (entry.type !== "message") continue;
+				const msg = entry.message;
+
+				if (msg.role === "assistant" && Array.isArray(msg.content)) {
+					for (const block of msg.content) {
+						if (block.type === "toolCall") {
+							const name = block.name;
+							if (name === "read" || name === "write" || name === "edit") {
+								const path = block.arguments?.path;
+								if (path && typeof path === "string") {
+									toolCalls.set(block.id, { path, name, timestamp: msg.timestamp });
+								}
+							}
+						}
+					}
+				}
+			}
+
+			// Second pass: match tool results to get the actual execution timestamp
+			const fileMap = new Map<string, FileEntry>();
+
+			for (const entry of branch) {
+				if (entry.type !== "message") continue;
+				const msg = entry.message;
+
+				if (msg.role === "toolResult") {
+					const toolCall = toolCalls.get(msg.toolCallId);
+					if (!toolCall) continue;
+
+					const { path, name } = toolCall;
+					const timestamp = msg.timestamp;
+
+					const existing = fileMap.get(path);
+					if (existing) {
+						existing.operations.add(name);
+						if (timestamp > existing.lastTimestamp) {
+							existing.lastTimestamp = timestamp;
+						}
+					} else {
+						fileMap.set(path, {
+							path,
+							operations: new Set([name]),
+							lastTimestamp: timestamp,
+						});
+					}
+				}
+			}
+
+			if (fileMap.size === 0) {
+				ctx.ui.notify("No files read/written/edited in this session", "info");
+				return;
+			}
+
+			// Sort by most recent first
+			const files = Array.from(fileMap.values()).sort((a, b) => b.lastTimestamp - a.lastTimestamp);
+
+			const openSelected = async (file: FileEntry): Promise<void> => {
+				try {
+					await pi.exec("code", ["-g", file.path], { cwd: ctx.cwd });
+				} catch (error) {
+					const message = error instanceof Error ? error.message : String(error);
+					ctx.ui.notify(`Failed to open ${file.path}: ${message}`, "error");
+				}
+			};
+
+			// Show file picker with SelectList
+			await ctx.ui.custom<void>((tui, theme, _kb, done) => {
+				const container = new Container();
+
+				// Top border
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+
+				// Title
+				container.addChild(new Text(theme.fg("accent", theme.bold(" Select file to open")), 0, 0));
+
+				// Build select items with colored operations
+				const items: SelectItem[] = files.map((f) => {
+					const ops: string[] = [];
+					if (f.operations.has("read")) ops.push(theme.fg("muted", "R"));
+					if (f.operations.has("write")) ops.push(theme.fg("success", "W"));
+					if (f.operations.has("edit")) ops.push(theme.fg("warning", "E"));
+					const opsLabel = ops.join("");
+					return {
+						value: f,
+						label: `${opsLabel} ${f.path}`,
+					};
+				});
+
+				const visibleRows = Math.min(files.length, 15);
+				let currentIndex = 0;
+
+				const selectList = new SelectList(items, visibleRows, {
+					selectedPrefix: (t) => theme.fg("accent", t),
+					selectedText: (t) => t, // Keep existing colors
+					description: (t) => theme.fg("muted", t),
+					scrollInfo: (t) => theme.fg("dim", t),
+					noMatch: (t) => theme.fg("warning", t),
+				});
+				selectList.onSelect = (item) => {
+					void openSelected(item.value as FileEntry);
+				};
+				selectList.onCancel = () => done();
+				selectList.onSelectionChange = (item) => {
+					currentIndex = items.indexOf(item);
+				};
+				container.addChild(selectList);
+
+				// Help text
+				container.addChild(
+					new Text(theme.fg("dim", " ↑↓ navigate • ←→ page • enter open • esc close"), 0, 0),
+				);
+
+				// Bottom border
+				container.addChild(new DynamicBorder((s: string) => theme.fg("accent", s)));
+
+				return {
+					render: (w) => container.render(w),
+					invalidate: () => container.invalidate(),
+					handleInput: (data) => {
+						// Add paging with left/right
+						if (matchesKey(data, Key.left)) {
+							// Page up - clamp to 0
+							currentIndex = Math.max(0, currentIndex - visibleRows);
+							selectList.setSelectedIndex(currentIndex);
+						} else if (matchesKey(data, Key.right)) {
+							// Page down - clamp to last
+							currentIndex = Math.min(items.length - 1, currentIndex + visibleRows);
+							selectList.setSelectedIndex(currentIndex);
+						} else {
+							selectList.handleInput(data);
+						}
+						tui.requestRender();
+					},
+				};
+			});
+		},
+	});
+}

.pi/extensions/prompt-url-widget.ts

@@ -0,0 +1,158 @@
+import { DynamicBorder, type ExtensionAPI, type ExtensionContext } from "@mariozechner/pi-coding-agent";
+import { Container, Text } from "@mariozechner/pi-tui";
+
+const PR_PROMPT_PATTERN = /^\s*You are given one or more GitHub PR URLs:\s*(\S+)/im;
+const ISSUE_PROMPT_PATTERN = /^\s*Analyze GitHub issue\(s\):\s*(\S+)/im;
+
+type PromptMatch = {
+	kind: "pr" | "issue";
+	url: string;
+};
+
+type GhMetadata = {
+	title?: string;
+	author?: {
+		login?: string;
+		name?: string | null;
+	};
+};
+
+function extractPromptMatch(prompt: string): PromptMatch | undefined {
+	const prMatch = prompt.match(PR_PROMPT_PATTERN);
+	if (prMatch?.[1]) {
+		return { kind: "pr", url: prMatch[1].trim() };
+	}
+
+	const issueMatch = prompt.match(ISSUE_PROMPT_PATTERN);
+	if (issueMatch?.[1]) {
+		return { kind: "issue", url: issueMatch[1].trim() };
+	}
+
+	return undefined;
+}
+
+async function fetchGhMetadata(
+	pi: ExtensionAPI,
+	kind: PromptMatch["kind"],
+	url: string,
+): Promise<GhMetadata | undefined> {
+	const args =
+		kind === "pr" ? ["pr", "view", url, "--json", "title,author"] : ["issue", "view", url, "--json", "title,author"];
+
+	try {
+		const result = await pi.exec("gh", args);
+		if (result.code !== 0 || !result.stdout) return undefined;
+		return JSON.parse(result.stdout) as GhMetadata;
+	} catch {
+		return undefined;
+	}
+}
+
+function formatAuthor(author?: GhMetadata["author"]): string | undefined {
+	if (!author) return undefined;
+	const name = author.name?.trim();
+	const login = author.login?.trim();
+	if (name && login) return `${name} (@${login})`;
+	if (login) return `@${login}`;
+	if (name) return name;
+	return undefined;
+}
+
+export default function promptUrlWidgetExtension(pi: ExtensionAPI) {
+	const setWidget = (ctx: ExtensionContext, match: PromptMatch, title?: string, authorText?: string) => {
+		ctx.ui.setWidget("prompt-url", (_tui, thm) => {
+			const titleText = title ? thm.fg("accent", title) : thm.fg("accent", match.url);
+			const authorLine = authorText ? thm.fg("muted", authorText) : undefined;
+			const urlLine = thm.fg("dim", match.url);
+
+			const lines = [titleText];
+			if (authorLine) lines.push(authorLine);
+			lines.push(urlLine);
+
+			const container = new Container();
+			container.addChild(new DynamicBorder((s: string) => thm.fg("muted", s)));
+			container.addChild(new Text(lines.join("\n"), 1, 0));
+			return container;
+		});
+	};
+
+	const applySessionName = (ctx: ExtensionContext, match: PromptMatch, title?: string) => {
+		const label = match.kind === "pr" ? "PR" : "Issue";
+		const trimmedTitle = title?.trim();
+		const fallbackName = `${label}: ${match.url}`;
+		const desiredName = trimmedTitle ? `${label}: ${trimmedTitle} (${match.url})` : fallbackName;
+		const currentName = pi.getSessionName()?.trim();
+		if (!currentName) {
+			pi.setSessionName(desiredName);
+			return;
+		}
+		if (currentName === match.url || currentName === fallbackName) {
+			pi.setSessionName(desiredName);
+		}
+	};
+
+	pi.on("before_agent_start", async (event, ctx) => {
+		if (!ctx.hasUI) return;
+		const match = extractPromptMatch(event.prompt);
+		if (!match) {
+			return;
+		}
+
+		setWidget(ctx, match);
+		applySessionName(ctx, match);
+		void fetchGhMetadata(pi, match.kind, match.url).then((meta) => {
+			const title = meta?.title?.trim();
+			const authorText = formatAuthor(meta?.author);
+			setWidget(ctx, match, title, authorText);
+			applySessionName(ctx, match, title);
+		});
+	});
+
+	pi.on("session_switch", async (_event, ctx) => {
+		rebuildFromSession(ctx);
+	});
+
+	const getUserText = (content: string | { type: string; text?: string }[] | undefined): string => {
+		if (!content) return "";
+		if (typeof content === "string") return content;
+		return (
+			content
+				.filter((block): block is { type: "text"; text: string } => block.type === "text")
+				.map((block) => block.text)
+				.join("\n") ?? ""
+		);
+	};
+
+	const rebuildFromSession = (ctx: ExtensionContext) => {
+		if (!ctx.hasUI) return;
+
+		const entries = ctx.sessionManager.getEntries();
+		const lastMatch = [...entries].reverse().find((entry) => {
+			if (entry.type !== "message" || entry.message.role !== "user") return false;
+			const text = getUserText(entry.message.content);
+			return !!extractPromptMatch(text);
+		});
+
+		const content =
+			lastMatch?.type === "message" && lastMatch.message.role === "user" ? lastMatch.message.content : undefined;
+		const text = getUserText(content);
+		const match = text ? extractPromptMatch(text) : undefined;
+		if (!match) {
+			ctx.ui.setWidget("prompt-url", undefined);
+			return;
+		}
+
+		setWidget(ctx, match);
+		applySessionName(ctx, match);
+		void fetchGhMetadata(pi, match.kind, match.url).then((meta) => {
+			const title = meta?.title?.trim();
+			const authorText = formatAuthor(meta?.author);
+			setWidget(ctx, match, title, authorText);
+			applySessionName(ctx, match, title);
+		});
+	};
+
+	pi.on("session_start", async (_event, ctx) => {
+		rebuildFromSession(ctx);
+	});
+}

.pi/extensions/redraws.ts

@@ -0,0 +1,24 @@
+/**
+ * Redraws Extension
+ *
+ * Exposes /tui to show TUI redraw stats.
+ */
+
+import type { ExtensionAPI } from "@mariozechner/pi-coding-agent";
+import { Text } from "@mariozechner/pi-tui";
+
+export default function (pi: ExtensionAPI) {
+	pi.registerCommand("tui", {
+		description: "Show TUI stats",
+		handler: async (_args, ctx) => {
+			if (!ctx.hasUI) return;
+			let redraws = 0;
+			await ctx.ui.custom<void>((tui, _theme, _keybindings, done) => {
+				redraws = tui.fullRedraws;
+				done(undefined);
+				return new Text("", 0, 0);
+			});
+			ctx.ui.notify(`TUI full redraws: ${redraws}`, "info");
+		},
+	});
+}

.pi/git/.gitignore

@@ -0,0 +1,2 @@
+*
+!.gitignore

.pi/prompts/cl.md

@@ -0,0 +1,53 @@
+---
+description: Audit changelog entries before release
+---
+Audit changelog entries for all commits since the last release.
+
+## Process
+
+1. **Find the last release tag:**
+   ```bash
+   git tag --sort=-version:refname | head -1
+   ```
+
+2. **List all commits since that tag:**
+   ```bash
+   git log <tag>..HEAD --oneline
+   ```
+
+3. **Read each package's [Unreleased] section:**
+   - packages/ai/CHANGELOG.md
+   - packages/tui/CHANGELOG.md
+   - packages/coding-agent/CHANGELOG.md
+
+4. **For each commit, check:**
+   - Skip: changelog updates, doc-only changes, release housekeeping
+   - Determine which package(s) the commit affects (use `git show <hash> --stat`)
+   - Verify a changelog entry exists in the affected package(s)
+   - For external contributions (PRs), verify format: `Description ([#N](url) by [@user](url))`
+
+5. **Cross-package duplication rule:**
+   Changes in `ai`, `agent` or `tui` that affect end users should be duplicated to `coding-agent` changelog, since coding-agent is the user-facing package that depends on them.
+
+6. **Add New Features section after changelog fixes:**
+   - Insert a `### New Features` section at the start of `## [Unreleased]` in `packages/coding-agent/CHANGELOG.md`.
+   - Propose the top new features to the user for confirmation before writing them.
+   - Link to relevant docs and sections whenever possible.
+
+7. **Report:**
+   - List commits with missing entries
+   - List entries that need cross-package duplication
+   - Add any missing entries directly
+
+## Changelog Format Reference
+
+Sections (in order):
+- `### Breaking Changes` - API changes requiring migration
+- `### Added` - New features
+- `### Changed` - Changes to existing functionality
+- `### Fixed` - Bug fixes
+- `### Removed` - Removed features
+
+Attribution:
+- Internal: `Fixed foo ([#123](https://github.com/badlogic/pi-mono/issues/123))`
+- External: `Added bar ([#456](https://github.com/badlogic/pi-mono/pull/456) by [@user](https://github.com/user))`

.pi/prompts/is.md

@@ -0,0 +1,21 @@
+---
+description: Analyze GitHub issues (bugs or feature requests)
+---
+Analyze GitHub issue(s): $ARGUMENTS
+
+For each issue:
+
+1. Read the issue in full, including all comments and linked issues/PRs.
+
+2. **For bugs**:
+   - Ignore any root cause analysis in the issue (likely wrong)
+   - Read all related code files in full (no truncation)
+   - Trace the code path and identify the actual root cause
+   - Propose a fix
+
+3. **For feature requests**:
+   - Read all related code files in full (no truncation)
+   - Propose the most concise implementation approach
+   - List affected files and changes needed
+
+Do NOT implement unless explicitly asked. Analyze and propose only.

.pi/prompts/pr.md

@@ -0,0 +1,39 @@
+---
+description: Review PRs from URLs with structured issue and code analysis
+---
+You are given one or more GitHub PR URLs: $@
+
+For each PR URL, do the following in order:
+1. Read the PR page in full. Include description, all comments, all commits, and all changed files.
+2. Identify any linked issues referenced in the PR body, comments, commit messages, or cross links. Read each issue in full, including all comments.
+3. Analyze the PR diff. Read all relevant code files in full with no truncation from the current main branch and compare against the diff. Do not fetch PR file blobs unless a file is missing on main or the diff context is insufficient. Include related code paths that are not in the diff but are required to validate behavior.
+4. Check for a changelog entry in the relevant `packages/*/CHANGELOG.md` files. Report whether an entry exists. If missing, state that a changelog entry is required before merge and that you will add it if the user decides to merge. Follow the changelog format rules in AGENTS.md. Verify:
+   - Entry uses correct section (`### Breaking Changes`, `### Added`, `### Fixed`, etc.)
+   - External contributions include PR link and author: `Fixed foo ([#123](https://github.com/badlogic/pi-mono/pull/123) by [@user](https://github.com/user))`
+   - Breaking changes are in `### Breaking Changes`, not just `### Fixed`
+5. Check if packages/coding-agent/README.md, packages/coding-agent/docs/*.md, packages/coding-agent/examples/**/*.md require modification. This is usually the case when existing features have been changed, or new features have been added.
+6. Provide a structured review with these sections:
+   - Good: solid choices or improvements
+   - Bad: concrete issues, regressions, missing tests, or risks
+   - Ugly: subtle or high impact problems
+7. Add Questions or Assumptions if anything is unclear.
+8. Add Change summary and Tests.
+
+Output format per PR:
+PR: <url>
+Changelog:
+- ...
+Good:
+- ...
+Bad:
+- ...
+Ugly:
+- ...
+Questions or Assumptions:
+- ...
+Change summary:
+- ...
+Tests:
+- ...
+
+If no issues are found, say so under Bad and Ugly.