meetings-search
Find information across all meeting transcripts and voice memos.
Usage
# Basic search
minutes search "pricing strategy"
# Filter to just voice memos
minutes search "onboarding idea" -t memo
# Filter to just meetings
minutes search "sprint planning" -t meeting
# Date filter + limit
minutes search "API redesign" --since 2026-03-01 --limit 5
Flags
| Flag |
Description |
-t, --content-type <meeting|memo> |
Filter by type |
--since <date> |
Only results after this date (ISO format, e.g., 2026-03-01) |
-l, --limit <n> |
Maximum results (default: 10) |
Output
Returns JSON to stdout with an array of matches. Each result includes:
title — Meeting or memo titledate — When it was recordedcontent_type — "meeting" or "memo"snippet — The line containing the matchpath — Full path to the markdown file
Human-readable output goes to stderr. To read the full transcript of a match, use cat <path> on any result's path.
How search works
Search is case-insensitive and matches against both the transcript body and the YAML frontmatter title. It walks all .md files in ~/vault/meetings/ (including the memos/ subfolder).
For richer semantic search, users can configure QMD as the search engine in ~/.config/minutes/config.toml:
[search]
engine = "qmd"
qmd_collection = "meetings"
Search coaching
When the user's search query is vague or too broad, push back before running it:
- "everything" or "all meetings" → "That'll return hundreds of results. What specifically are you looking for? A person, a topic, or a decision?"
- Single common word like "meeting" or "project" → "That's too broad. Can you narrow it — a person's name, a specific topic, or a date range?"
- "that meeting" or "the one where" → "Help me narrow it down. Do you remember who was in the meeting, roughly when it was, or a specific thing that was said?"
Suggest search strategies based on what the user is looking for:
- Finding a person's input → Search their name:
minutes search "Alex"
- Finding a decision → Search decision keywords:
minutes search "decided" or minutes search "agreed"
- Finding an idea → Search voice memos:
minutes search "idea" -t memo
- Finding something from a time range → Use
--since: minutes search "pricing" --since 2026-03-01
Tips for good searches
- Search for what people said, not document titles:
"we should postpone the launch" not "launch delay meeting"
- Search for names to find everything someone discussed:
"Alex" or "Case"
- Search for decisions:
"decided", "agreed", "committed to"
- Combine with
Read to load the full context after finding a match
Gotchas
- Search is substring, not fuzzy —
"price" matches "pricing" and "price", but "prcing" (typo) matches nothing. Try multiple terms if you're not sure of the exact wording.
--since requires ISO date format — Use 2026-03-01, not "last week" or "March 1st". For relative dates, compute the ISO date first: date -v-7d +%Y-%m-%d.- Large result sets flood stdout — Always use
--limit when searching broad terms. The default limit is 10, but common words can match hundreds of files.
- QMD semantic search requires separate setup — If
config.toml sets engine = "qmd" but the QMD collection isn't indexed, search will fail silently. Run qmd update && qmd embed first.
- Voice memos vs meetings — Both are searched by default. Use
-t memo or -t meeting to narrow results. Voice memos live in ~/vault/meetings/memos/, meetings in ~/vault/meetings/.
- Empty results don't mean it wasn't discussed — If the meeting wasn't transcribed (e.g., recording was stopped before processing), it won't appear in search. Check
minutes list to see what's been processed.
1---2name: meetings-search3description: Search meeting transcripts and voice memos for people, topics, decisions, commitments, or remembered ideas. Use when the user asks what was discussed, decided, or said across their meeting history. Not for preparing an upcoming meeting; use $meetings-prep.4---56# meetings-search78Find information across all meeting transcripts and voice memos.910## Usage1112```bash13# Basic search14minutes search "pricing strategy"1516# Filter to just voice memos17minutes search "onboarding idea" -t memo1819# Filter to just meetings20minutes search "sprint planning" -t meeting2122# Date filter + limit23minutes search "API redesign" --since 2026-03-01 --limit 524```2526## Flags2728| Flag | Description |29|------|-------------|30| `-t, --content-type <meeting\|memo>` | Filter by type |31| `--since <date>` | Only results after this date (ISO format, e.g., `2026-03-01`) |32| `-l, --limit <n>` | Maximum results (default: 10) |3334## Output3536Returns JSON to stdout with an array of matches. Each result includes:37- `title` — Meeting or memo title38- `date` — When it was recorded39- `content_type` — "meeting" or "memo"40- `snippet` — The line containing the match41- `path` — Full path to the markdown file4243Human-readable output goes to stderr. To read the full transcript of a match, use `cat <path>` on any result's path.4445## How search works4647Search is case-insensitive and matches against both the transcript body and the YAML frontmatter title. It walks all `.md` files in `~/vault/meetings/` (including the `memos/` subfolder).4849For richer semantic search, users can configure QMD as the search engine in `~/.config/minutes/config.toml`:50```toml51[search]52engine = "qmd"53qmd_collection = "meetings"54```5556## Search coaching5758When the user's search query is vague or too broad, push back before running it:5960- **"everything"** or **"all meetings"** → "That'll return hundreds of results. What specifically are you looking for? A person, a topic, or a decision?"61- **Single common word** like "meeting" or "project" → "That's too broad. Can you narrow it — a person's name, a specific topic, or a date range?"62- **"that meeting"** or **"the one where"** → "Help me narrow it down. Do you remember who was in the meeting, roughly when it was, or a specific thing that was said?"6364Suggest search strategies based on what the user is looking for:65- **Finding a person's input** → Search their name: `minutes search "Alex"`66- **Finding a decision** → Search decision keywords: `minutes search "decided"` or `minutes search "agreed"`67- **Finding an idea** → Search voice memos: `minutes search "idea" -t memo`68- **Finding something from a time range** → Use `--since`: `minutes search "pricing" --since 2026-03-01`6970## Tips for good searches7172- Search for **what people said**, not document titles: `"we should postpone the launch"` not `"launch delay meeting"`73- Search for **names** to find everything someone discussed: `"Alex"` or `"Case"`74- Search for **decisions**: `"decided"`, `"agreed"`, `"committed to"`75- Combine with `Read` to load the full context after finding a match7677## Gotchas7879- **Search is substring, not fuzzy** — `"price"` matches `"pricing"` and `"price"`, but `"prcing"` (typo) matches nothing. Try multiple terms if you're not sure of the exact wording.80- **`--since` requires ISO date format** — Use `2026-03-01`, not `"last week"` or `"March 1st"`. For relative dates, compute the ISO date first: `date -v-7d +%Y-%m-%d`.81- **Large result sets flood stdout** — Always use `--limit` when searching broad terms. The default limit is 10, but common words can match hundreds of files.82- **QMD semantic search requires separate setup** — If `config.toml` sets `engine = "qmd"` but the QMD collection isn't indexed, search will fail silently. Run `qmd update && qmd embed` first.83- **Voice memos vs meetings** — Both are searched by default. Use `-t memo` or `-t meeting` to narrow results. Voice memos live in `~/vault/meetings/memos/`, meetings in `~/vault/meetings/`.84- **Empty results don't mean it wasn't discussed** — If the meeting wasn't transcribed (e.g., recording was stopped before processing), it won't appear in search. Check `minutes list` to see what's been processed.
flonat