# Minutes Setup

Guided first-time setup for Minutes, download whisper model, create directories...

- Repository: https://github.com/silverstein/minutes (1583 stars)
- Category: Media
- License: MIT
- Last updated: 2026-11-01
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add silverstein/minutes --skill minutes-setup -g -a claude-code -y`
Codex: `npx skills add silverstein/minutes --skill minutes-setup -g -a codex -y`
Cursor: `npx skills add silverstein/minutes --skill minutes-setup -g -a cursor -y`
Gemini CLI: `npx skills add silverstein/minutes --skill minutes-setup -g -a gemini-cli -y`
Claude Code plugin marketplace: `/plugin marketplace add silverstein/minutes`

## Description

Guided first-time setup for Minutes, download whisper model, create directories, configure audio input. Use when the user says "set up minutes", "install minutes", "first time setup", "configure minutes", "get started with minutes", "how do I start using minutes", or when verify shows missing components.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

## Skill Path

Before running helper scripts or opening bundled references, set:

```bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.agents/skills/minutes"
export MINUTES_SKILL_ROOT="$MINUTES_SKILLS_ROOT/minutes-setup"
```

# /minutes-setup

Walk the user through first-time Minutes setup, step by step.

## Setup steps

### 1. Check current state first

Run the verify skill's script to see what's already done:
```bash
bash "$MINUTES_SKILLS_ROOT/minutes-verify/scripts/verify-setup.sh"
```

Skip any steps that already pass.

### 2. Build the binary (if needed)

```bash
cd ~/Sites/minutes
export CXXFLAGS="-I$(xcrun --show-sdk-path)/usr/include/c++/v1"
cargo build --release
```

The binary lands at `target/release/minutes`. The user should add it to their PATH or create a symlink.

### 3. Download a whisper model

Ask the user which quality level they want using AskUserQuestion:

| Model | Size | Speed | Quality | Best for |
|-------|------|-------|---------|----------|
| `tiny` | 75 MB | ~10x real-time | Low | Quick tests, short memos |
| `small` | 466 MB | ~4x real-time | Good | Daily meetings (recommended) |
| `medium` | 1.5 GB | ~2x real-time | Great | Important meetings, accents |
| `large-v3` | 3.1 GB | ~1x real-time | Best | Legal, medical, foreign language |

Then run:
```bash
minutes setup --model <chosen-model>
```

### 4. Create directories

```bash
mkdir -p ~/meetings/memos
```

### 5. Audio input (if recording calls)

For in-person conversations, the built-in mic works fine. For Zoom/Meet/Teams:

1. Install BlackHole: `brew install blackhole-2ch`
2. Open Audio MIDI Setup (Spotlight → "Audio MIDI Setup")
3. Create a Multi-Output Device combining speakers + BlackHole
4. Set the Multi-Output Device as system output
5. Set BlackHole as Minutes' input (or system default input)

See `minutes-record/references/audio-devices.md` for the full guide.

### 6. Verify

The rest: https://github.com/silverstein/minutes/blob/HEAD/.agents/skills/minutes/minutes-setup/SKILL.md