Foley
open source · local-first · MIT-friendly

Walkthroughs that
maintain themselves.

Foley turns your GitHub repo into a self-updating product walkthrough video. Every PR diffs against the live UI, retakes only what changed, and re-publishes the master. It runs on your machine — no SaaS, no upload, your keys.

View on GitHub Read the quickstart →
install in 60 seconds
# clone, install deps, copy .env.example, sanity-check ffmpeg/uv/pnpm
git clone https://github.com/lukataylo/Foley.git
cd Foley
pnpm bootstrap
pnpm dev   # http://localhost:3000

how it works

Four stages, one YAML.

01
CONNECT

Point Foley at your repo

Paste a GitHub URL and a dev URL. Claude reads the landing page and drafts 4–7 grounded steps.

02
CAPTURE

Drafted, then captured

Playwright captures each step. ElevenLabs narrates in your cloned voice. ffmpeg renders the master.

03
CUT

Edit takes in the studio

Trim, restage, and re-record any scene. Director takes notes — agents apply them.

04
MAINTAIN

Updates on every PR

Foley diffs your steps against the live UI, retakes only what changed, and re-publishes the master.

Why local-first?

Foley runs on your laptop. Your repo never leaves your machine. Your API keys never leave your .env. Walkthrough state lives in a plain folder you can git diff, tar, or roll back.

Stop maintaining docs by hand.

Clone the repo. Add your keys. Render your first walkthrough in under 2 minutes.

View on GitHub Quickstart for judges