minutes

# minutes

[![GitHub stars](https://img.shields.io/github/stars/silverstein/minutes?style=social)](https://github.com/silverstein/minutes)
[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)

**Open-source conversation memory.**   [useminutes.app](https://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 →**](https://useminutes.app/for-agents)  ·  [**Frontmatter schema →**](docs/frontmatter-schema.md)

<p align="center">
  <img src="docs/assets/demo.gif" alt="minutes demo — record, dictate, phone sync, AI recall" width="750">
</p>

### Works with

<p align="center">
  <a href="#claude-code-plugin">Claude Code</a> &bull;
  <a href="#any-mcp-client-claude-code-codex-gemini-cli-claude-desktop-or-your-own-agent">Codex</a> &bull;
  <a href="#opencode-cli">OpenCode</a> &bull;
  <a href="#pi-coding-agent">Pi</a> &bull;
  <a href="#any-mcp-client-claude-code-codex-gemini-cli-claude-desktop-or-your-own-agent">Gemini CLI</a> &bull;
  <a href="#any-mcp-client-claude-code-codex-gemini-cli-claude-desktop-or-your-own-agent">Claude Desktop</a> &bull;
  <a href="#mistral-vibe">Mistral Vibe</a> &bull;
  <a href="#vault-sync-obsidian--logseq">Obsidian</a> &bull;
  <a href="#vault-sync-obsidian--logseq">Logseq</a> &bull;
  <a href="#phone--desktop-voice-memo-pipeline">Phone Voice Memos</a> &bull;
  Any MCP client
</p>

## Quick start

```bash
# 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
```

```bash
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
```

Everything runs locally. Your audio never leaves your machine (unless you opt into cloud LLM summarization). Speakers are identified via native diarization. Th

... (truncated)