| Recording stops in seconds: “no system audio” | Screen Recording permission missing — enable MeetGist under System Settings → Privacy & Security → Screen Recording, relaunch MeetGist, retry. |
| ”Mic looks silent” notification | Microphone not granted or muted — only a warning; system audio still records. Normal for listen-only calls. |
system.m4a / mic.m4a is ~1 KB | Permission issue — see Permissions. |
| Notes don’t generate / “add an API key” | Add a key in Settings → AI Provider — see API key. |
| MeetGist isn’t in Privacy → Microphone, or it asks every launch | You’re running an ad-hoc / Xcode build. Build with make install-app and launch from /Applications (it gets a stable signature). |
| No app icon, or it looks like a “new” app each launch | Same cause — run the make install-app build from /Applications, not from Xcode. |
| Voice Memos watcher finds 0 memos (advanced) | Grant Full Disk Access to the launchd agent’s Python interpreter — see Importing. |
