minutes

minutes

Open-source conversation memory.   useminutes.app

Agents have run logs. Humans have conversations. minutes captures the human side — the decisions, the intent, the context that agents need but can't observe — and makes it queryable.

Record a meeting. Capture a voice memo on a walk. Ask Claude "what did I promise Sarah?" — and get an answer. Your AI remembers every conversation you've had.

Minutes is not just a meeting-notes app. It is local conversation infrastructure for agents: audio capture, transcripts, decisions, commitments, people, and provenance exposed through plain files, CLI commands, MCP tools, and live transcript streams.

Own every conversation you've ever had. Cloud meeting tools rent your own conversations back to you. Minutes writes every meeting to ~/meetings/ as plain markdown, which every AI you use (Claude Code, Codex, Gemini CLI, Cursor, OpenCode, Pi) reads directly. No SDK. No API key. No vendor to outlive. Ten years from now, grep still works on your corpus.  For agents →  ·  Frontmatter schema →

Works with

Claude Code • Codex • OpenCode • Pi • Gemini CLI • Claude Desktop • Mistral Vibe • Obsidian • Logseq • Phone Voice Memos • Any MCP client

Quick start

# macOS — Desktop app (menu bar, recording UI, AI assistant)
brew install --cask silverstein/tap/minutes

# macOS — CLI only
brew tap silverstein/tap && brew install minutes

# Any platform — from source (requires Rust + cmake; Windows also needs LLVM)
cargo install minutes-cli                          # macOS/Linux
cargo install minutes-cli --no-default-features    # Windows (see install notes below)

# MCP server only — no Rust needed (Claude Code, Codex, OpenCode, Gemini CLI, Claude Desktop, etc.)
npx minutes-mcp

minutes setup --model small   # Download whisper model (466MB, recommended)
minutes record                # Start recording
minutes stop                  # Stop and transcribe

Docs and agent surfaces

The README is now the product overview and install guide, not the only home for agent-facing reference.

• Agent entry point: https://useminutes.app/for-agents
• MCP tools reference: https://useminutes.app/docs/mcp/tools
• MCP tools markdown mirror: https://useminutes.app/docs/mcp/tools.md
• Error reference: https://useminutes.app/docs/errors
• Concise agent index: https://useminutes.app/llms.txt
• Full agent index: https://useminutes.app/llms-full.txt

Choose your surface

• Desktop app — brew install --cask silverstein/tap/minutes Best for first recording, live capture, Recall, and post-meeting artifact work.
• MCP server — npx minutes-mcp Best for agent-first search, recall, and meeting-memory workflows in Claude Desktop, Codex, OpenCode, Gemini CLI, and other MCP clients.
• CLI — brew tap silverstein/tap && brew install minutes Best for terminal-first local operator workflows, import, search, and vault sync.
• Claude Code plugin — claude plugin marketplace add silverstein/minutes Best for workflow guidance, prep, debrief, and meeting coaching with the lifecycle skills and hooks.
• OpenCode project integration — built-in .opencode/skills/ + .opencode/commands/ Best for OpenCode users who want native /minutes-* commands plus the portable Minutes skill pack in the repo.

How it works

Audio → Transcribe → Diarize → Summarize → Structured Markdown → Relationship Graph
         (local)     (local)     (LLM)       (decisions,            (people, commitments,
        whisper.cpp  pyannote-rs Claude/       action items,          topics, scores)
        /parakeet    (native)    Ollama/       people, entities)      SQLite index
                                Mistral/OpenAI