silverstein/minutes

Open-source, local-first Granola/Otter alternative that Claude Code, Codex, Cursor, and any MCP client can query. Meetings, calls, and voice memos transcribed on-device into markdown you own.

minutes – 面向 AI 代理的本地对话记忆

简介 – minutes 是一款开源桌面应用（附带 CLI 和 MCP 兼容服务器），可将会议、通话、语音备忘录和听写内容录制、转写并存储为你自己机器上的纯文本 Markdown 文件。文件保存在 ~/meetings/ 中，包含一个小的 YAML front-matter 块，用于捕获元数据（标题、日期、参与者、决策、行动项等）。由于数据不会离开你的计算机，除非你明确将其发送到云端 LLM，因此它充当了一个私密的“第二大脑”，任何支持 AI 的工具都可以查询。

为什么对 AI/LLM 用户很重要 – 现代 LLM 代理（Claude Code、Codex、Cursor、OpenCode、Gemini‑CLI、Pi、Mistral Vibe 等）在拥有正确上下文的情况下擅长回答问题。minutes 按需提供该上下文：一个名为 search_meetings 的 MCP 工具可让代理从你的会议笔记中检索相关摘录，结果可以反馈到代理的提示词或知识库（Obsidian、Logseq 等）中。这使得 AI 代理优先的工作流在不依赖存储对话的托管服务的情况下成为可能。

工作原理

捕获 – 使用菜单栏桌面界面或 CLI（minutes record）开始麦克风录制。停止时（minutes stop），音频会在本地转写（设备端 Whisper 风格模型）并保存为 Markdown 文件。
存储 – 文件是带有 YAML front-matter 模式（标题、类型、日期、时长、决策、行动项等）的纯 Markdown。可以使用任何理解 Markdown 的工具进行编辑、版本控制或搜索。
查询 – 捆绑的 MCP 服务器公开了 34 个工具；最常用的是 search_meetings({"query":"…"})。任何 MCP 兼容客户端（Claude Code、Cursor 等）都可以调用它来获取相关的会议摘录。
集成 – 为 Claude Code、Cursor、OpenCode、Pi、Gemini‑CLI、Mistral Vibe、Cowork、Dispatch 和通用 MCP 客户端提供了现成的插件。SDK 还允许 TypeScript 代码直接读取会议文件。
隐私 – 转写和说话人分离在本地运行；音频永远不会离开设备，除非你故意将片段发送到云端摘要器。敏感会议可以标记为“受限”以省略音频并强制执行同意提醒。

安装选项

方法	获得内容	命令
桌面应用（附带 CLI）	GUI + 菜单栏捕获，以及 PATH 中的 `minutes` 命令	`brew install --cask silverstein/tap/minutes`
独立 CLI	仅命令行工具（无 GUI）	`brew install silverstein/tap/minutes` 或 `cargo install minutes-cli`
MCP 客户端	为任何 MCP 兼容代理添加 `minutes-mcp` 工具	`npx -y minutes-mcp`（或 `claude mcp add minutes -- npx -y minutes-mcp`）

典型工作流程

录制会议：minutes record → 说话 → minutes stop。
应用创建带有结构化 front-matter 的 ~/meetings/2026-04-12‑team‑sync.md。
在 LLM 代理中调用 search_meetings({"query":"pricing decision"})。
代理返回相关摘录，你可以将其粘贴到提示词中或让代理自动丰富知识库。

谁应该使用

代理优先的开发者：希望为其自定义 LLM 代理提供本地可搜索的对话上下文存储。
高级用户：喜欢提供 AI 就绪转写和决策跟踪的桌面笔记应用。
注重隐私的专业人士：需要本地存储会议笔记并仅与云服务共享选择性摘录。

主要差异化

功能	minutes	Granola	Otter.ai	Anarlog
存储	本地 Markdown + YAML（用户所有）	托管工作区	托管工作区	本地 SQLite + 文件
AI 集成	基于 MCP，适用于任何 LLM 客户端	仅托管 MCP	托管集成	CLI + MCP
转写	设备端（无云）	云端	云端	可选本地提供商
可扩展性	CLI（58 个命令）、SDK、MCP 工具、插件	仅限于托管平台	有限

文档与社区 – 仓库附带了广泛的文档，涵盖安装、命令参考、每个支持的 LLM 客户端的集成指南、安全与同意设计、front-matter 架构以及从竞争工具的迁移。公共网站（useminutes.app）提供比较图表、人物角色笔记以及支持 LLM 的可搜索列表。

许可证 – MIT，并明确声明该项目将保持免费和开源。

底线 – minutes 为您提供了一个自托管、隐私优先的“记忆层”，可将日常对话转换为结构化、可搜索的 Markdown 文件，并通过简单的 MCP API 将它们暴露给任何 LLM 代理。对于任何构建或使用需要从过去会议中获取可靠、按需上下文的 AI 助手的人来说，它都是一个实用的构建模块。