granola-toolkit 0.25.0 → 0.26.0

package/README.md

@@ -37,6 +37,7 @@ granola exports --help
 granola meeting --help
 granola notes --help
 granola serve --help
+granola tui --help
 granola transcripts --help
 granola web --help
 ```
@@ -52,6 +53,7 @@ node dist/cli.js exports --help
 node dist/cli.js meeting --help
 node dist/cli.js notes --help
 node dist/cli.js serve --help
+node dist/cli.js tui --help
 node dist/cli.js transcripts --help
 node dist/cli.js web --help
 ```
@@ -62,6 +64,7 @@ You can also use the package scripts:
 npm run build
 npm run start -- meeting --help
 npm run notes -- --help
+npm run tui -- --help
 npm run transcripts -- --help
 ```
 
@@ -95,6 +98,8 @@ granola meeting view 1234abcd
 granola meeting notes 1234abcd
 granola meeting transcript 1234abcd --format json
 granola meeting export 1234abcd --format yaml
+granola tui
+granola tui --meeting 1234abcd
 ```
 
 Run the local API server:
@@ -242,6 +247,26 @@ The initial browser client includes:
 - stronger empty and error states for list/detail failures
 - a server-access panel that can unlock or lock a password-protected local server
 
+### TUI
+
+`tui` starts a full-screen terminal workspace on the shared app core, without requiring the local server or browser client.
+
+The initial terminal workspace includes:
+
+- a meeting list pane with keyboard navigation
+- a detail pane with notes, transcript, metadata, and raw views
+- a footer with app state and key hints
+- a quick-open overlay for jumping by title, id, or tag
+
+The main keyboard controls are:
+
+- `j` / `k` or arrow keys to move between meetings
+- `/` or `Ctrl+P` to open quick open
+- `1`-`4` to switch detail tabs
+- `PageUp` / `PageDown` to scroll the detail pane
+- `r` to refresh from live Granola data
+- `q` to quit
+
 ### Local Meeting Index
 
 Interactive meeting browsing now keeps a local index of meeting summaries and metadata.

package/dist/cli.js

@@ -8,6 +8,7 @@ import { execFile } from "node:child_process";
 import { promisify } from "node:util";
 import { createHash, randomUUID } from "node:crypto";
 import { createServer } from "node:http";
+import { Input, ProcessTerminal, TUI, matchesKey, truncateToWidth, visibleWidth, wrapTextWithAnsi } from "@mariozechner/pi-tui";
 //#region src/utils.ts
 const INVALID_FILENAME_CHARS = /[<>:"/\\|?*]/g;
 const CONTROL_CHARACTERS = /\p{Cc}/gu;
@@ -4789,6 +4790,649 @@ const serveCommand = {
 	}
 };
 //#endregion
