granola-toolkit 0.32.0 → 0.34.0

package/README.md

@@ -79,6 +79,7 @@ Export notes:
 ```bash
 granola auth login
 granola notes
+granola notes --folder Team
 
 node dist/cli.js notes --supabase "$HOME/Library/Application Support/Granola/supabase.json"
 node dist/cli.js notes --format json --output ./notes-json
@@ -91,6 +92,7 @@ Export transcripts:
 ```bash
 node dist/cli.js transcripts --cache "$HOME/Library/Application Support/Granola/cache-v3.json"
 node dist/cli.js transcripts --format yaml --output ./transcripts-yaml
+granola transcripts --folder Team
 ```
 
 Inspect individual meetings:
@@ -143,6 +145,8 @@ The flow is:
 6. render that export as Markdown, JSON, YAML, or raw JSON
 7. write one file per document into the output directory
 
+When you pass `--folder <id|name>`, the export is filtered to that folder and, by default, written into a stable per-folder subdirectory under the notes output root.
+
 Content is chosen in this order:
 
 1. `notes`
@@ -169,6 +173,8 @@ The flow is:
 5. render each export as text, JSON, YAML, or raw JSON
 6. write one file per document into the output directory
 
+When you pass `--folder <id|name>`, the export is filtered to that folder and, by default, written into a stable per-folder subdirectory under the transcripts output root.
+
 Speaker labels are currently normalised to:
 
 - `You` for `microphone`
@@ -223,6 +229,8 @@ The current CLI surface includes:
 - `folder list`
 - `folder view <id|name>`
 - `meeting list --folder <id|name>`
+- `notes --folder <id|name>`
+- `transcripts --folder <id|name>`
 
 ### Server
 
@@ -250,9 +258,9 @@ The initial server API includes:
 - `POST /auth/logout`
 - `POST /auth/mode`
 - `POST /auth/refresh`
-- `POST /exports/notes`
+- `POST /exports/notes` with optional `folderId`
 - `POST /exports/jobs/:id/rerun`
-- `POST /exports/transcripts`
+- `POST /exports/transcripts` with optional `folderId`
 
 This is the shared runtime for `granola web` and `granola attach`.
 
@@ -287,6 +295,7 @@ The initial browser client includes:
 - app-state status from the shared core
 - an auth session panel for login, refresh, source switching, and sign-out
 - note and transcript export actions backed by the same local API
+- folder-scoped export actions that follow the currently selected folder
 - a recent export-jobs panel with rerun actions
 - stronger empty and error states for list/detail failures
 - a server-access panel that can unlock or lock a password-protected local server
@@ -319,6 +328,7 @@ That keeps the current single-package repo simple, while making a future split i
 
 The initial terminal workspace includes:
 
+- a folder scope inside the navigation pane, including an explicit All meetings view
 - a meeting list pane with keyboard navigation
 - a detail pane with notes, transcript, metadata, and raw views
 - an auth session overlay for import, refresh, source switching, and sign-out
@@ -327,7 +337,8 @@ The initial terminal workspace includes:
 
 The main keyboard controls are:
 
-- `j` / `k` or arrow keys to move between meetings
+- `h` / `l`, left / right, or `Tab` to switch between folders and meetings
+- `j` / `k` or arrow keys to move within the active folder or meeting list
 - `/` or `Ctrl+P` to open quick open
 - `a` to open auth session actions
 - `1`-`4` to switch detail tabs
@@ -352,6 +363,7 @@ The web client uses the index as a fast path and upgrades to live data automatic
 Exports are now tracked as jobs with:
 
 - persistent local history across CLI and web runs
+- explicit scope metadata for all-meetings and folder-scoped runs
 - running, completed, and failed status
 - per-export progress counters
 - rerun support from `granola exports rerun <job-id>` or the web client

package/dist/cli.js

@@ -218,16 +218,22 @@ var GranolaServerClient = class GranolaServerClient {
 	async listExportJobs(options = {}) {
 		return await this.requestJson(granolaExportJobsPath(options));
 	}
-	async exportNotes(format = "markdown") {
+	async exportNotes(format = "markdown", options = {}) {
 		return await this.requestJson(granolaTransportPaths.exportNotes, {
-			body: JSON.stringify({ format }),
+			body: JSON.stringify({
+				folderId: options.folderId,
+				format
+			}),
 			headers: { "content-type": "application/json" },
 			method: "POST"
 		});
 	}
-	async exportTranscripts(format = "text") {
+	async exportTranscripts(format = "text", options = {}) {
 		return await this.requestJson(granolaTransportPaths.exportTranscripts, {
-			body: JSON.stringify({ format }),
+			body: JSON.stringify({
+				folderId: options.folderId,
+				format
+			}),
 			headers: { "content-type": "application/json" },
 			method: "POST"
 		});
@@ -1345,6 +1351,7 @@ function renderGranolaTuiMeetingTab(bundle, tab) {
 			`ID: ${summary.id}`,
 			`Created: ${summary.createdAt}`,
 			`Updated: ${summary.updatedAt}`,
+			`Folders: ${summary.folders.length > 0 ? summary.folders.map((folder) => folder.name).join(", ") : "none"}`,
 			`Tags: ${summary.tags.length > 0 ? summary.tags.join(", ") : "none"}`,
 			`Notes source: ${summary.noteContentSource}`,
 			`Transcript loaded: ${summary.transcriptLoaded ? "yes" : "no"}`,
@@ -1360,7 +1367,7 @@ function renderGranolaTuiMeetingTab(bundle, tab) {
 	}
 }
 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}`;
