minutes

环境要求

• macOS 并安装 Homebrew（用于 Cask 应用与 CLI）
• 或已安装 Rust/Cargo 工具链（用于 cargo install minutes-cli）
• 或已安装 Node.js（用于 npx minutes-mcp）
• 可选：Claude Code 等支持 MCP 的 AI 客户端

安装与启动步骤

1. 1安装桌面应用

   macOS 用户通过 Homebrew Cask 安装 minutes 桌面应用；若提示 tap 不受信任，先执行第 2 步的信任命令。

   brew install --cask silverstein/tap/minutes

   复制

2. 2信任 tap（按需）

   只有 Homebrew 报 untrusted tap 时才需要执行，只需运行一次，之后可重新安装。

   brew trust silverstein/tap

   复制

3. 3安装命令行工具

   通过 Homebrew 安装 minutes CLI，用于 minutes record / stop 录制与转录。

   brew install silverstein/tap/minutes

   复制

4. 4或用 Cargo 安装

   已配置 Rust 环境时，可用 cargo 安装 minutes-cli 作为替代方式。

   cargo install minutes-cli

   复制

5. 5启动 MCP 服务

   以 MCP 服务方式运行，供 AI 客户端检索你自己指定的本地会议记录。

   npx minutes-mcp

   复制

6. 6接入 Claude

   把 Minutes 注册为 Claude 的 MCP 服务，之后可直接在对话里查询本地会议。

   claude mcp add minutes -- npx -y minutes-mcp

   复制

7. 7生成示例数据

   写入五条示例会议，无需麦克风，便于先体验跨会议的语义检索效果。

   minutes demo --full

   复制

8. 8提问并录制

   向 Claude 提问“月度计费的决定是什么，后来变了吗”；正式使用时用 minutes record 录制、minutes stop 转录。

   minutes record
   minutes stop

   复制

如何确认成功

执行 minutes demo --full 后向 Claude 提问，或调用 search_meetings({"query":"monthly billing decision"})，能返回相隔一个月的两次会议结果即成功。

常见问题

注意事项

• 会议记录以 Markdown 文件形式保存在 ~/meetings/，数据由你自己掌控。
• MCP 直接调用示例：search_meetings({"query":"monthly billing decision"})。
• 转录在本地完成，支持 Whisper 和 Parakeet。
• 官方文档提到 Codex 等客户端的接入设置，可按需查阅项目仓库。