minutes

silversteinMIT活跃维护

本地优先的会议与语音备忘录转写工具,在设备端把录音转成 Markdown,并支持 Claude Code、Cursor 等 MCP 客户端直接查询。

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.

v0.33.0发布于 2026-11-09 18:05 UTC1,596star +1 / 7 天183fork同步于 2026-11-10 17:49 UTC

怎么上手

由 README 提炼,执行前请确认
brew install --cask silverstein/tap/minutes
claude mcp add minutes -- npx -y minutes-mcp
硬件要求按 README 说明

README 未说明具体显存或 GPU 型号要求;转录与说话人处理在设备本地运行,桌面端以 macOS 菜单栏应用形式提供(含 macOS 专属功能如 Cursor 上下文与 Teams/Zoom 自动录制)。

下载:源码 zip·GitHub Releases(安装包)本站不镜像安装包

项目说明

由 README 自动翻译提炼

本地优先的会议转录与记忆工具,把录音转成本地 Markdown,供 Claude Code 等 MCP 客户端检索

本地优先的会议与语音备忘录转写工具,在设备端把录音转成 Markdown,并支持 Claude Code、Cursor 等 MCP 客户端直接查询。

核心能力

  • 在设备本地完成录音转录与说话人处理,音频不出本机
  • 会议存为带 YAML frontmatter 的 Markdown,可直接用 grep 或 Obsidian 打开
  • 提供 34 个工具的 MCP server,任意 MCP 客户端可查询本地会议
  • CLI 含 60 条命令,覆盖录制、处理、搜索、导入与自动化
  • Claude Code 插件含 23 个技能,支持会前准备到会后复盘

容易踩的坑

Homebrew 若报不受信任的 tap,需先执行一次 brew trust silverstein/tap;MCP server 需单独安装,桌面版自带的 CLI 要通过 About Minutes → Set up CLI 加入 PATH;使用云端 AI 助手或摘要器时,授权范围内的会议内容会发送给该服务商。

内容由模型根据 README 生成,可能不完整或不准确,以官方文档为准。看原文 README

最近发版

