Skip to content

v1.0.0 — Meetey

Choose a tag to compare

View all tags
@jej2k5 jej2k5 released this 31 Jul 22:26
· 53 commits to main since this release
v1.0.0
db50b66

Meetey captures meeting audio on your Mac, transcribes it locally, and turns it into structured notes — entirely inside Claude Code. No cloud service, no subscription, no audio leaving your machine.

Install

npx jej2k5/meetey install

Then open System Settings → Privacy & Security → Screen Recording, enable your terminal app, and start a new Claude Code session.

Usage

Command Hotkey What it does
/meetey start Ctrl+Shift+R Detects the running meeting app and starts recording
/meetey stop Ctrl+Shift+S Stops, transcribes, and writes notes
/meetey status — Reports whether a recording is active

/meetey stop produces a summary, key decisions, and action items alongside the full transcript, saved as a .md file next to the WAV in ~/.meetey/recordings/.

What's in this release

  • Swift capture binary using ScreenCaptureKit — records app audio as 16-bit PCM WAV at 16 kHz mono, stops on SIGTERM/SIGINT or an optional --stop-after timer.
  • MCP server exposing five tools: list_apps, start_recording, stop_recording, transcribe, get_status. Registered globally in ~/.claude.json, so it's available in every Claude Code session.
  • /meetey skill with start, stop, and status subcommands.
  • meetey CLI with install, update, and status commands. status reports exactly which pieces are wired up and what to run to fix the ones that aren't.
  • Local transcription via whisper.cpp, defaulting to ggml-base.en.bin (~142 MB). Swap in small.en or large-v3-turbo-q5_0 for better accuracy by setting MEETEY_MODEL.

Supported meeting apps

App Bundle ID
Chrome (Google Meet / Teams web) com.google.Chrome
Zoom us.zoom.xos
Microsoft Teams (desktop) com.microsoft.teams

Requirements

  • macOS 13 (Ventura) or later
  • Node.js 18+
  • Xcode Command Line Tools (xcode-select --install)
  • Claude Code
  • Homebrew (installed automatically if missing)

Known limitations

  • Chrome capture is process-wide. ScreenCaptureKit captures at the process level, not the tab level, so targeting Chrome records all Chrome audio. Mute other tabs before recording.
  • No speaker diarization. The transcript is a single stream of text with no per-speaker attribution.
  • English-only by default. The bundled model is base.en, and transcription is invoked with -l en.
  • Screen Recording permission is required and must be granted to your terminal app, not to Meetey itself.

Source-only release

No prebuilt binary is attached. The Swift capture binary is compiled and ad-hoc code-signed on your machine at install time, which is what lets it hold the ScreenCaptureKit entitlement without notarization.

Licensed under the Apache License 2.0.

Assets 2
Loading