| Zotero MCP returns no results | Zotero is not open | Start Zotero and check http://localhost:23119/ |
| Local API not available | Setting not checked | Zotero → Settings → Advanced → enable local API |
zotero-mcp not found | uv path not in shell | Add ~/.local/bin to $PATH in ~/.zshrc |
| Semantic search returns no results | Database not initialized | Run zotero-mcp update-db |
| Claude Code does not see the MCP tool | Configuration file missing | Check ~/.claude/claude_desktop_config.json |
| Ollama not responding | Service not started | Run ollama serve or brew services start ollama |
| yt-dlp returns no subtitles | Video has no (auto-)subtitles | Try --sub-lang en or check whether the video has subtitles at all |
| launchd update not running | Zotero is not open at the scheduled time | Start Zotero manually and run update-zotero, or choose "Auto on startup" in step 10c option 1 |
| whisper-cpp gives an error | Model not yet downloaded | Wait for the first download, or check disk space |
| Whisper transcription is inaccurate | Low audio quality or incorrect language detection | Use --model medium for better quality, or specify the language explicitly with --language nl or --language en if automatic detection picks the wrong language |
| NetNewsWire not syncing | No sync configured (local always works) | NetNewsWire works locally by default; iCloud sync is optional |
| Obsidian flashcards not appearing | Plugin not enabled | Settings → Community Plugins → enable Spaced Repetition |
| Flashcards not recognized | Incorrect format | Check that ? is on its own line and #flashcard is present |