Search, Meetings, and Folders

This part of the toolkit is about one thing: helping you find the right meeting quickly, whether you think in terms of search, folder context, or one specific meeting id.

Folder Views

folder makes folders a first-class concept in Gran.

The current surface includes:

• gran folder list
• gran folder view <id|name>
• gran meeting list --folder <id|name>
• gran export --folder <id|name>

If you still want a narrower one-off export, gran notes --folder ... and gran transcripts --folder ... remain available, but the bundled export command should be the default path.

Examples:

gran folder list
gran folder view Team
gran meeting list --folder Team

Meeting Views

meeting combines API-backed notes with locally available transcript data, and falls back to on-demand transcript loading when the desktop transcript file does not already have what you need, so you can inspect one meeting at a time.

Once you have run gran sync, the toolkit also keeps a local full-text search dataset for titles, notes, transcripts, folders, tags, and generated artefacts.

Examples:

gran search planning decision
gran meeting list --limit 10
gran meeting list --search planning
gran meeting view 1234abcd
gran meeting notes 1234abcd
gran meeting transcript 1234abcd --format json
gran meeting export 1234abcd --format yaml
gran meeting open 1234abcd

Browser and TUI Navigation

Folders also drive interactive navigation:

• the browser workspace has a dedicated folder pane plus an All meetings scope
• the browser search box uses the shared local search dataset when it is available
• the TUI keeps folders inside the navigation flow instead of treating them as an afterthought
• TUI quick open falls back to the local search dataset when a title or id lookup is not enough
• generated notes/enrichment artefacts feed back into the same search index, so one query can find a meeting by its transcript, its original notes, or the AI output you approved later
• URL state and attach flows preserve folder and meeting selection

Why This Matters

Most real users do not want one undifferentiated list of every meeting they have ever recorded. Treating folders as first-class keeps exports, scripts, and interactive browsing aligned with how Granola is actually organised, while search and direct meeting views give you faster escape hatches when you already know roughly what you need.