pr-video

Generate demo videos for GitHub Pull Requests. Combines AI-powered PR analysis with screen recordings to create shareable videos showcasing your changes.

Quick Start

export ANTHROPIC_API_KEY=sk-ant-...

# Frontend PR with preview
npx pr-video demo https://github.com/org/repo/pull/123 https://preview.vercel.app

# Backend PR (no preview - shows code diff)
npx pr-video demo https://github.com/org/repo/pull/123

Examples

Single page demo:

npx pr-video demo https://github.com/org/repo/pull/123 \
  https://myapp.vercel.app/new-feature \
  -o demo.mp4

Multi-page tour (great for docs PRs):

npx pr-video demo https://github.com/org/repo/pull/123 \
  https://docs.site.com/feature/overview \
  https://docs.site.com/feature/page1 \
  https://docs.site.com/feature/page2 \
  --duration 25 \
  -o feature-tour.mp4

Backend-only (shows animated code diff):

npx pr-video demo https://github.com/org/repo/pull/123 -o backend.mp4

Options

| Flag | Description | Default | |------|-------------|---------| | -o, --output | Output video path | ./pr-demo.mp4 | | --duration | Recording duration in seconds | 15 | | --github-token | GitHub token (for private repos) | - | | --anthropic-key | Anthropic API key | - |

Other Commands

# Analyze PR without generating video
npx pr-video analyze https://github.com/org/repo/pull/123

# Record a URL only (no PR analysis)
npx pr-video record https://mysite.com -o recording.webm --duration 10

Video Structure

1. Intro - PR title + repo name
2. Files - Animated file tree of changes
3. Demo/Diff - Screen recording (frontend) or code diff (backend)
4. Stats - Lines added/removed
5. Outro - PR number + author

Setup

Required:

export ANTHROPIC_API_KEY=sk-ant-...

For private repos:

export GITHUB_TOKEN=ghp_...

First run installs Playwright automatically. Or install manually:

npx playwright install chromium

Requirements

• Node.js 18+
• Anthropic API key (for PR analysis)
• GitHub token (optional, for private repos)