Podcast Wiki
A Claude Code plugin that turns the podcasts you finish on Spotify into a wiki you can learn from: one page per topic, synthesized across every episode that touched it, every claim linked to its episode, disagreements between guests kept side by side.
You stop remembering an episode and start knowing a topic. A Karpathy-style LLM wiki, written and maintained by Claude Code.
Browse the live wiki → · Try the demo · How it works
Click for the full 62s video.
Install
In Claude Code:
/plugin marketplace add HagaiHen/podcast-wiki
/plugin install podcast-wiki@podcast-wiki
- Try it first: run
/podcast-wiki:demo in an empty folder. In about a minute it builds a small wiki from 3 sample episodes, with no Spotify needed.
- Your own podcasts: run
/podcast-wiki:setup in an empty folder. It copies the tools, creates wiki/, and walks you through the Spotify login. After that, /podcast-wiki:ingest-podcasts builds your wiki.
Requires macOS on Apple Silicon (for local Whisper), uv, ffmpeg, a Spotify account and Claude Code. The demo needs only Claude Code.
How it works
Spotify (episodes I've heard)
│ tools/spotify_mcp.py
▼
raw/<show>/<date>-<slug>.md ← transcript: published → Whisper → episode description
│ tools/fetch_transcript.py
▼
Claude Code follows the procedure in CLAUDE.md
▼
wiki/ concepts · hubs · episodes · people · shows · takeaways
- List: an MCP server reads the episodes I've played from the shows I follow.
- Fetch: for each new episode, use the published transcript if there is one. Otherwise transcribe the audio locally with mlx-whisper. The Spotify description is the last fallback.
- Synthesize: Claude extends existing concept pages rather than creating near-duplicates. It rewrites each summary to integrate the new episode, links every claim to its episode and speaker, and records conflicting claims under Disagreements.
- Act: actionable items go to a checklist grouped by domain, and recommended books, tools and people go to a recommendations list.
Hebrew episodes are translated to English during synthesis.
What's inside
The wiki is plain Markdown with Obsidian wikilinks ([[concepts/zone-2-training]]), so it opens as an Obsidian vault with a working graph view.
Note: raw/ (the full transcripts) is kept local and is not in this repo. Those transcripts are the podcasters' content; the wiki is a synthesis in my own words, linking back to each episode on Spotify.
Run it yourself
Requires macOS on Apple Silicon (for mlx-whisper), uv, ffmpeg, and Claude Code.
- Create an app at the Spotify developer dashboard with redirect URI
http://127.0.0.1:8888/callback.
cp .env.example .env and set SPOTIFY_CLIENT_ID. No client secret is needed because the login uses PKCE.uv run tools/spotify_mcp.py --auth to log in to Spotify once.- Update the absolute paths in
.mcp.json to your checkout.
- In Claude Code, run
/ingest-podcasts.
| Command | What it does |
|---|
/ingest-podcasts | Full pipeline: list heard episodes → fetch text → update the wiki → commit → push. |
/lint-wiki | Health check: broken links, orphans, drift between pages; fixes what it finds. |
/dream | Consolidates Claude's project memory and merges duplicate concept pages. |
uv run tools/fetch_transcript.py --pending | Raw files not yet in the wiki. |
uv run tools/lint_wiki.py | Mechanical wiki checks only. |
Unattended: tools/scheduled_ingest.sh runs the pipeline headless. tools/com.user.podcast-wiki.plist is a launchd job that runs it every 6 hours; fix its paths, copy it to ~/Library/LaunchAgents/, and launchctl load it. Because the headless Claude reads untrusted transcripts, it may only write inside wiki/ and runs no git itself. The script commits and pushes afterwards.
CLAUDE.md holds the conventions, page templates and the step-by-step wiki update procedure Claude follows.