+//#region src/tui/helpers.ts
+function splitQuery(query) {
+	return query.trim().toLowerCase().split(/\s+/).filter(Boolean);
+}
+function scoreMeetingTerm(meeting, term) {
+	const title = meeting.title.toLowerCase();
+	const id = meeting.id.toLowerCase();
+	const tags = meeting.tags.map((tag) => tag.toLowerCase());
+	if (title === term || id === term) return 0;
+	if (title.startsWith(term)) return 1;
+	if (id.startsWith(term)) return 2;
+	if (title.includes(term)) return 3;
+	if (id.includes(term)) return 4;
+	if (tags.some((tag) => tag.includes(term))) return 5;
+}
+function buildGranolaTuiQuickOpenItems(meetings, query) {
+	const terms = splitQuery(query);
+	return meetings.map((meeting) => {
+		const score = terms.reduce((current, term) => {
+			const termScore = scoreMeetingTerm(meeting, term);
+			if (termScore === void 0) return;
+			return (current ?? 0) + termScore;
+		}, 0);
+		if (terms.length > 0 && score === void 0) return;
+		const tags = meeting.tags.length > 0 ? meeting.tags.map((tag) => `#${tag}`).join(" ") : "untagged";
+		return {
+			description: `${meeting.updatedAt.slice(0, 10)} | ${tags} | ${meeting.id}`,
+			id: meeting.id,
+			label: meeting.title || meeting.id,
+			score: score ?? 99
+		};
+	}).filter((item) => item !== void 0).sort((left, right) => {
+		if (left.score !== right.score) return left.score - right.score;
+		if (left.description !== right.description) return right.description.localeCompare(left.description);
+		return left.label.localeCompare(right.label);
+	});
+}
+function renderGranolaTuiMeetingTab(bundle, tab) {
+	const summary = bundle.meeting.meeting;
+	switch (tab) {
+		case "metadata": return [
+			`Title: ${summary.title || summary.id}`,
+			`ID: ${summary.id}`,
+			`Created: ${summary.createdAt}`,
+			`Updated: ${summary.updatedAt}`,
+			`Tags: ${summary.tags.length > 0 ? summary.tags.join(", ") : "none"}`,
+			`Notes source: ${summary.noteContentSource}`,
+			`Transcript loaded: ${summary.transcriptLoaded ? "yes" : "no"}`,
+			`Transcript segments: ${summary.transcriptSegmentCount}`
+		].join("\n");
+		case "raw": return JSON.stringify(bundle, null, 2);
+		case "transcript": {
+			const transcript = renderMeetingTranscript(bundle.document, bundle.cacheData, "text").trim();
+			if (transcript) return transcript;
+			return bundle.cacheData ? "(Transcript unavailable)" : "(Granola cache not loaded)";
+		}
+		default: return renderMeetingNotes(bundle.document, "markdown").trim();
+	}
+}
+function buildGranolaTuiSummary(state, meetingSource) {
+	return `auth ${state.auth.mode === "stored-session" ? "stored" : "supabase"} | ${state.documents.loaded ? `${state.documents.count} docs` : "docs pending"} | ${state.cache.loaded ? `${state.cache.transcriptCount} transcript sets` : state.cache.configured ? "cache configured" : "cache missing"} | ${state.index.loaded ? `${state.index.meetingCount} indexed` : "index pending"} | list ${meetingSource}`;
+}
+//#endregion
+//#region src/tui/theme.ts
+const RESET = "\x1B[0m";
+function colour(code, text) {
+	return `\x1b[${code}m${text}${RESET}`;
+}
+const granolaTuiTheme = {
+	accent(text) {
+		return colour("36", text);
+	},
+	dim(text) {
+		return colour("2", text);
+	},
+	error(text) {
+		return colour("31", text);
+	},
+	info(text) {
+		return colour("32", text);
+	},
+	selected(text) {
+		return colour("7", text);
+	},
+	strong(text) {
+		return colour("1", text);
+	},
+	warning(text) {
+		return colour("33", text);
+	}
+};
+//#endregion
+//#region src/tui/palette.ts
+function padLine$1(text, width) {
+	const clipped = truncateToWidth(text, width, "");
+	return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+}
+function frameLine(text, width) {
+	return `| ${padLine$1(text, Math.max(1, width - 4))} |`;
+}
+var GranolaTuiQuickOpenPalette = class {
+	focused = false;
+	#input = new Input();
+	#matches;
+	#selectedIndex = 0;
+	constructor(options) {
+		this.options = options;
+		this.#matches = buildGranolaTuiQuickOpenItems(this.options.meetings, "");
+		this.#input.onEscape = () => {
+			this.options.onCancel();
+		};
+		this.#input.onSubmit = () => {
+			this.chooseSelection();
+		};
+	}
+	get query() {
+		return this.#input.getValue();
+	}
+	updateMatches() {
+		this.#matches = buildGranolaTuiQuickOpenItems(this.options.meetings, this.query);
+		this.#selectedIndex = Math.max(0, Math.min(this.#selectedIndex, this.#matches.length - 1));
+	}
+	async chooseSelection() {
+		const selected = this.#matches[this.#selectedIndex];
+		if (selected) {
+			await this.options.onPick(selected.id);
+			return;
+		}
+		if (this.query.trim()) {
+			await this.options.onResolveQuery(this.query.trim());
+			return;
+		}
+		this.options.onCancel();
+	}
+	invalidate() {}
+	handleInput(data) {
+		if (matchesKey(data, "up")) {
+			this.#selectedIndex = Math.max(0, this.#selectedIndex - 1);
+			return;
+		}
+		if (matchesKey(data, "down")) {
+			this.#selectedIndex = Math.min(this.#matches.length - 1, this.#selectedIndex + 1);
+			return;
+		}
+		if (matchesKey(data, "pageUp")) {
+			this.#selectedIndex = Math.max(0, this.#selectedIndex - 5);
+			return;
+		}
+		if (matchesKey(data, "pageDown")) {
+			this.#selectedIndex = Math.min(this.#matches.length - 1, this.#selectedIndex + 5);
+			return;
+		}
+		const before = this.query;
+		this.#input.focused = this.focused;
+		this.#input.handleInput(data);
+		if (before !== this.query) {
+			this.#selectedIndex = 0;
+			this.updateMatches();
+		}
+	}
+	render(width) {
+		const lines = [];
+		const bodyWidth = Math.max(32, width);
+		const visibleMatches = this.#matches.slice(0, 8);
+		lines.push(`+${"-".repeat(bodyWidth - 2)}+`);
+		lines.push(frameLine(granolaTuiTheme.strong("Quick Open") + granolaTuiTheme.dim("  title, id, or tag"), bodyWidth));
+		lines.push(frameLine("", bodyWidth));
+		for (const inputLine of this.#input.render(Math.max(1, bodyWidth - 4))) lines.push(frameLine(inputLine, bodyWidth));
+		for (const hintLine of wrapTextWithAnsi(granolaTuiTheme.dim("Enter to open, Esc to cancel, arrows to move"), Math.max(1, bodyWidth - 4))) lines.push(frameLine(hintLine, bodyWidth));
+		lines.push(frameLine("", bodyWidth));
+		if (visibleMatches.length === 0) lines.push(frameLine(granolaTuiTheme.warning("No matching meetings"), bodyWidth));
+		else for (const [index, item] of visibleMatches.entries()) {
+			const selected = index === this.#selectedIndex;
+			const title = `${selected ? "> " : "  "}${item.label}`;
+			const titleLine = selected ? granolaTuiTheme.selected(title) : title;
+			const detailLine = granolaTuiTheme.dim(`  ${item.description}`);
+			lines.push(frameLine(titleLine, bodyWidth));
+			lines.push(frameLine(detailLine, bodyWidth));
+		}
+		lines.push(`+${"-".repeat(bodyWidth - 2)}+`);
+		return lines;
+	}
+};
+//#endregion
+//#region src/tui/workspace.ts
+function padLine(text, width) {
+	const clipped = truncateToWidth(text, width, "");
+	return clipped + " ".repeat(Math.max(0, width - visibleWidth(clipped)));
+}
+function wrapBlock(text, width) {
+	const lines = [];
+	for (const line of text.split("\n")) {
+		const wrapped = wrapTextWithAnsi(line, Math.max(1, width));
+		if (wrapped.length === 0) {
+			lines.push("");
+			continue;
+		}
+		lines.push(...wrapped);
+	}
+	return lines;
+}
+function toneText(tone, text) {
+	switch (tone) {
+		case "error": return granolaTuiTheme.error(text);
+		case "warning": return granolaTuiTheme.warning(text);
+		default: return granolaTuiTheme.info(text);
+	}
+}
+var GranolaTuiWorkspace = class {
+	focused = false;
+	#maxMeetings;
+	#appState;
+	#detailError = "";
+	#detailScroll = 0;
+	#detailToken = 0;
+	#listError = "";
+	#listToken = 0;
+	#loadingDetail = false;
+	#loadingMeetings = false;
+	#meetingSource = "live";
+	#meetings = [];
+	#overlay;
+	#selectedMeeting;
+	#selectedMeetingId;
+	#statusMessage = "Loading meetings…";
+	#statusTone = "info";
+	#tab = "notes";
+	#unsubscribe;
+	constructor(tui, app, options) {
+		this.tui = tui;
+		this.app = app;
+		this.options = options;
+		this.#appState = app.getState();
+		this.#maxMeetings = options.maxMeetings ?? 200;
+	}
+	async initialise() {
+		this.#unsubscribe = this.app.subscribe((event) => {
+			this.handleAppUpdate(event);
+		});
+		await this.loadMeetings({
+			preferredMeetingId: this.options.initialMeetingId,
+			setStatus: true
+		});
+		if (this.options.initialMeetingId) await this.loadMeeting(this.options.initialMeetingId, { ensureMeetingVisible: true });
+		else if (this.#selectedMeetingId) this.loadMeeting(this.#selectedMeetingId);
+	}
+	dispose() {
+		this.#unsubscribe?.();
+		this.#unsubscribe = void 0;
+	}
+	invalidate() {}
+	handleAppUpdate(event) {
+		const previousDocumentsLoadedAt = this.#appState.documents.loadedAt;
+		this.#appState = event.state;
+		if (this.#meetingSource === "index" && event.state.documents.loadedAt && event.state.documents.loadedAt !== previousDocumentsLoadedAt && !this.#loadingMeetings) this.loadMeetings({ preferredMeetingId: this.#selectedMeetingId });
+		this.tui.requestRender();
+	}
+	setStatus(message, tone = "info") {
+		this.#statusMessage = message;
+		this.#statusTone = tone;
+		this.tui.requestRender();
+	}
+	normaliseSelectedIndex() {
+		if (this.#meetings.length === 0) return -1;
+		const selectedIndex = this.#selectedMeetingId ? this.#meetings.findIndex((meeting) => meeting.id === this.#selectedMeetingId) : -1;
+		return selectedIndex >= 0 ? selectedIndex : 0;
+	}
+	ensureMeetingVisible(meeting) {
+		const existingIndex = this.#meetings.findIndex((item) => item.id === meeting.id);
+		if (existingIndex >= 0) this.#meetings[existingIndex] = meeting;
+		else this.#meetings.push(meeting);
+		this.#meetings.sort((left, right) => {
+			if (left.updatedAt !== right.updatedAt) return right.updatedAt.localeCompare(left.updatedAt);
+			return left.title.localeCompare(right.title);
+		});
+	}
+	async loadMeetings(options = {}) {
+		const token = ++this.#listToken;
+		this.#loadingMeetings = true;
+		this.#listError = "";
+		if (options.setStatus !== false) this.setStatus(options.forceRefresh ? "Refreshing meetings…" : "Loading meetings…");
+		try {
+			const result = await this.app.listMeetings({
+				forceRefresh: options.forceRefresh,
+				limit: this.#maxMeetings,
+				preferIndex: true
+			});
+			if (token !== this.#listToken) return;
+			this.#meetings = result.meetings;
+			this.#meetingSource = result.source;
+			this.#selectedMeetingId = options.preferredMeetingId && this.#meetings.some((meeting) => meeting.id === options.preferredMeetingId) ? options.preferredMeetingId : this.#selectedMeetingId && this.#meetings.some((meeting) => meeting.id === this.#selectedMeetingId) ? this.#selectedMeetingId : this.#meetings[0]?.id;
+			this.#listError = "";
+			this.setStatus(result.source === "index" ? "Loaded meetings from the local index" : "Connected to Granola");
+		} catch (error) {
+			if (token !== this.#listToken) return;
+			const message = error instanceof Error ? error.message : String(error);
+			this.#listError = message;
+			this.setStatus(message, "error");
+			throw error;
+		} finally {
+			if (token === this.#listToken) {
+				this.#loadingMeetings = false;
+				this.tui.requestRender();
+			}
+		}
+	}
+	async loadMeeting(meetingId, options = {}) {
+		const token = ++this.#detailToken;
+		this.#loadingDetail = true;
+		this.#detailError = "";
+		this.#selectedMeetingId = meetingId;
+		this.#detailScroll = 0;
+		this.setStatus(`Opening ${meetingId}…`);
+		try {
+			const bundle = options.resolveQuery ? await this.app.findMeeting(meetingId) : await this.app.getMeeting(meetingId);
+			if (token !== this.#detailToken) return;
+			this.#selectedMeeting = bundle;
+			this.#selectedMeetingId = bundle.document.id;
+			if (options.ensureMeetingVisible) this.ensureMeetingVisible(bundle.meeting.meeting);
+			this.setStatus(`Opened ${bundle.meeting.meeting.title || bundle.meeting.meeting.id}`);
+		} catch (error) {
+			if (token !== this.#detailToken) return;
+			const message = error instanceof Error ? error.message : String(error);
+			this.#selectedMeeting = void 0;
+			this.#detailError = message;
+			this.setStatus(message, "error");
+		} finally {
+			if (token === this.#detailToken) {
+				this.#loadingDetail = false;
+				this.tui.requestRender();
+			}
+		}
+	}
+	async refresh(forceRefresh) {
+		try {
+			await this.loadMeetings({
+				forceRefresh,
+				preferredMeetingId: this.#selectedMeetingId
+			});
+			if (this.#selectedMeetingId) await this.loadMeeting(this.#selectedMeetingId, { ensureMeetingVisible: true });
+		} catch {}
+	}
+	async moveSelection(delta) {
+		if (this.#meetings.length === 0) return;
+		const currentIndex = this.normaliseSelectedIndex();
+		const nextIndex = Math.max(0, Math.min(this.#meetings.length - 1, currentIndex + delta));
+		const nextMeeting = this.#meetings[nextIndex];
+		if (!nextMeeting || nextMeeting.id === this.#selectedMeetingId) return;
+		await this.loadMeeting(nextMeeting.id);
+	}
+	currentDetailBody(width) {
+		if (this.#detailError) return wrapBlock(this.#detailError, width);
+		if (this.#loadingDetail && !this.#selectedMeeting) return wrapBlock("Loading meeting details…", width);
+		if (!this.#selectedMeeting) return wrapBlock("Select a meeting to inspect its notes, transcript, and metadata.", width);
+		return wrapBlock(renderGranolaTuiMeetingTab(this.#selectedMeeting, this.#tab), width);
+	}
+	detailScrollStep(width, height) {
+		const bodyHeight = Math.max(1, height - 2);
+		const totalLines = this.currentDetailBody(width).length;
+		if (totalLines <= bodyHeight) return 0;
+		return Math.max(1, Math.min(bodyHeight - 1, totalLines - bodyHeight));
+	}
+	scrollDetail(delta) {
+		const totalWidth = this.tui.terminal.columns;
+		const totalHeight = this.tui.terminal.rows;
+		const { detailWidth } = this.resolveLayout(totalWidth);
+		const bodyHeight = Math.max(1, totalHeight - 6);
+		const detailLines = this.currentDetailBody(Math.max(1, detailWidth - 2));
+		const visibleBodyLines = Math.max(1, bodyHeight - 2);
+		const maxScroll = Math.max(0, detailLines.length - visibleBodyLines);
+		this.#detailScroll = Math.max(0, Math.min(maxScroll, this.#detailScroll + delta));
+		this.tui.requestRender();
+	}
+	cycleTab(delta) {
+		const tabs = [
+			"notes",
+			"transcript",
+			"metadata",
+			"raw"
+		];
+		this.#tab = tabs[(tabs.indexOf(this.#tab) + delta + tabs.length) % tabs.length] ?? "notes";
+		this.#detailScroll = 0;
+		this.tui.requestRender();
+	}
+	openQuickOpen() {
+		if (this.#overlay) return;
+		const closeOverlay = () => {
+			this.#overlay?.hide();
+			this.#overlay = void 0;
+			this.tui.setFocus(this);
+			this.tui.requestRender();
+		};
+		const palette = new GranolaTuiQuickOpenPalette({
+			meetings: this.#meetings,
+			onCancel: closeOverlay,
+			onPick: async (meetingId) => {
+				closeOverlay();
+				await this.loadMeeting(meetingId, { ensureMeetingVisible: true });
+			},
+			onResolveQuery: async (query) => {
+				closeOverlay();
+				await this.loadMeeting(query, {
+					ensureMeetingVisible: true,
+					resolveQuery: true
+				});
+			}
+		});
+		this.#overlay = this.tui.showOverlay(palette, {
+			anchor: "center",
+			maxHeight: "60%",
+			minWidth: 48,
+			width: "70%"
+		});
+		this.setStatus("Quick open");
+	}
+	handleInput(data) {
+		if (matchesKey(data, "ctrl+c") || matchesKey(data, "q")) {
+			this.options.onExit();
+			return;
+		}
+		if (matchesKey(data, "r")) {
+			this.refresh(true);
+			return;
+		}
+		if (matchesKey(data, "/") || matchesKey(data, "ctrl+p")) {
+			this.openQuickOpen();
+			return;
+		}
+		if (matchesKey(data, "up") || matchesKey(data, "k")) {
+			this.moveSelection(-1);
+			return;
+		}
+		if (matchesKey(data, "down") || matchesKey(data, "j")) {
+			this.moveSelection(1);
+			return;
+		}
+		if (matchesKey(data, "pageUp")) {
+			this.scrollDetail(-Math.max(1, this.detailScrollStep(this.tui.terminal.columns, this.tui.terminal.rows)));
+			return;
+		}
+		if (matchesKey(data, "pageDown")) {
+			this.scrollDetail(this.detailScrollStep(this.tui.terminal.columns, this.tui.terminal.rows));
+			return;
+		}
+		if (matchesKey(data, "1")) {
+			this.#tab = "notes";
+			this.#detailScroll = 0;
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "2")) {
+			this.#tab = "transcript";
+			this.#detailScroll = 0;
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "3")) {
+			this.#tab = "metadata";
+			this.#detailScroll = 0;
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "4")) {
+			this.#tab = "raw";
+			this.#detailScroll = 0;
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "]")) {
+			this.cycleTab(1);
+			return;
+		}
+		if (matchesKey(data, "[")) this.cycleTab(-1);
+	}
+	resolveLayout(width) {
+		const minimumDetailWidth = 24;
+		const minimumListWidth = 24;
+		const available = Math.max(1, width - 3);
+		let listWidth = Math.max(minimumListWidth, Math.min(42, Math.floor(available * .34)));
+		let detailWidth = available - listWidth;
+		if (detailWidth < minimumDetailWidth) {
+			detailWidth = minimumDetailWidth;
+			listWidth = Math.max(minimumListWidth, available - detailWidth);
+		}
+		if (listWidth + detailWidth > available) detailWidth = Math.max(minimumDetailWidth, available - listWidth);
+		return {
+			detailWidth,
+			listWidth
+		};
+	}
+	renderListPane(width, height) {
+		const lines = [];
+		const innerWidth = Math.max(1, width - 2);
+		const header = `${granolaTuiTheme.strong("Meetings")} ${granolaTuiTheme.dim(`(${this.#meetings.length})`)}`;
+		lines.push(padLine(header, innerWidth));
+		if (this.#listError) {
+			lines.push(...wrapBlock(granolaTuiTheme.error(this.#listError), innerWidth).slice(0, height - 1));
+			while (lines.length < height) lines.push(" ".repeat(innerWidth));
+			return lines;
+		}
+		if (this.#meetings.length === 0) {
+			lines.push(...wrapBlock("No meetings available yet.", innerWidth).slice(0, height - 1));
+			while (lines.length < height) lines.push(" ".repeat(innerWidth));
+			return lines;
+		}
+		const selectedIndex = this.normaliseSelectedIndex();
+		const windowSize = Math.max(1, height - 1);
+		const startIndex = Math.max(0, Math.min(selectedIndex - Math.floor(windowSize / 2), this.#meetings.length - windowSize));
+		const visibleMeetings = this.#meetings.slice(startIndex, startIndex + windowSize);
+		for (const [offset, meeting] of visibleMeetings.entries()) {
+			const selected = startIndex + offset === selectedIndex;
+			const dateLabel = meeting.updatedAt.slice(0, 10);
+			const prefix = selected ? "> " : "  ";
+			const maxTitleWidth = Math.max(6, innerWidth - visibleWidth(prefix) - dateLabel.length - 1);
+			const titleBlock = `${prefix}${truncateToWidth(meeting.title || meeting.id, maxTitleWidth, "")}`;
+			const line = `${titleBlock}${" ".repeat(Math.max(1, innerWidth - visibleWidth(titleBlock) - visibleWidth(dateLabel)))}${granolaTuiTheme.dim(dateLabel)}`;
+			lines.push(selected ? padLine(granolaTuiTheme.selected(line), innerWidth) : padLine(line, innerWidth));
+		}
+		while (lines.length < height) lines.push(" ".repeat(innerWidth));
+		return lines;
+	}
+	renderDetailPane(width, height) {
+		const lines = [];
+		const innerWidth = Math.max(1, width - 2);
+		const tabs = [
+			{
+				id: "notes",
+				label: "1 Notes"
+			},
+			{
+				id: "transcript",
+				label: "2 Transcript"
+			},
+			{
+				id: "metadata",
+				label: "3 Metadata"
+			},
+			{
+				id: "raw",
+				label: "4 Raw"
+			}
+		];
+		const title = this.#selectedMeeting?.meeting.meeting.title || this.#selectedMeetingId || "Meeting";
+		const titleLine = `${granolaTuiTheme.strong(title)} ${granolaTuiTheme.dim(this.#selectedMeeting ? this.#selectedMeeting.meeting.meeting.id : "")}`.trim();
+		lines.push(padLine(titleLine, innerWidth));
+		const tabLine = tabs.map((tab) => tab.id === this.#tab ? granolaTuiTheme.selected(` ${tab.label} `) : ` ${tab.label} `).join(" ");
+		lines.push(padLine(tabLine, innerWidth));
+		const bodyLines = this.currentDetailBody(innerWidth);
+		const bodyHeight = Math.max(1, height - 2);
+		const visibleBody = bodyLines.slice(this.#detailScroll, this.#detailScroll + bodyHeight);
+		lines.push(...visibleBody.map((line) => padLine(line, innerWidth)));
+		while (lines.length < height) lines.push(" ".repeat(innerWidth));
+		return lines;
+	}
+	render(width) {
+		const totalHeight = Math.max(12, this.tui.terminal.rows);
+		const { detailWidth, listWidth } = this.resolveLayout(width);
+		const bodyHeight = Math.max(6, totalHeight - 2 - 2);
+		const selectedLabel = this.#selectedMeeting?.meeting.meeting.title || this.#selectedMeetingId || "none";
+		const headerTitle = padLine(`${granolaTuiTheme.accent("Granola Toolkit TUI")} ${granolaTuiTheme.dim(this.#loadingMeetings ? "loading…" : selectedLabel)}`, width);
+		const headerSummary = padLine(granolaTuiTheme.dim(buildGranolaTuiSummary(this.#appState, this.#meetingSource)), width);
+		const listLines = this.renderListPane(listWidth, bodyHeight);
+		const detailLines = this.renderDetailPane(detailWidth, bodyHeight);
+		const bodyLines = [];
+		for (let index = 0; index < bodyHeight; index += 1) bodyLines.push(`${padLine(listLines[index] ?? "", listWidth)} | ${padLine(detailLines[index] ?? "", detailWidth)}`);
+		const footerStatus = padLine(toneText(this.#statusTone, this.#statusMessage), width);
+		const footerHints = padLine(granolaTuiTheme.dim("/ quick open  r refresh  1-4 tabs  PgUp/PgDn scroll  q quit"), width);
+		return [
+			headerTitle,
+			headerSummary,
+			...bodyLines,
+			footerStatus,
+			footerHints
+		];
+	}
+};
+async function runGranolaTui(app, options = {}) {
+	const tui = new TUI(new ProcessTerminal());
+	return await new Promise((resolve, reject) => {
+		const workspace = new GranolaTuiWorkspace(tui, app, {
+			initialMeetingId: options.initialMeetingId,
+			onExit: () => {
+				workspace.dispose();
+				tui.stop();
+				resolve(0);
+			}
+		});
+		(async () => {
+			try {
+				await workspace.initialise();
+			} catch (error) {
+				workspace.dispose();
+				reject(error);
+				return;
+			}
+			tui.addChild(workspace);
+			tui.setFocus(workspace);
+			tui.start();
+			tui.requestRender(true);
+		})();
+	});
+}
+//#endregion
+//#region src/commands/tui.ts
+function tuiHelp() {
+	return `Granola tui
+
+Usage:
+  granola tui [options]
+
+Options:
+  --meeting <id>     Open the workspace focused on a specific meeting
+  --cache <path>     Path to Granola cache JSON
+  --timeout <value>  Request timeout, e.g. 2m, 30s, 120000 (default: 2m)
+  --supabase <path>  Path to supabase.json
+  --debug            Enable debug logging
+  --config <path>    Path to .granola.toml
+  -h, --help         Show help
+`;
+}
+const tuiCommand = {
+	description: "Start the Granola Toolkit terminal workspace",
+	flags: {
+		cache: { type: "string" },
+		help: { type: "boolean" },
+		meeting: { type: "string" },
+		timeout: { type: "string" }
+	},
+	help: tuiHelp,
+	name: "tui",
+	async run({ commandFlags, globalFlags }) {
+		const config = await loadConfig({
+			globalFlags,
+			subcommandFlags: commandFlags
+		});
+		debug(config.debug, "using config", config.configFileUsed ?? "(none)");
+		debug(config.debug, "supabase", config.supabase);
+		debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
+		debug(config.debug, "timeoutMs", config.notes.timeoutMs);
+		return await runGranolaTui(await createGranolaApp(config, { surface: "tui" }), { initialMeetingId: typeof commandFlags.meeting === "string" && commandFlags.meeting.trim() ? commandFlags.meeting.trim() : void 0 });
+	}
+};
+//#endregion
 //#region src/commands/transcripts.ts
 function transcriptsHelp() {
 	return `Granola transcripts
@@ -4905,6 +5549,7 @@ const commands = [
 	meetingCommand,
 	notesCommand,
 	serveCommand,
+	tuiCommand,
 	transcriptsCommand,
 	{
 		description: "Start the Granola Toolkit web workspace",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.25.0",
+  "version": "0.26.0",
   "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",
@@ -45,12 +45,14 @@
     "release:patch": "node scripts/release.mjs patch",
     "start": "node dist/cli.js",
     "notes": "node dist/cli.js notes",
+    "tui": "node dist/cli.js tui",
     "transcripts": "node dist/cli.js transcripts",
     "test": "vp test",
     "typecheck": "vp exec tsc --noEmit",
     "prepare": "vp config"
   },
   "dependencies": {
+    "@mariozechner/pi-tui": "^0.65.0",
     "node-html-markdown": "^2.0.0"
   },
   "devDependencies": {