5 个版本v0.33.0
  1. v0.33.0v0.33.0: Minutes starts on Windows again, and Mac call transcripts are ready seconds after Stop最新正式版2026-11-09 · 2026-11-09 18:05 UTC

    Minutes 0.33.0 fixes the Windows desktop app, which exited at startup in 0.32.1. On the Mac, call recordings are now transcribed in chunks while the call is still going, so the transcript is ready seconds after you press Stop instead of minutes.

    What changed

    Windows: the desktop app starts again

    • Minutes Desktop 0.32.1 exited at startup on Windows with code 101 and never opened a window. The File menu's Add Note shortcut used a Mac-only modifier, and since a menu library update in 0.31.0, Windows rejects it while building the menu. The shortcut is now Ctrl+Shift+N on Windows and Linux (still Cmd+Shift+N on the Mac), and a new test fails the build if a menu that ships on Windows or Linux uses a Mac-only modifier again. Thanks to @alexengrig for the report and the exact diagnosis. #1322, #1328

    We're sorry about this one. If you're on Windows, please update.

    A much shorter wait after Stop on Mac calls

    • When the Mac app records a call (your microphone plus the call's system audio), Minutes now transcribes each finished stretch of about two minutes in the background during the call. At Stop, only the last stretch is left to transcribe.
    • The chunks are transcribed exactly the way the final pass would transcribe them: same model, same settings, same vocabulary hints, cut at the same pauses. A chunk is used only when its audio and settings match the final recording byte for byte. If anything changed (the title, your vocabulary, the matched calendar event, a setting), Minutes discards the chunk and transcribes that part again, so the transcript is the same as it would have been without this feature.
    • It backs off on its own: if your Mac can't keep up (chunks taking more than half as long as the audio itself across the call, or any single chunk taking longer than its audio), it stops early and the rest is transcribed after Stop as before. It never touches the recording itself.
    • It's on by default. To turn it off, use Transcribe during calls under Transcription in Settings. The change applies to the next recording.
    • Credit: this is largely the work of @askysh (Akash), who designed and wrote the transcript checkpoint engine, then found and fixed the two problems that made chunks drift from the final pass. On his replay of a real 80-minute call, the wait after Stop went from about 29 minutes to 9 seconds, with 0 of 9,508 words changed. Thank you, Akash. #1316, #1321, #1319

    Claude Desktop extension

    • process_audio works in Claude Desktop again. Claude Desktop doesn't let extensions run their bundled Node as a separate process, so the helper processes Minutes starts for audio processing, meeting reads and file reads failed right away, and process_audio returned a vague "failed safely" message. The extension now checks for this and runs those helpers under a system Node.js 20+ (found on your PATH or in Homebrew, nvm, fnm, Volta or asdf locations). If it can't find one, it says so plainly, and a missing Node no longer disables process_audio for the rest of the session. A new optional Node.js path setting in the extension's settings covers unusual installs. Thanks to @markusstraslicka-ux for the diagnosis. #1327, #1329

    Desktop

    • Cmd+B (Ctrl+B on Windows and Linux) toggles the meeting list again while a document is open. #1314

    Under the hood

    • Voice Live hands its local agent the recent conversation along with the question, so follow-ups like "use the revised proposal"
  2. v0.32.1v0.32.1: Recall shows what the agent sees, a one-row Mac window, and a window that keeps its size2026-11-05 · 2026-11-05 15:25 UTC
    查看更新说明

    Minutes 0.32.1 makes Recall show what the agent is working from, and lets Claude Code hear about a new meeting or document with your next question instead of a typed-in notice. The Mac window gets a single title row and panes you can resize, the window remembers its size, and the document viewer renders quotes and numbered lists properly.

    What changed

    Recall

    • See what the agent can read. A row under the Recall header names the selected meeting (or "All meetings") and the open document. The × on each removes it from the conversation; the document itself stays open. #1308
    • No more typed notices in Claude Code. Opening a meeting or document used to type a notice into the terminal and press Enter, which cost Claude a turn. Claude Code now gets the change as context with your next prompt, through a hook in a settings file Minutes manages. Your own .claude folder isn't touched. Other agents, Windows, and sessions started with your own --settings keep the typed notice for now. #1308
    • With the assistant set to a plain shell (zsh, bash, sh, fish), Minutes no longer types notices into it at all. #1301
    • In a shell, the first line no longer shows a stray inverted %, and the white bar along the terminal's right edge is gone. #1299

    The Mac window

    • One title row. The window controls, the Minutes name, the settings gear and the list toggle share one row, with the Recall and document headers in it too. Windows and Linux keep their header. #1298
    • Resizable panes. The meeting list, Recall and an open document each have a divider, and their widths are remembered. Double-click a divider to reset it. #1298
    • A quieter meeting list. Rows lose the colored dots, and memos and dictations say what they are ("11:40 AM · Dictation"). Two or more dictations on a day fold into one "N dictations" row. "Discuss with Agent" moved from the row's hover arrow to the right-click menu and the meeting page. #1298
    • The window keeps its size. Minutes saved the window size only on a kind of exit it no longer uses, so every launch restored an old size. It now saves after you resize or move the window, and on quit. #1299
    • The menu bar icon keeps its spot after an in-app update. Restarting into a new version now waits for the old one to exit and reopens the app the same way a normal launch does. The restart is run by the version you're updating from, so this takes effect from the update after 0.32.1. #1299
    • The new list labels are translated for Chinese (zh-CN) and Portuguese (pt-BR). #1307

    Documents

    • Quotes in a document render as quotes instead of lines starting with >, and numbered lists sit inside the text column. #1310

    The CLI notice in What's New

    • It appears only when the minutes you actually run is missing or out of date. Older copies further down your PATH no longer trigger it on every release; Settings lists them as ignored. Bundled CLI setup picks your installed Minutes.app, and opens above What's New instead of behind it. #1299

    Under the hood

    • The Archive crates move to zip 9.0.5, which fixes a critical parser advisory and three high-severity ones. #1306
    • rusqlite 0.41. #1309
    • Opt-in diagnostics for live transcription record which stretches of audio reached t
  3. v0.32.0v0.32.0: Both sides of FaceTime and iPhone calls, your day in the menu bar, readable Settings2026-11-03 · 2026-11-03 20:09 UTC
    查看更新说明

    Minutes 0.32.0 records both sides of FaceTime and iPhone calls on your Mac, warns you during a call if the other side isn't being captured, and puts the rest of your day in the menu bar. Settings got a full readability pass and you can now set your own accent color. Dictation lands in Codex, both the desktop app and the CLI in a terminal like Herdr, and can run a command of yours after every dictation. This release also includes five fixes from designer @heyjawrsh. Thank you, Joshua.

    What changed

    Calls: both sides, and a warning when one is missing

    • FaceTime and iPhone calls answered on the Mac now record the other person. ScreenCaptureKit only hears app audio, and those calls are played by system services it can't hear, so the remote side came out silent. Minutes now reads call audio with a Core Audio tap and keeps ScreenCaptureKit as a fallback. It switches between the two if one stalls or goes quiet. #1268
    • A live warning when the other side of a call isn't being captured. If you've been talking for a while and Minutes hears nothing from the call, you find out during the call, not after processing. Short sounds like notifications don't count as the other side, and a quiet listener during a presentation doesn't trigger it. #1267
    • Stopping a recording never sends a kill signal anymore. A stop from one copy of Minutes could end another copy's in-progress recording. #1272
    • The call-audio helper no longer shows a second, bouncing Minutes icon in the Dock. #1265

    Your day in the menu bar

    • The menu bar calendar now shows the rest of today and tomorrow, grouped into Now, the next meeting ("Starts in 6m"), Today and Tomorrow, up to 10 events. Events no longer appear twice when a calendar account reaches the Mac twice, and a meeting stays listed while it's in progress. #1270
    • Clicking an event starts a recording named after it. An event with a meeting link records both sides of the call.

    Settings you can read, in your colors

    • Readable text everywhere. Helper text, section headers and tab labels in Settings were as low as 1.8:1 contrast. They now meet WCAG AA (4.5:1 or better) in light and dark. The light-mode accent is a little darker so button labels are readable too. #1292
    • Theme and accent color. Settings › General › Appearance sets light, dark or follow the system, plus an accent color for each, with a color picker. You can also edit ~/.config/minutes/customize.toml directly. Hex and oklch() both work, and an accent too faint to read against the background is refused with the reason. #1287
    • Settings titles use the interface font, and the Settings window keeps one width on every tab. #1292, #1294
    • The Whisper model picker stays visible when Parakeet v3 is your engine, since Whisper is the fallback. The Dictation microphone pane shows the microphone dictation will actually use. #1292

    Dictation

    • Dictation lands in Codex. Text dictated into the Codex desktop app, or into a terminal running in Herdr, used to end up only on the clipboard. It now pastes into the prompt, the same way it already did for Ghostty and Terminal. #1294
    • Run a command after every dictation. Settings › Dictation › After each dictation takes a shell command, which receives the dictation as JSON on stdin. Send it to Claude, Codex or a webhook; recipes are in [the post-dictation hook guide](https://github.c
  4. v0.31.1v0.31.1: Faster Windows transcription and a clean restart after updates2026-10-27 · 2026-10-27 18:44 UTC
    查看更新说明

    Minutes 0.31.1 makes Whisper transcription on Windows about ten times faster, fixes the crash after an in-app update on Mac, and fixes model downloads that failed behind antivirus or corporate HTTPS inspection.

    Fixes

    • Whisper transcription on Windows is about ten times faster, in both the desktop app and the CLI. whisper.cpp was being compiled without optimization in our Windows builds. On a 64-second test clip on GitHub's Windows machines, the small model now takes 24 seconds instead of about 300, the same as the official whisper.cpp build. #1260, reported in #1256
    • Minutes no longer shows "Minutes quit unexpectedly" and stays closed after an in-app update. The restart now runs its cleanup on the main thread. Because the restart runs in the version being replaced, updating from 0.31.0 to 0.31.1 shows the dialog one last time; reopen Minutes and later updates restart cleanly. #1259
    • Model downloads now trust your operating system's certificate store. Antivirus suites and corporate networks that inspect HTTPS add their own certificate there, and downloads failed with "invalid peer certificate: UnknownIssuer". Pinned downloads such as Parakeet v3 and the search-by-meaning model are still verified against their known checksums. #1258, reported in #1256

    Known issues

    • Updating from 0.31.0 to 0.31.1 shows "Minutes quit unexpectedly" one last time, because the restart runs in the version being replaced. Reopen Minutes; later updates restart cleanly.
    • Windows desktop remains experimental and unsigned.

    Install or update

    After updating the desktop app, reopen Recall so its terminal uses the matching bundled CLI.

    • macOS desktop: download the DMG below, or run brew update followed by brew upgrade --cask silverstein/tap/minutes.
    • Command line: cargo install minutes-cli --version 0.31.1, or brew upgrade silverstein/tap/minutes for an existing Homebrew install.
    • MCP server: npx [email protected] with the updated local Minutes engine, or install the desktop extension below.

    Minutes remains free and open source. Meeting capture and transcription run locally. Optional cloud AI and connected assistants receive the content you authorize under their settings; file sync and backups you configure are separate.

  5. v0.31.0v0.31.0: One-click Parakeet v3 and search by meaning2026-10-27 · 2026-10-27 12:58 UTC
    查看更新说明

    Minutes 0.31.0 makes Parakeet v3 easy to switch to and adds search by meaning. If you still transcribe with Whisper on an Apple Silicon Mac, Minutes now offers Parakeet v3 with one click, and dictation uses it automatically once it is installed. Search by meaning, off by default, finds meetings from how you remember them rather than the exact words said. Search is also about twice as fast, and live transcript no longer drops audio when transcription falls behind.

    What changed

    Switch to Parakeet v3 in one click

    Parakeet v3 is NVIDIA's speech model, built into Minutes for Apple Silicon. Until now it could only be installed from the command line, so most desktop users stayed on Whisper.

    • After this update, Minutes shows a banner once if you can run Parakeet v3 but don't have it yet: Install downloads it (639 MB, one time), and Not now hides it until the next version. Settings › Transcription keeps an install button. #1248
    • New users on Apple Silicon are offered Parakeet v3 during first-run setup. Minutes also installs Whisper Base, which standalone live transcript uses and which is the fallback for meetings. If the Parakeet download fails, setup still finishes on Whisper Base. #1252
    • The download is pinned to one model revision and every file is checked against its known SHA-256 before use.
    • Installing switches a saved Whisper engine to Auto, which uses Parakeet v3 for meetings and falls back to Whisper if Parakeet fails on a recording.
    • Dictation now writes its final text with Parakeet v3 when it is installed and your language fits. On 39 real dictation clips, Parakeet v3 differed from a Whisper medium reference on 2.1% of words, against 6.9% for Whisper small, the default, and decoded a typical clip in about 50 ms. #1231, #1237
    • Parakeet v3 covers 25 European languages. If you set a language it does not cover (Chinese, Japanese, Hindi, Arabic and others), or use the Chinese interface with automatic language detection, Minutes keeps Whisper and the banner does not appear.
    • Words you list as misspellings in your vocabulary are now corrected in new transcripts from any engine, for example "Sok 2" to "SOC 2". Each correction is recorded in the meeting's spelling_corrections field. #1245

    Search by meaning (Mac, opt-in)

    Turn it on in Settings › AI & Privacy › Search by meaning. Searches of two or more words then add a Related by meaning section: meetings about what you typed that the word search missed. On a test library of 1,119 meetings, searches phrased the way people remember a meeting found the right one in the top three 11 times out of 12, against 6 for word search alone. #1243

    • It runs on your Mac with Google's EmbeddingGemma 2 model (about 300 MB, pinned and checksum-verified). Nothing is sent anywhere.
    • The first indexing pass takes a while on a large library (17.5 minutes for 1,119 meetings on an M4 Max); after that, new and edited meetings are picked up in the background. The index is small (about 14 MB for 1,100 meetings) and readable only by you.
    • Restricted meetings are never indexed, and a meeting marked restricted later is removed at the next sync. Turning the setting off deletes the index.
    • From the command line: minutes semantic setup, sync, search, status and clear.

    Faster, more forgiving search

    • Searches run about twice as fast on a large library, and results are verified in parallel. #1218, #1233
    • The desktop app no longer starts a full search on every keystroke. It waits briefly, runs one search at a time and shows matching titles i

用户点评

登录用户的真实使用记录,可按版本和硬件筛选
共 0 条

    还没有人点评。第一个说出真实体验的人最有价值。

    README 原文

    未翻译

    minutes

    GitHub stars License: MIT crates.io npm

    useminutes.app

    Minutes is a free, open-source conversation memory app for the AI you already use. Record and transcribe meetings, calls, voice memos, and dictation on your device, then let Claude Code, Codex, Cursor, or another MCP client search the history you choose to share. Your records are Markdown files you own in ~/meetings/.

    Capture, transcription, and storage run locally. If you choose a cloud AI assistant or summarizer, the meeting context you authorize is sent to that provider.

    Your conversations. Your memory. Ready for the AI you use.

    Install

    Choose the desktop app or one standalone CLI installation. The desktop app includes a CLI: use About Minutes → Set up CLI to add it to your PATH.

    brew install --cask silverstein/tap/minutes  # Desktop app, with bundled CLI
    brew install silverstein/tap/minutes         # Standalone CLI alternative
    cargo install minutes-cli                   # Standalone CLI via Cargo
    

    For an agent connection, add the MCP server separately with claude mcp add minutes -- npx -y minutes-mcp (or run npx minutes-mcp from another MCP client).

    If Homebrew reports an untrusted tap, run brew trust silverstein/tap once.

    Ask your agent

    Add Minutes to your agent, seed five sample meetings (no mic needed), then ask about them:

    claude mcp add minutes -- npx -y minutes-mcp
    minutes demo --full
    

    What did we decide about monthly billing, and did it stick?

    The answer spans two meetings a month apart: launched on Feb 28, reversed on Mar 25.

    A direct MCP call uses the same local meeting files:

    search_meetings({"query":"monthly billing decision"})
    

    Record a real one with minutes record, then minutes stop to transcribe. minutes demo --clean removes the samples. Setup: Codex, Gemini CLI, and Claude Desktop, Cursor, OpenCode, Pi, Mistral Vibe, and Cowork or Dispatch.

    Works with

    Claude Code · Codex · Cursor · OpenCode · Pi · Gemini CLI · Claude Desktop · Mistral Vibe · Cowork · Dispatch · Obsidian · Logseq · any MCP client

    How it compares

    WorkflowGranolaOtter.aiAnarlog (formerly Hyprnote)Minutes
    ProductHosted meeting notepadHosted meeting assistantLocal meeting notepadLocal conversation memory
    Agent accessHosted MCPHosted integrationsCLI + MCPLocal files, MCP, CLI, SDK
    Primary storageHosted workspaceHosted workspaceLocal SQLite + filesLocal Markdown + YAML
    Local AICloud transcriptionCloud transcriptionWith local providersLocal transcription; AI provider of your choice

    Reviewed September 5, 2026 against Granola MCP, Otter privacy and security, and the Anarlog repository. Anarlog's community app is MIT; its enterprise components use a commercial license. See the detailed comparison and open-source alternatives for fit and limitations.

    Who it's for

    Agent-first users treat Minutes as the capture layer of a local second brain. They search meetings through Claude Code, Cursor, Codex, OpenCode, MCP, or the CLI, then fold useful context into a vault or wiki they own.

    Desktop notetaker users record and read results in the app. They value reliable setup, clear processing and recovery, Recall, documents, Coach, and summary quality. See the full persona notes.

    Surfaces

    SurfaceWhat it providesDocs
    Desktop appMenu bar capture, dictation, Recall, documents, and Coach.Install
    CLI (60 commands)Local recording, processing, search, import, and automation.Commands
    MCP server (34 tools)Local meeting tools and resources for any MCP client.MCP reference
    Claude Code plugin (23 skills)Prep, capture, live help, debrief, and memory workflows.Client setup
    SDKTypeScript access to meeting files without MCP.Agent architecture

    Dictation

    The desktop Dictation settings bring writing preferences, personal spellings and snippets, microphone selection, and recent text together. Cursor context is optional and stays on the Mac. Recovery restores text for review; local edits use an explicit Ollama preview, and spelling corrections require confirmation.

    See dictation behavior and evaluation boundaries for supported fields, safe insertion and undo, clipboard restoration, and the synthetic benchmark.

    Output format

    Meetings are plain markdown with structured YAML frontmatter:

    ---
    title: Q2 Pricing Discussion with Alex
    type: meeting
    date: 2026-03-17T14:00:00
    duration: 42m
    context: Discuss Q2 pricing
    action_items:
      - assignee: mat
        task: Send pricing doc
        due: Friday
        status: open
    decisions:
      - text: Test monthly billing with 10 advisors
    ---
    

    See the frontmatter schema. Files work with Obsidian, grep, and any markdown tool.

    Privacy & consent

    • Transcription and speaker processing run on-device. Audio stays on your machine.
    • Sensitive meetings save typed markers without audio and default to restricted.
    • Consent reminders, acknowledgement, and provenance help you disclose recording.
    • Text leaves the machine only when you send authorized context to a cloud agent or summarizer.

    See the security documentation and consent enforcement design.

    Docs

    Contributing

    See CONTRIBUTING.md. Minutes is MIT licensed and staying that way: no relicensing, no paid tier for anything in this repo.

    MIT. Built by Mat Silverstein, founder of X1 Wealth.

    Star History

    Star History Chart