---
name: Minutes Setup
slug: minutes-setup
category: Automation
description: Minutes Setup walks through first-time installation of Minutes, including downloading a whisper model, creating directories, and configuring audio input for recording meetings. Use it when the user asks to set up, install, or get started with Minutes.
github: "https://github.com/silverstein/minutes/tree/main/.opencode/skills/minutes-setup"
language: Rust
stars: 1439
forks: 154
install: "npx degit https://github.com/silverstein/minutes/tree/main/.opencode/skills/minutes-setup ~/.claude/skills/minutes-setup"
installs_to: ~/.claude/skills/minutes-setup
source_path: .opencode/skills/minutes-setup/SKILL.md
collection_size: 23
category_size: 1523
collection_url: "https://dirskills.com/collections/silverstein/minutes"
added: 2026-08-19T07:27:27.063Z
last_synced: 2026-08-19T07:27:27.063Z
canonical_url: "https://dirskills.com/skills/minutes-setup"
---

# Minutes Setup

Minutes Setup walks through first-time installation of Minutes, including downloading a whisper model, creating directories, and configuring audio input for recording meetings. Use it when the user asks to set up, install, or get started with Minutes.

**Install:**

```bash
npx degit https://github.com/silverstein/minutes/tree/main/.opencode/skills/minutes-setup ~/.claude/skills/minutes-setup
```

## README

## Skill Path

Before running helper scripts or opening bundled references, set:

```bash
export MINUTES_SKILLS_ROOT="$(git rev-parse --show-toplevel)/.opencode/skills"
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

Run verify again to confirm everything passes:
```bash
bash "$MINUTES_SKILLS_ROOT/minutes-verify/scripts/verify-setup.sh"
```

### 7. Test recording

```bash
minutes record --title "Test recording"
# Speak for 10-15 seconds
minutes stop
```

Check the output file exists in `~/meetings/` and has a transcript.

## Gotchas

- **macOS 26 (Tahoe) requires CXXFLAGS** — The whisper.cpp build needs the C++ include path set explicitly. This is a known Apple SDK issue.
- **First model download can be slow** — The `small` model is 466 MB. On slow connections, `tiny` is a good starting point (75 MB).
- **BlackHole setup is the hardest part** — Most users struggle with the Audio MIDI Setup step. Offer to walk through it if they get stuck.