minutes-record

1# /minutes-record
2 
3Record audio from the microphone, transcribe it locally with whisper.cpp, and save as searchable markdown.
4 
5## How it works
6 
7Recording is a two-step process — start and stop. Between those two commands, audio is captured continuously from the default input device.
8 
9**Start recording:**
10```bash
11minutes record
12# Or with a title:
13minutes record --title "Weekly standup with Alex"
14```
15 
16The process runs in the foreground. It captures audio from whatever input device is active — the built-in MacBook mic for in-person conversations, or a BlackHole virtual audio device for system audio (Zoom, Meet, Teams calls).
17 
18**Stop recording:**
19```bash
20minutes stop
21```
22This sends a signal to the recording process, which then:
231. Stops audio capture
242. Transcribes the audio locally via whisper.cpp (no cloud, no data leaves the machine)
253. Saves the transcript as a markdown file in `~/meetings/`
264. Prints the output path and word count as JSON
27 
28**Live transcript during recording:**
29 
30While recording, Minutes streams a real-time transcript to `~/.minutes/live-transcript.jsonl`. You can read it with:
31```bash
32minutes transcript                    # all lines
33minutes transcript --since 42         # lines after cursor
34minutes transcript --since 5m         # last 5 minutes
35minutes transcript --status           # check if active
36```
37…