Cache Notes

Cache Notes

Usage

• /cache-notes all — Scan all meetings with Notes: links that haven't been cached yet, fetch and embed them.
• /cache-notes <path> — Cache notes for a specific meeting file.
• /cache-notes refresh <path> — Re-fetch and overwrite existing cached content for a file.

If the target file has an empty Notes: property (no URLs yet), run /mail-transcripts first when doing a full wrap (see meeting Mode C) — it may populate Notes: from the Gemini inbox mail. If still empty, prompt the user to paste the external resource URLs (Google Docs, Otter.ai, etc.). Add them to the Notes: frontmatter, then proceed with fetching and caching as normal.

How It Works

Supported external transcript providers are Google Docs (Gemini notes) and Otter.ai. When a URL from either provider appears in frontmatter Notes:, the agent fetches the transcript using that provider's instructions and embeds it as collapsible Obsidian callouts in the meeting note. A NotesCached: frontmatter timestamp marks the file as cached.

Frontmatter Convention

Before caching:

Notes:
  - https://docs.google.com/document/d/{id}/edit?tab=t.{tab}
  - https://otter.ai/u/{id}

After caching:

Notes:
  - https://docs.google.com/document/d/{id}/edit?tab=t.{tab}
  - https://otter.ai/u/{id}
NotesCached: 2026-02-25T15:00:00+00:00

Provider: Gemini (Google Docs)

Fetching

1. Extract document ID from the Google Docs URL in Notes:.
2. Run gws in the terminal to fetch the document (read-only). See google-workspace-cli for exact commands.
3. Prefer gws docs documents get with includeTabsContent: true and parse the JSON into text (optionally inserting --- TAB: … --- separators from tab titles), or gws drive files export with mimeType: text/plain for a simpler single stream. Parsed content should mirror the old tab layout where needed: --- TAB: Notes ---, --- TAB: Transcript ---.

Parsing the Notes Tab

Gemini notes have a consistent structure. Parse into three sections:

Strip the Gemini disclaimer footer — lines starting with "You should review Gemini's" or "Please provide feedback" are noise. Do not include them.

Output Format

All cached content goes under a top-level ## 🤖 AI Notes section appended after frontmatter. Each provider gets its own ### {Provider} subsection. Callouts are nested under the provider heading.

## 🤖 AI Notes

### Gemini

> [!gemini_notes]- Summary & Details
> ### Summary
> {summary text}
>
> ### Details
> {details as bullet points}

> [!gemini_todos]- Suggested Next Steps
> - {next step 1}
> - {next step 2}

> [!gemini_transcript]- Transcript
> {transcript content, if available}

### Otter

> [!otter_notes]- Summary & Details
> ...

Formatting rules for callout content:

• Every line inside a callout must start with > .
• Preserve markdown formatting (bold, bullet points, headings) inside callouts.
• Keep the - after the callout type (e.g. [!gemini_notes]-) — this makes it collapsed by default in Obsidian.
• Blank lines between callouts (no > prefix) to separate them.
• If transcript tab is not available, omit the [!gemini_transcript] callout entirely.
• The ## 🤖 AI Notes heading is created once. Provider subsections are added beneath it.
• If the file already has user-written content between frontmatter --- and ## 🤖 AI Notes, preserve it. Always append ## 🤖 AI Notes at the end of the file.

Provider: Otter.ai

Otter.ai is a supported external transcript provider (same as Google Docs). Whenever an Otter.ai URL is present in Notes:, follow this provider's instructions to fetch the transcript and embed it. The cached output uses the same structure as other providers: a subsection under ## 🤖 AI Notes with collapsible callouts. Expected callout types:

• [!otter_notes]- — Summary and details
• [!otter_todos]- — Suggested next steps / key topics
• [!otter_transcript]- — Full transcript (if available)

Implementation: Use the otter-fetch skill — ask the user to paste the JSON from GET .../speech?otid=..., then run parse_otter.js (or parse inline) to produce the callouts above and append them.

Workflow

Mode: Specific file (/cache-notes <path>)

1. Read frontmatter only. Check Notes: and NotesCached: via obsidian property:read (see frontmatter-mutations). To check whether the body already has an ## 🤖 AI Notes section without reading the whole file, run obsidian outline path="<file>" format=json and look for that heading — much cheaper than a full Read on large transcript files.
2. If Notes: is empty or absent, prompt the user to paste the external resource URL(s). Set them via obsidian property:set name=Notes value='["<url1>","<url2>"]' type=list path="<file>", then continue.
3. If NotesCached: exists and this is not a refresh, inform the user and stop.
4. Verify each URL before caching (see URL Verification below).
5. For each URL in Notes:, fetch and parse by provider:
   • Google Docs: Extract document ID, fetch via gws (see google-workspace-cli), parse into sections per Provider: Gemini.
   • Otter.ai: Use otter-fetch (user pastes JSON from GET .../speech?otid=...; run otter-fetch/parse_otter.js or parse inline), then append the resulting callout block.
6. Build the callout blocks from all fetched content.
7. If the file already has callout blocks (refresh mode), replace them. Otherwise append under ## 🤖 AI Notes after frontmatter --- (see Output Format).
8. Set NotesCached: timestamp: obsidian property:set name=NotesCached value="$(date +%FT%T%z)" type=datetime path="<file>". See frontmatter-mutations.