podcast-wiki

mcp
Guvenlik Denetimi
Basarisiz
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 7 GitHub stars
Code Basarisiz
  • rm -rf — Recursive force deletion command in .github/workflows/site.yml
  • network request — Outbound network request in tools/fetch_transcript.py
Permissions Gecti
  • Permissions — No dangerous permissions requested

Bu listing icin henuz AI raporu yok.

SUMMARY

Claude Code plugin that turns the podcasts you listen to on Spotify into a cited LLM wiki: one page per topic, every claim linked to its episode.

README.md

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

Podcast Wiki launch film, 62s

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
  1. List: an MCP server reads the episodes I've played from the shows I follow.
  2. 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.
  3. 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.
  4. 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

wiki/index.md Every page, grouped by domain. Start here.
wiki/concepts/ One topic each (e.g. harness engineering, LLM evals, index investing).
wiki/hubs/ Domain overviews: AI engineering, investing, knowledge management.
wiki/takeaways/to-try.md Actionable checklist, grouped by hub.
wiki/takeaways/recommendations.md Books, tools and people worth following.
wiki/episodes/, wiki/people/, wiki/shows/ Short source notes that the concepts link back to.

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.

  1. Create an app at the Spotify developer dashboard with redirect URI http://127.0.0.1:8888/callback.
  2. cp .env.example .env and set SPOTIFY_CLIENT_ID. No client secret is needed because the login uses PKCE.
  3. uv run tools/spotify_mcp.py --auth to log in to Spotify once.
  4. Update the absolute paths in .mcp.json to your checkout.
  5. 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.

Yorumlar (0)

Sonuc bulunamadi