Where files live on disk

Everything Gistlist produces is a plain file. You picked the data folder during the Setup Wizard — by default, ~/Documents/Gistlist. If you use Obsidian, that data folder can live inside your vault.

App state — config, logs, the meeting-index database — lives separately under ~/.gistlist/.

The map

What	Where
Meetings	<data_path>/Runs/YYYY/MM/DD/<meeting>/
Dashboard	<data_path>/Dashboard.md
Notes template	<data_path>/Templates/notes-template.md
Prompt Library	~/.gistlist/prompts/
App config	~/.gistlist/config.yaml
App log	~/.gistlist/app.log
Parakeet venv	~/.gistlist/parakeet-venv/
API keys	macOS Keychain, service gistlist
Meeting index (FTS + vectors)	~/.gistlist/meetings.db

A typical completed meeting

<data_path>/Runs/2026/04/25/<meeting-slug>/
├── index.md          # run manifest and meeting metadata
├── notes.md          # main editable note (consolidated output)
├── prep.md           # pre-meeting prep notes (only if you used Workspace)
├── transcript.md     # full speaker-attributed transcript
├── summary.md        # default summary prompt output
├── <prompt>.md       # other prompt outputs, named by each prompt's filename
├── run.log           # processing log for this meeting
├── audio/
│   ├── mic.{wav,ogg,flac}      # source channels; format follows storage mode
│   ├── system.{wav,ogg,flac}   # absent for mic-only recordings
│   └── combined.{wav,ogg}      # playback file used for click-to-seek
└── attachments/      # files attached during prep or notes (only when present)

After the audio retention policy deletes audio, the audio/ directory is gone but notes.md, prep.md, and transcript.md stay.

The Meeting Details tabs

When you open a meeting, the header can switch between Workspace and Details.

Workspace is for editing prep notes and live notes side by side. It is the default view for drafts and active recordings, and it is where you prepare for a later meeting.

Details has six tabs. Summary is the default landing tab so you see the summary first; Metadata is last for when you want to inspect the run.

• Summary — the default summary prompt’s output.
• Analysis — your other prompts, plus the five extra templates that ship pre-installed (coaching, customer-call recap, decision log, next-steps email, one-on-one follow-up). Click any of them to run on demand.
• Transcript — full speaker-attributed text with click-to-seek audio playback.
• Recording — the audio file directly.
• Files — anything you attached during prep.
• Metadata — title, date, participants, tags, and run details.

The meeting header also exposes Continue recording, Reprocess, Launch chat, Edit as draft, and Open folder when those actions apply.

Below the title, the header shows the meeting’s scheduled date and time. Click it to open a calendar + time picker and edit the value — this works for every meeting status, so you can fix the date on an imported recording or reschedule a draft from the same control. If no date is set yet, the same control appears as a “Schedule” call-to-action.

The notes are plain markdown. Edit them in Gistlist, in Obsidian, or in any text editor — Gistlist re-reads on focus so external edits show up.