minutes-search

minutes-search is a skill for Codex from silverstein/minutes. It costs 96 tokens per session (1,226 once invoked), scanned A, original, MIT.

A command-line search tool for finding topics, people, decisions, and ideas in saved meeting transcripts and voice memos. A voice memo is a recorded spoken note, while a meeting transcript is the written record of a meeting.

In plain words
What is it for?
Use it to search past conversations, limit results to meetings or memos, filter by date, and return matching snippets as JSON.
Why use it?
It removes the need to remember which recording contains a detail or manually read through many transcripts.

Skill for Codex

Written for Codex: agents/openai.yaml present. Also seen: installed under .agents/ (shared by several agents).

Good fit Use it to search past conversations, limit results to meetings or memos, filter by date, and return matching snippets as JSON.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/silverstein/minutes/minutes-search
About the project

Minutes is an open-source, local-first meeting recorder that transcribes meetings, calls, and voice memos on the device and stores the results as Markdown files. It is for people who want their meeting records available to Claude Code, Codex, Cursor, and other MCP clients without uploading them. The catalogue add-ons extend agent workflows for querying and using those local meeting files.

silverstein/minutes · 1,474 stars · on GitHub · useminutes.app

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add silverstein/minutes --skill minutes-search
Clone the repo
git clone --depth 1 https://github.com/silverstein/minutes

Made for: Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for minutes-search

README.md
[![agentmods](https://agentmods.dev/badge/skills/silverstein/minutes/minutes-search/github.svg)](https://agentmods.dev/skills/silverstein/minutes/minutes-search)
Your own site
<a href="https://agentmods.dev/skills/silverstein/minutes/minutes-search"><img src="https://agentmods.dev/badge/skills/silverstein/minutes/minutes-search/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for minutes-search

Your own site · 80×15
<a href="https://agentmods.dev/skills/silverstein/minutes/minutes-search"><img src="https://agentmods.dev/badge/skills/silverstein/minutes/minutes-search.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 96 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 1,226 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe. Third-party audits
  • NVIDIA SkillSpector pass 7 Sept 2026
How audits are shown
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00096 $0.01226
Opus 5 $0.00048 $0.00613
Sonnet 5 $0.00019 $0.00245
Haiku 4.5 $0.00010 $0.00123

Measured 12d ago against content hash 94f03264e1c4, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

minutes-search scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 12d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.agents/skills/minutes/minutes-search/SKILL.md · 89 lines

How it starts

The opening of the file, as written. The whole thing — 89 lines — stays where its author put it; the contents beside it link to each section on GitHub.

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 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:

[search]
engine = "qmd"
qmd_collection = "meetings"

Search coaching

When the user's search query is vague or too broad, push back before running it:

  • "who said X" or "what did Alex say" → If the meeting has speaker_map in frontmatter, use it to identify who said what. speaker_map maps SPEAKER_X labels to real names. High confidence = reliable, Medium = "likely" (suggest minutes confirm to lock it in).
  • "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?"

Read the full file on GitHub · 89 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 12d ago First seen · 89 lines · 96 tokens per session scan A 94f03264e1c4

Subscribe to this mod's changes

minutes-search is a skill published in the GitHub repository silverstein/minutes (1,474 stars, last pushed 2d ago), licensed MIT. It adds 96 tokens to every session and 1,226 once invoked, about $0.0005 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories