Automating a podcast from GitHub commits

Here’s an LLM-generated podcast of what I coded last week. NotebookLM-inspired.

The process proved straightforward.

These now appear on my GitHub repo as a weekly summary.

Beyond technical novelty, it reshaped how I think about documentation.

  1. I write for two audiences: informing my future self what changed and explaining why to an LLM that will narrate it. That’s an interesting behavioral change.
  2. Technical debt is audible. When hearing my week’s work, architectural issues and potential next steps become clear. It creates an accountability mechanism that code reviews often miss.
  3. Ambient documentation. I stop documenting when coding fast. Converting signals (commits) to consumable content creates “ambient documentation” that accumulates with no extra effort. Audio reduces the energy needed to stay up to date.

This could change how we share technical work. Maybe financial analysts “narrate” spreadsheet changes, designers “explain” Figma iterations, or operators “log” settings adjustments - all automated from version control metadata.

Converting activity traces into narratives dramatically lowers cost of knowledge & sharing.

What activity traces do we generate? It’s worth exploring what they could become, and how it’d change behavior if we knew those signals would become stories.