+	return `auth ${state.auth.mode === "stored-session" ? "stored" : "supabase"} | ${state.documents.loaded ? `${state.documents.count} docs` : "docs pending"} | ${state.folders.loaded ? `${state.folders.count} folders` : "folders 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
@@ -1657,9 +1664,13 @@ var GranolaTuiWorkspace = class {
 	focused = false;
 	#maxMeetings;
 	#appState;
+	#activePane = "meetings";
 	#detailError = "";
 	#detailScroll = 0;
 	#detailToken = 0;
+	#folderError = "";
+	#folderToken = 0;
+	#folders = [];
 	#listError = "";
 	#listToken = 0;
 	#loadingDetail = false;
@@ -1667,6 +1678,7 @@ var GranolaTuiWorkspace = class {
 	#meetingSource = "live";
 	#meetings = [];
 	#overlay;
+	#selectedFolderId;
 	#selectedMeeting;
 	#selectedMeetingId;
 	#statusMessage = "Loading meetings…";
@@ -1679,11 +1691,13 @@ var GranolaTuiWorkspace = class {
 		this.options = options;
 		this.#appState = app.getState();
 		this.#maxMeetings = options.maxMeetings ?? 200;
+		this.#selectedFolderId = this.#appState.ui.selectedFolderId;
 	}
 	async initialise() {
 		this.#unsubscribe = this.app.subscribe((event) => {
 			this.handleAppUpdate(event);
 		});
+		await this.loadFolders({ setStatus: false });
 		await this.loadMeetings({
 			preferredMeetingId: this.options.initialMeetingId,
 			setStatus: true
@@ -1699,7 +1713,12 @@ var GranolaTuiWorkspace = class {
 	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.#selectedFolderId = event.state.ui.selectedFolderId;
+		this.#selectedMeetingId = event.state.ui.selectedMeetingId ?? this.#selectedMeetingId;
+		if (this.#meetingSource === "index" && event.state.documents.loadedAt && event.state.documents.loadedAt !== previousDocumentsLoadedAt && !this.#loadingMeetings) (async () => {
+			await this.loadFolders({ setStatus: false });
+			await this.loadMeetings({ preferredMeetingId: this.#selectedMeetingId });
+		})();
 		this.tui.requestRender();
 	}
 	setStatus(message, tone = "info") {
@@ -1712,6 +1731,11 @@ var GranolaTuiWorkspace = class {
 		const selectedIndex = this.#selectedMeetingId ? this.#meetings.findIndex((meeting) => meeting.id === this.#selectedMeetingId) : -1;
 		return selectedIndex >= 0 ? selectedIndex : 0;
 	}
+	normaliseSelectedFolderIndex() {
+		if (!this.#selectedFolderId) return 0;
+		const selectedIndex = this.#folders.findIndex((folder) => folder.id === this.#selectedFolderId);
+		return selectedIndex >= 0 ? selectedIndex + 1 : 0;
+	}
 	ensureMeetingVisible(meeting) {
 		const existingIndex = this.#meetings.findIndex((item) => item.id === meeting.id);
 		if (existingIndex >= 0) this.#meetings[existingIndex] = meeting;
@@ -1721,6 +1745,30 @@ var GranolaTuiWorkspace = class {
 			return left.title.localeCompare(right.title);
 		});
 	}
+	async loadFolders(options = {}) {
+		const token = ++this.#folderToken;
+		this.#folderError = "";
+		if (options.setStatus) this.setStatus(options.forceRefresh ? "Refreshing folders…" : "Loading folders…");
+		try {
+			const result = await this.app.listFolders({
+				forceRefresh: options.forceRefresh,
+				limit: 100
+			});
+			if (token !== this.#folderToken) return;
+			this.#folders = result.folders;
+			if (this.#selectedFolderId && !this.#folders.some((folder) => folder.id === this.#selectedFolderId)) this.#selectedFolderId = void 0;
+			this.#folderError = "";
+		} catch (error) {
+			if (token !== this.#folderToken) return;
+			const message = error instanceof Error ? error.message : String(error);
+			this.#folderError = message;
+			this.#folders = [];
+			this.#selectedFolderId = void 0;
+			this.setStatus(message, "error");
+		} finally {
+			if (token === this.#folderToken) this.tui.requestRender();
+		}
+	}
 	async loadMeetings(options = {}) {
 		const token = ++this.#listToken;
 		this.#loadingMeetings = true;
@@ -1728,6 +1776,7 @@ var GranolaTuiWorkspace = class {
 		if (options.setStatus !== false) this.setStatus(options.forceRefresh ? "Refreshing meetings…" : "Loading meetings…");
 		try {
 			const result = await this.app.listMeetings({
+				folderId: this.#selectedFolderId,
 				forceRefresh: options.forceRefresh,
 				limit: this.#maxMeetings,
 				preferIndex: true
@@ -1736,8 +1785,13 @@ var GranolaTuiWorkspace = class {
 			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;
+			if (!this.#selectedMeetingId) {
+				this.#selectedMeeting = void 0;
+				this.#detailError = "";
+				this.#detailScroll = 0;
+			}
 			this.#listError = "";
-			this.setStatus(result.source === "index" ? "Loaded meetings from the local index" : "Connected to Granola");
+			this.setStatus(result.source === "index" ? "Loaded meetings from the local index" : this.#selectedFolderId ? "Connected to Granola (folder scope)" : "Connected to Granola");
 		} catch (error) {
 			if (token !== this.#listToken) return;
 			const message = error instanceof Error ? error.message : String(error);
@@ -1780,6 +1834,10 @@ var GranolaTuiWorkspace = class {
 	}
 	async refresh(forceRefresh) {
 		try {
+			await this.loadFolders({
+				forceRefresh,
+				setStatus: false
+			});
 			await this.loadMeetings({
 				forceRefresh,
 				preferredMeetingId: this.#selectedMeetingId
@@ -1787,7 +1845,7 @@ var GranolaTuiWorkspace = class {
 			if (this.#selectedMeetingId) await this.loadMeeting(this.#selectedMeetingId, { ensureMeetingVisible: true });
 		} catch {}
 	}
-	async moveSelection(delta) {
+	async moveMeetingSelection(delta) {
 		if (this.#meetings.length === 0) return;
 		const currentIndex = this.normaliseSelectedIndex();
 		const nextIndex = Math.max(0, Math.min(this.#meetings.length - 1, currentIndex + delta));
@@ -1795,6 +1853,33 @@ var GranolaTuiWorkspace = class {
 		if (!nextMeeting || nextMeeting.id === this.#selectedMeetingId) return;
 		await this.loadMeeting(nextMeeting.id);
 	}
+	async moveFolderSelection(delta) {
+		const total = this.#folders.length + 1;
+		const currentIndex = this.normaliseSelectedFolderIndex();
+		const nextIndex = Math.max(0, Math.min(total - 1, currentIndex + delta));
+		const nextFolderId = nextIndex === 0 ? void 0 : this.#folders[nextIndex - 1]?.id;
+		if (nextFolderId === this.#selectedFolderId) return;
+		this.#selectedFolderId = nextFolderId;
+		this.#selectedMeeting = void 0;
+		this.#detailError = "";
+		this.#detailScroll = 0;
+		await this.loadMeetings({
+			preferredMeetingId: this.#selectedMeetingId,
+			setStatus: false
+		});
+		if (this.#selectedMeetingId) {
+			await this.loadMeeting(this.#selectedMeetingId, { ensureMeetingVisible: true });
+			return;
+		}
+		this.tui.requestRender();
+	}
+	async moveSelection(delta) {
+		if (this.#activePane === "folders") {
+			await this.moveFolderSelection(delta);
+			return;
+		}
+		await this.moveMeetingSelection(delta);
+	}
 	currentDetailBody(width) {
 		if (this.#detailError) return wrapBlock(this.#detailError, width);
 		if (this.#loadingDetail && !this.#selectedMeeting) return wrapBlock("Loading meeting details…", width);
@@ -1832,6 +1917,10 @@ var GranolaTuiWorkspace = class {
 	async reloadAfterAuthChange() {
 		const preferredMeetingId = this.#selectedMeeting?.document.id ?? this.#selectedMeetingId;
 		try {
+			await this.loadFolders({
+				forceRefresh: true,
+				setStatus: false
+			});
 			await this.loadMeetings({
 				forceRefresh: true,
 				preferredMeetingId,
@@ -1956,6 +2045,21 @@ var GranolaTuiWorkspace = class {
 			this.openAuthPanel();
 			return;
 		}
+		if (matchesKey(data, "tab")) {
+			this.#activePane = this.#activePane === "folders" ? "meetings" : "folders";
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "left") || matchesKey(data, "h")) {
+			this.#activePane = "folders";
+			this.tui.requestRender();
+			return;
+		}
+		if (matchesKey(data, "right") || matchesKey(data, "l")) {
+			this.#activePane = "meetings";
+			this.tui.requestRender();
+			return;
+		}
 		if (matchesKey(data, "up") || matchesKey(data, "k")) {
 			this.moveSelection(-1);
 			return;
@@ -2021,22 +2125,53 @@ var GranolaTuiWorkspace = class {
 	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));
+		const folderEntries = [{
+			id: void 0,
+			label: "All meetings",
+			meta: this.#folders.length > 0 ? `${this.#folders.length} folders` : "global scope"
+		}, ...this.#folders.map((folder) => ({
+			id: folder.id,
+			label: `${folder.isFavourite ? "★ " : ""}${folder.name || folder.id}`,
+			meta: `${folder.documentCount} meetings`
+		}))];
+		const availableRows = Math.max(2, height - 3);
+		const folderWindowSize = Math.min(Math.max(3, Math.min(8, Math.floor(availableRows * .35))), Math.max(1, availableRows - 1));
+		const meetingWindowSize = Math.max(1, availableRows - folderWindowSize);
+		const folderHeader = `${this.#activePane === "folders" ? granolaTuiTheme.accent("Folders") : granolaTuiTheme.strong("Folders")} ${granolaTuiTheme.dim(`(${this.#folders.length})`)}`;
+		lines.push(padLine(folderHeader, innerWidth));
+		if (this.#folderError) {
+			lines.push(...wrapBlock(granolaTuiTheme.error(this.#folderError), innerWidth).slice(0, folderWindowSize));
+			while (lines.length < 1 + folderWindowSize) lines.push(" ".repeat(innerWidth));
+		} else {
+			const selectedFolderIndex = this.normaliseSelectedFolderIndex();
+			const folderStartIndex = Math.max(0, Math.min(selectedFolderIndex - Math.floor(folderWindowSize / 2), folderEntries.length - folderWindowSize));
+			const visibleFolders = folderEntries.slice(folderStartIndex, folderStartIndex + folderWindowSize);
+			for (const [offset, folder] of visibleFolders.entries()) {
+				const selected = folderStartIndex + offset === selectedFolderIndex;
+				const prefix = selected ? "> " : "  ";
+				const maxLabelWidth = Math.max(6, innerWidth - visibleWidth(prefix) - visibleWidth(folder.meta) - 1);
+				const labelBlock = `${prefix}${truncateToWidth(folder.label, maxLabelWidth, "")}`;
+				const line = `${labelBlock}${" ".repeat(Math.max(1, innerWidth - visibleWidth(labelBlock) - visibleWidth(folder.meta)))}${granolaTuiTheme.dim(folder.meta)}`;
+				lines.push(selected ? padLine(granolaTuiTheme.selected(line), innerWidth) : padLine(line, innerWidth));
+			}
+			while (lines.length < 1 + folderWindowSize) lines.push(" ".repeat(innerWidth));
+		}
+		lines.push(padLine(granolaTuiTheme.dim(""), innerWidth));
+		const meetingsHeader = `${this.#activePane === "meetings" ? granolaTuiTheme.accent("Meetings") : granolaTuiTheme.strong("Meetings")} ${granolaTuiTheme.dim(`(${this.#meetings.length})`)}`;
+		lines.push(padLine(meetingsHeader, innerWidth));
 		if (this.#listError) {
-			lines.push(...wrapBlock(granolaTuiTheme.error(this.#listError), innerWidth).slice(0, height - 1));
+			lines.push(...wrapBlock(granolaTuiTheme.error(this.#listError), innerWidth).slice(0, meetingWindowSize));
 			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));
+			lines.push(...wrapBlock("No meetings available yet.", innerWidth).slice(0, meetingWindowSize));
 			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);
+		const startIndex = Math.max(0, Math.min(selectedIndex - Math.floor(meetingWindowSize / 2), this.#meetings.length - meetingWindowSize));
+		const visibleMeetings = this.#meetings.slice(startIndex, startIndex + meetingWindowSize);
 		for (const [offset, meeting] of visibleMeetings.entries()) {
 			const selected = startIndex + offset === selectedIndex;
 			const dateLabel = meeting.updatedAt.slice(0, 10);
@@ -2094,7 +2229,7 @@ var GranolaTuiWorkspace = class {
 		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  a auth  r refresh  1-4 tabs  PgUp/PgDn scroll  q quit"), width);
+		const footerHints = padLine(granolaTuiTheme.dim("h/l or Tab pane  j/k move  / quick open  a auth  r refresh  1-4 tabs  PgUp/PgDn scroll  q quit"), width);
 		return [
 			headerTitle,
 			headerSummary,
@@ -2845,6 +2980,42 @@ async function loadOptionalGranolaCache(cacheFile) {
 	return parseCacheContents(await readFile(cacheFile, "utf8"));
 }
 //#endregion
+//#region src/export-scope.ts
+const FOLDER_EXPORT_DIRECTORY = "_folders";
+function allExportScope() {
+	return { mode: "all" };
+}
+function folderExportScope(folder) {
+	return {
+		folderId: folder.id,
+		folderName: folder.name || folder.id,
+		mode: "folder"
+	};
+}
+function cloneExportScope(scope) {
+	return scope.mode === "folder" ? { ...scope } : { mode: "all" };
+}
+function normaliseExportScope(value) {
+	const record = asRecord(value);
+	if (!record) return allExportScope();
+	if (record.mode !== "folder") return allExportScope();
+	const folderId = stringValue(record.folderId);
+	const folderName = stringValue(record.folderName) || folderId;
+	if (!folderId) return allExportScope();
+	return {
+		folderId,
+		folderName,
+		mode: "folder"
+	};
+}
+function renderExportScopeLabel(scope) {
+	return scope.mode === "folder" ? `folder ${scope.folderName}` : "all meetings";
+}
+function resolveExportOutputDir(outputDir, scope, options = {}) {
+	if (scope.mode !== "folder" || options.scopedDirectory === false) return outputDir;
+	return join(outputDir, FOLDER_EXPORT_DIRECTORY, sanitiseFilename(scope.folderId, "folder"));
+}
+//#endregion
 //#region src/export-jobs.ts
 const EXPORT_JOBS_VERSION = 1;
 const MAX_EXPORT_JOBS = 100;
@@ -2870,6 +3041,7 @@ function normaliseJob(value) {
 		itemCount,
 		kind,
 		outputDir,
+		scope: normaliseExportScope(record.scope),
 		startedAt,
 		status,
 		written
@@ -3080,10 +3252,16 @@ function transcriptCount(cacheData) {
 	return Object.values(cacheData.transcripts).filter((segments) => segments.length > 0).length;
 }
 function cloneExportState(state) {
-	return state ? { ...state } : void 0;
+	return state ? {
+		...state,
+		scope: cloneExportScope(state.scope)
+	} : void 0;
 }
 function cloneExportJob(job) {
-	return { ...job };
+	return {
+		...job,
+		scope: cloneExportScope(job.scope)
+	};
 }
 function cloneFolderSummary(folder) {
 	return { ...folder };
@@ -3334,7 +3512,7 @@ var GranolaApp = class {
 		this.emitStateUpdate();
 		return cloneExportJob(job);
 	}
-	async startExportJob(kind, format, itemCount, outputDir) {
+	async startExportJob(kind, format, itemCount, outputDir, scope) {
 		return await this.updateExportJob({
 			completedCount: 0,
 			format,
@@ -3342,6 +3520,7 @@ var GranolaApp = class {
 			itemCount,
 			kind,
 			outputDir,
+			scope: cloneExportScope(scope),
 			startedAt: this.nowIso(),
 			status: "running",
 			written: 0
@@ -3611,25 +3790,29 @@ var GranolaApp = class {
 		this.setUiState({ view: "exports-history" });
 		return { jobs };
 	}
-	async exportNotes(format = "markdown") {
+	async exportNotes(format = "markdown", options = {}) {
+		const documents = await this.listDocuments();
+		const exportContext = await this.resolveExportContext(options.folderId);
+		const filteredDocuments = exportContext.documentIds ? documents.filter((document) => exportContext.documentIds.has(document.id)) : documents;
 		return await this.runNotesExport({
+			documents: filteredDocuments,
 			format,
-			outputDir: this.config.notes.output
+			outputDir: resolveExportOutputDir(options.outputDir ?? this.config.notes.output, exportContext.scope, { scopedDirectory: options.scopedOutput }),
+			scope: exportContext.scope
 		});
 	}
 	async runNotesExport(options) {
-		const documents = await this.listDocuments();
-		let job = await this.startExportJob("notes", options.format, documents.length, options.outputDir);
+		let job = await this.startExportJob("notes", options.format, options.documents.length, options.outputDir, options.scope);
 		let written = 0;
 		try {
-			written = await writeNotes(documents, options.outputDir, options.format, { onProgress: async (progress) => {
+			written = await writeNotes(options.documents, options.outputDir, options.format, { onProgress: async (progress) => {
 				job = await this.setExportJobProgress(job, {
 					completedCount: progress.completed,
 					written: progress.written
 				});
 			} });
 			job = await this.completeExportJob(job, {
-				completedCount: documents.length,
+				completedCount: options.documents.length,
 				written
 			});
 		} catch (error) {
@@ -3638,37 +3821,49 @@ var GranolaApp = class {
 		}
 		this.#state.exports.notes = {
 			format: options.format,
-			itemCount: documents.length,
+			itemCount: options.documents.length,
 			jobId: job.id,
 			outputDir: options.outputDir,
 			ranAt: this.nowIso(),
+			scope: cloneExportScope(options.scope),
 			written
 		};
 		this.emitStateUpdate();
-		this.setUiState({ view: "notes-export" });
+		this.setUiState({
+			selectedFolderId: options.scope.mode === "folder" ? options.scope.folderId : void 0,
+			view: "notes-export"
+		});
 		return {
-			documentCount: documents.length,
-			documents,
+			documentCount: options.documents.length,
+			documents: options.documents,
 			format: options.format,
 			job,
 			outputDir: options.outputDir,
+			scope: cloneExportScope(options.scope),
 			written
 		};
 	}
-	async exportTranscripts(format = "text") {
+	async exportTranscripts(format = "text", options = {}) {
+		const cacheData = await this.loadCache({ required: true });
+		if (!cacheData) throw this.missingCacheError();
+		const exportContext = await this.resolveExportContext(options.folderId);
+		const scopedCacheData = exportContext.documentIds ? {
+			documents: Object.fromEntries(Object.entries(cacheData.documents).filter(([id]) => exportContext.documentIds.has(id))),
+			transcripts: Object.fromEntries(Object.entries(cacheData.transcripts).filter(([id]) => exportContext.documentIds.has(id)))
+		} : cacheData;
 		return await this.runTranscriptsExport({
+			cacheData: scopedCacheData,
 			format,
-			outputDir: this.config.transcripts.output
+			outputDir: resolveExportOutputDir(options.outputDir ?? this.config.transcripts.output, exportContext.scope, { scopedDirectory: options.scopedOutput }),
+			scope: exportContext.scope
 		});
 	}
 	async runTranscriptsExport(options) {
-		const cacheData = await this.loadCache({ required: true });
-		if (!cacheData) throw this.missingCacheError();
-		const count = transcriptCount(cacheData);
-		let job = await this.startExportJob("transcripts", options.format, count, options.outputDir);
+		const count = transcriptCount(options.cacheData);
+		let job = await this.startExportJob("transcripts", options.format, count, options.outputDir, options.scope);
 		let written = 0;
 		try {
-			written = await writeTranscripts(cacheData, options.outputDir, options.format, { onProgress: async (progress) => {
+			written = await writeTranscripts(options.cacheData, options.outputDir, options.format, { onProgress: async (progress) => {
 				job = await this.setExportJobProgress(job, {
 					completedCount: progress.completed,
 					written: progress.written
@@ -3688,15 +3883,20 @@ var GranolaApp = class {
 			jobId: job.id,
 			outputDir: options.outputDir,
 			ranAt: this.nowIso(),
+			scope: cloneExportScope(options.scope),
 			written
 		};
 		this.emitStateUpdate();
-		this.setUiState({ view: "transcripts-export" });
+		this.setUiState({
+			selectedFolderId: options.scope.mode === "folder" ? options.scope.folderId : void 0,
+			view: "transcripts-export"
+		});
 		return {
-			cacheData,
+			cacheData: options.cacheData,
 			format: options.format,
 			job,
 			outputDir: options.outputDir,
+			scope: cloneExportScope(options.scope),
 			transcriptCount: count,
 			written
 		};
@@ -3704,15 +3904,28 @@ var GranolaApp = class {
 	async rerunExportJob(id) {
 		const job = this.#state.exports.jobs.find((candidate) => candidate.id === id);
 		if (!job) throw new Error(`export job not found: ${id}`);
-		if (job.kind === "notes") return await this.runNotesExport({
-			format: job.format,
-			outputDir: job.outputDir
+		if (job.kind === "notes") return await this.exportNotes(job.format, {
+			folderId: job.scope.mode === "folder" ? job.scope.folderId : void 0,
+			outputDir: job.outputDir,
+			scopedOutput: false
 		});
-		return await this.runTranscriptsExport({
-			format: job.format,
-			outputDir: job.outputDir
+		return await this.exportTranscripts(job.format, {
+			folderId: job.scope.mode === "folder" ? job.scope.folderId : void 0,
+			outputDir: job.outputDir,
+			scopedOutput: false
 		});
 	}
+	async resolveExportContext(folderId) {
+		if (!folderId) return { scope: allExportScope() };
+		const folders = await this.loadFolders({ required: true });
+		const summary = resolveFolder((folders ?? []).map((folder) => buildFolderSummary(folder)), folderId);
+		const rawFolder = (folders ?? []).find((candidate) => candidate.id === summary.id);
+		if (!rawFolder) throw new Error(`folder not found: ${folderId}`);
+		return {
+			documentIds: new Set(rawFolder.documentIds),
+			scope: folderExportScope(summary)
+		};
+	}
 };
 async function createGranolaApp(config, options = {}) {
 	const auth = await inspectDefaultGranolaAuth(config);
@@ -4003,8 +4216,8 @@ function renderExportJobs(jobs, format) {
 	if (format === "json") return toJson({ jobs });
 	if (format === "yaml") return toYaml({ jobs });
 	if (jobs.length === 0) return "No export jobs\n";
-	return `${["ID                           KIND         STATUS      FORMAT      ITEMS   WRITTEN  STARTED", ...jobs.map((job) => {
-		return `${job.id.padEnd(28).slice(0, 28)} ${job.kind.padEnd(12)} ${job.status.padEnd(11)} ${job.format.padEnd(11)} ${String(job.itemCount).padEnd(7)} ${String(job.written).padEnd(8)} ${job.startedAt.slice(0, 19)}`;
+	return `${["ID                           KIND         STATUS      FORMAT      SCOPE                ITEMS   WRITTEN  STARTED", ...jobs.map((job) => {
+		return `${job.id.padEnd(28).slice(0, 28)} ${job.kind.padEnd(12)} ${job.status.padEnd(11)} ${job.format.padEnd(11)} ${renderExportScopeLabel(job.scope).padEnd(20).slice(0, 20)} ${String(job.itemCount).padEnd(7)} ${String(job.written).padEnd(8)} ${job.startedAt.slice(0, 19)}`;
 	})].join("\n")}\n`;
 }
 const exportsCommand = {
@@ -4054,10 +4267,10 @@ async function rerun(id, commandFlags, globalFlags) {
 	debug(config.debug, "cacheFile", config.transcripts.cacheFile || "(none)");
 	const result = await (await createGranolaApp(config)).rerunExportJob(id);
 	if ("documentCount" in result) {
-		console.log(`✓ Reran notes export job ${result.job.id} to ${result.outputDir} (${result.written}/${result.documentCount} written)`);
+		console.log(`✓ Reran notes export job ${result.job.id} from ${renderExportScopeLabel(result.scope)} to ${result.outputDir} (${result.written}/${result.documentCount} written)`);
 		return 0;
 	}
-	console.log(`✓ Reran transcripts export job ${result.job.id} to ${result.outputDir} (${result.written}/${result.transcriptCount} written)`);
+	console.log(`✓ Reran transcripts export job ${result.job.id} from ${renderExportScopeLabel(result.scope)} to ${result.outputDir} (${result.written}/${result.transcriptCount} written)`);
 	return 0;
 }
 //#endregion
@@ -4297,6 +4510,12 @@ function escapeHtml(value) {
     .replaceAll('"', "&quot;");
 }
 
+function exportScopeLabel(scope) {
+  return scope && scope.mode === "folder"
+    ? "Folder: " + (scope.folderName || scope.folderId)
+    : "Scope: All meetings";
+}
+
 function setStatus(label, tone = "idle") {
   els.stateBadge.textContent = label;
   els.stateBadge.dataset.tone = tone;
@@ -4635,8 +4854,9 @@ function renderExportJobs() {
         "</div>",
         '<div class="job-card__status" data-status="' + escapeHtml(job.status) + '">' + escapeHtml(job.status) + "</div>",
         "</div>",
-        '<div class="job-card__meta">Format: ' + escapeHtml(job.format) + " • " + escapeHtml(progress) + " • Written: " + escapeHtml(String(job.written)) + "</div>",
+        '<div class="job-card__meta">Format: ' + escapeHtml(job.format) + " • " + escapeHtml(exportScopeLabel(job.scope)) + " • " + escapeHtml(progress) + " • Written: " + escapeHtml(String(job.written)) + "</div>",
         '<div class="job-card__meta">Started: ' + escapeHtml(job.startedAt.slice(0, 19)) + "</div>",
+        '<div class="job-card__meta">Output: ' + escapeHtml(job.outputDir) + "</div>",
         error,
         '<div class="job-card__actions">' + rerunButton + "</div>",
         "</article>",
@@ -4836,9 +5056,12 @@ async function syncAuthState() {
 }
 
 async function exportNotes() {
-  setStatus("Exporting notes…", "busy");
+  setStatus(state.selectedFolderId ? "Exporting folder notes…" : "Exporting notes…", "busy");
   await fetchJson("/exports/notes", {
-    body: JSON.stringify({ format: "markdown" }),
+    body: JSON.stringify({
+      folderId: state.selectedFolderId || undefined,
+      format: "markdown",
+    }),
     headers: { "content-type": "application/json" },
     method: "POST",
   });
@@ -4846,9 +5069,15 @@ async function exportNotes() {
 }
 
 async function exportTranscripts() {
-  setStatus("Exporting transcripts…", "busy");
+  setStatus(
+    state.selectedFolderId ? "Exporting folder transcripts…" : "Exporting transcripts…",
+    "busy",
+  );
   await fetchJson("/exports/transcripts", {
-    body: JSON.stringify({ format: "text" }),
+    body: JSON.stringify({
+      folderId: state.selectedFolderId || undefined,
+      format: "text",
+    }),
     headers: { "content-type": "application/json" },
     method: "POST",
   });
@@ -5930,6 +6159,9 @@ function parseAuthMode(value) {
 		default: throw new Error("invalid auth mode: expected stored-session or supabase-file");
 	}
 }
+function folderIdFromBody(value) {
+	return typeof value === "string" && value.trim() ? value.trim() : void 0;
+}
 function sendJson(response, body, init = {}) {
 	const payload = `${JSON.stringify(body, null, 2)}\n`;
 	response.writeHead(init.status ?? 200, {
@@ -6275,7 +6507,7 @@ async function startGranolaServer(app, options = {}) {
 			}
 			if (method === "POST" && path === granolaTransportPaths.exportNotes) {
 				const body = await readJsonBody(request);
-				sendJson(response, await app.exportNotes(noteFormatFromBody(body.format)), {
+				sendJson(response, await app.exportNotes(noteFormatFromBody(body.format), { folderId: folderIdFromBody(body.folderId) }), {
 					headers: originHeaders,
 					status: 202
 				});
@@ -6297,7 +6529,7 @@ async function startGranolaServer(app, options = {}) {
 			}
 			if (method === "POST" && path === granolaTransportPaths.exportTranscripts) {
 				const body = await readJsonBody(request);
-				sendJson(response, await app.exportTranscripts(transcriptFormatFromBody(body.format)), {
+				sendJson(response, await app.exportTranscripts(transcriptFormatFromBody(body.format), { folderId: folderIdFromBody(body.folderId) }), {
 					headers: originHeaders,
 					status: 202
 				});
@@ -6677,6 +6909,7 @@ Usage:
   granola notes [options]
 
 Options:
+  --folder <query>    Export only meetings inside one folder id or name
   --format <value>    Output format: markdown, json, yaml, raw (default: markdown)
   --output <path>     Output directory for note files (default: ./notes)
   --timeout <value>   Request timeout, e.g. 2m, 30s, 120000 (default: 2m)
@@ -6689,6 +6922,7 @@ Options:
 const notesCommand = {
 	description: "Export Granola notes",
 	flags: {
+		folder: { type: "string" },
 		format: { type: "string" },
 		help: { type: "boolean" },
 		output: { type: "string" },
@@ -6709,8 +6943,14 @@ const notesCommand = {
 		debug(config.debug, "format", format);
 		const app = await createGranolaApp(config);
 		debug(config.debug, "authMode", app.getState().auth.mode);
-		const result = await app.exportNotes(format);
-		console.log(`✓ Exported ${result.documentCount} notes to ${result.outputDir} (job ${result.job.id})`);
+		const folderQuery = typeof commandFlags.folder === "string" ? commandFlags.folder : void 0;
+		const folder = folderQuery ? await app.findFolder(folderQuery) : void 0;
+		debug(config.debug, "folder", folder?.id ?? "(all)");
+		const result = await app.exportNotes(format, {
+			folderId: folder?.id,
+			scopedOutput: typeof commandFlags.output !== "string"
+		});
+		console.log(`✓ Exported ${result.documentCount} notes from ${renderExportScopeLabel(result.scope)} to ${result.outputDir} (job ${result.job.id})`);
 		debug(config.debug, "notes written", result.written);
 		return 0;
 	}
@@ -6863,6 +7103,7 @@ Usage:
 
 Options:
   --cache <path>      Path to Granola cache JSON
+  --folder <query>    Export only meetings inside one folder id or name
   --format <value>    Output format: text, json, yaml, raw (default: text)
   --output <path>     Output directory for transcript files (default: ./transcripts)
   --debug             Enable debug logging
@@ -6874,6 +7115,7 @@ const transcriptsCommand = {
 	description: "Export Granola transcripts",
 	flags: {
 		cache: { type: "string" },
+		folder: { type: "string" },
 		format: { type: "string" },
 		help: { type: "boolean" },
 		output: { type: "string" }
@@ -6892,8 +7134,14 @@ const transcriptsCommand = {
 		debug(config.debug, "format", format);
 		const app = await createGranolaApp(config);
 		debug(config.debug, "authMode", app.getState().auth.mode);
-		const result = await app.exportTranscripts(format);
-		console.log(`✓ Exported ${result.transcriptCount} transcripts to ${result.outputDir} (job ${result.job.id})`);
+		const folderQuery = typeof commandFlags.folder === "string" ? commandFlags.folder : void 0;
+		const folder = folderQuery ? await app.findFolder(folderQuery) : void 0;
+		debug(config.debug, "folder", folder?.id ?? "(all)");
+		const result = await app.exportTranscripts(format, {
+			folderId: folder?.id,
+			scopedOutput: typeof commandFlags.output !== "string"
+		});
+		console.log(`✓ Exported ${result.transcriptCount} transcripts from ${renderExportScopeLabel(result.scope)} to ${result.outputDir} (job ${result.job.id})`);
 		debug(config.debug, "transcripts written", result.written);
 		return 0;
 	}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "granola-toolkit",
-  "version": "0.32.0",
+  "version": "0.34.0",
   "description": "Toolkit for exporting and working with Granola meetings, notes, and transcripts",
   "keywords": [
     "cli",