# Minutes Search

Search past meeting transcripts and voice memos for specific topics, people, decisions...

- Repository: https://github.com/silverstein/minutes (1583 stars)
- Category: Writing
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add silverstein/minutes --skill minutes-search -g -a claude-code -y`
Codex: `npx skills add silverstein/minutes --skill minutes-search -g -a codex -y`
Cursor: `npx skills add silverstein/minutes --skill minutes-search -g -a cursor -y`
Gemini CLI: `npx skills add silverstein/minutes --skill minutes-search -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add silverstein/minutes`

## Description

Search past meeting transcripts and voice memos for specific topics, people, decisions, or ideas. Use this whenever the user asks "what did we discuss about X", "find that meeting where we talked about Y", "what did Alex say", "did we decide on", "what was that idea about", or any question that could be answered by searching their meeting history. Also use for "do I have any notes about" or "check my meetings for".

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# /minutes-search

Find information across all meeting transcripts and voice memos.

## Usage

```bash
# 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 title
- `date`, When it was recorded
- `content_type`, "meeting" or "memo"
- `snippet`, The line containing the match
- `path`, Full path to the markdown file

Human-readable output goes to stderr. A result path is only a hint. To read the
full transcript, run `minutes get "<exact path>" --json`, require exit status 0,
and use only that response. Never pass the path to `cat` or the host `Read` tool.

## 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 `~/meetings/` (including the `memos/` subfolder).

For richer semantic search, users can configure QMD as the search engine in `~/.config/minutes/config.toml`:
```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:

The rest: https://github.com/silverstein/minutes/blob/HEAD/.agents/skills/minutes/minutes-search/SKILL.md