Call Copilot

One thing. Done really well. Record meetings. Save transcripts. Don't break audio.

Call Copilot is a terminal command (rec) that records your meeting audio and, when you stop it, transcribes locally and saves a clean markdown transcript. Everything runs on your machine — no cloud, no API keys, no account. Audio and transcripts never leave the computer.

$ rec setup         # one-time: verify macOS + grant capture permission
$ rec start         # starts recording, you keep working
$ rec stop          # stops, transcribes, saves markdown
$ rec list          # shows past recordings

How it captures audio (no BlackHole, no Multi-Output Device)

By default, rec captures both the microphone (your voice) AND system audio (other participants / anything apps play) — so a real meeting where you speak gets recorded, not just the audio coming out of your speakers. Both sources are tapped directly via Apple's Core Audio taps API (macOS 14.2+) using the audiotap library. There is:

• no virtual audio driver to install (no BlackHole),
• no Multi-Output Device to create in Audio MIDI Setup,
• no system output device to switch and restore,
• and therefore no silent-recording failure that the old driver-based approaches produce when routing breaks.

The mic and system streams are recorded as two separate WAVs (each at its own true rate), transcribed separately, and merged into one transcript with [Mic] / [System] labels so you can tell who said what. Want just one source? rec start --mic-only or --system-only.

Grant capture permission (one-time, per terminal app)

macOS ties capture permission to the app you run rec from (Terminal, iTerm, Warp, VS Code, …). You need two grants:

1. Microphone (your voice): System Settings → Privacy & Security → Microphone → enable your terminal app.
2. System audio (grouped under Screen Recording on macOS 14.2+): System Settings → Privacy & Security → Screen Recording → enable your terminal app, then quit and reopen it (required for the change to take effect).

Until mic is granted, rec start records system audio only and skips the mic (it tells you so). rec setup checks the current mic-permission status.

After rec stop (or Ctrl+C from rec start), the recording(s) are transcribed locally with faster-whisper (CPU, int8 — no API, no data leaves your machine) and written to a markdown transcript.

recording.wav ──> faster-whisper (local, free) ──> transcript.md

Requirements

• macOS 14.2 or later (Sonoma — the Core Audio process taps API rec records through landed in 14.2). Apple Silicon recommended. Intel works.
• Python 3.11+ only needed for the pipx install; the Homebrew formula brings its own.

No virtual audio driver (no BlackHole), no Multi-Output Device, no manual Audio MIDI Setup. The tap reads system output directly. rec checks the macOS version itself and refuses to run below 14.2 with a one-line message — you don't have to guess.

Install

Homebrew (recommended — no Python to manage):

brew install AnisurRahmann/tap/call-copilot

pipx (if you prefer a plain Python install, no Homebrew):

pipx install call-copilot

Either way you get a rec command on your PATH. Then jump to One-time setup.

Using rec on a machine below macOS 14.2 prints Error: rec requires macOS 14.2 or later ... and exits — no traceback, no mystery. See docs/HOMEBREW.md if you're setting up the tap yourself.

Recording consent & privacy

Call Copilot records audio from your meetings, which may include other participants. Recording laws vary by jurisdiction and many require the consent of everyone being recorded (one-party vs. all-party consent). Obtaining that consent is your responsibility — check your local laws and your organization's policy before recording.

On the technical side, your data stays put:

• Transcription runs 100% locally with faster-whisper (CPU, int8) — no API, no cloud.
• Audio and transcripts never leave your machine. The only network access is the first run of a given Whisper model, which downloads its weights from Hugging Face; after that it's fully offline.
• Recordings live under ~/.local/share/rec/sessions/ (XDG data home), outside any repo.

One-time setup

rec setup

Verifies your macOS version, that the audiotap library + its bundled dylib load, saves your config, and tells you about the one-time capture permission prompt.

Recording a meeting

rec start                          # mic + system (default); Ctrl+C to stop & transcribe
rec start --system-only            # just what apps play (not your voice)
rec start --mic-only               # just your voice (not system audio)
rec list                           # browse past sessions
rec transcribe 2026-07-27_14-30-00 --model medium    # re-transcribe at higher quality
rec diagnose 2026-07-27_14-30-00                      # bundle debug info for an AI agent

By default rec start records both your microphone and system audio; the transcript labels each line [Mic] or [System]. Use --system-only / --mic-only to narrow.

rec start shows a live indicator while recording:

● REC  2026-07-28_14-30-00
elapsed 03:47   size 18.2 MB
press Ctrl+C to stop & transcribe

Press Ctrl+C when your meeting ends — it stops the recording and transcribes in the same command, then prints the transcript path. One command, start to finish.

Want the old background behavior instead? rec start --detach spawns the recorder and exits immediately; stop it later from another terminal with rec stop (or check progress with rec status).

Tip: if a transcript comes back empty, the recording was silent — nothing was playing, or the capture permission was revoked. rec start (and rec stop) warn you about this immediately, and rec diagnose <session> bundles the audio levels + logs.

Use your meetings from Claude Code

rec ships an MCP server (the open protocol Claude Code, Cursor, Zed, Cline, and other AI tools speak). Point any MCP client at your locally-recorded transcripts and ask questions about them — answers come back with the session id cited, so you can check the exact moment. Nothing leaves your machine: the server is strictly read-only and makes no network calls.

rec mcp install     # writes the server entry into Claude Code's config

Then restart Claude Code and ask, for example:

• "What did the client actually ask for on Tuesday's call?" — it searches the transcripts, finds the line, and cites the session id (e.g. 2026-07-28_12-25-20) with a timestamp.
• "List my meetings from last week with their durations." — it lists sessions, narrowing by date.
• "Show me the full transcript of the standup where we discussed the API migration." — it finds the session, then reads the whole transcript.

Three tools are exposed: list_sessions (find a meeting by date), get_session (read a whole transcript), and search_transcripts (find specific lines across long transcripts — pass it keywords like pricing discount, not a full sentence). The search index lives at ~/.local/share/rec/index.db; it builds lazily on first search and is a disposable cache — rec index refreshes it, rec index --rebuild recreates it from scratch.

Other MCP clients (Cursor, Zed, Cline, …)

rec mcp install prints a config block that works in any MCP client. For Cursor, paste it into .cursor/mcp.json; for Zed, into settings.json under mcp_servers. It looks like:

{
  "call-copilot": {
    "type": "stdio",
    "command": "rec",
    "args": ["mcp"]
  }
}

You can also run the server directly with rec mcp (stdio transport) if a client prefers a raw command.

Official MCP Registry

Call Copilot is listed on the official MCP Registry under io.github.AnisurRahmann/call-copilot. Any MCP client that speaks the registry can discover and add it from there. The registry entry runs the server with:

uvx --from call-copilot rec mcp

(The PyPI package is call-copilot; the command it installs is rec, so the server is launched as rec mcp.)

Browser UI

rec web opens a local browser tab — a read-mostly viewer for sessions you've already recorded, plus Start/Stop controls. It's modelled on the qBittorrent / Transmission web UI: a loopback HTTP server serves a single-page app that drives the same session store the CLI uses. The terminal can't show a live capture meter, a seekable audio player beside its transcript, or a session list you can skim in one glance — the browser can, so the UI exists for exactly those three things.

rec setup            # one-time, in a terminal (the UI can't grant capture permission)
rec web              # opens a browser tab at http://127.0.0.1:7717