# aidemo

Turns a one-line request into a narrated, captioned MP4: the agent writes storyboard.json, the engine drives Chrome, voices the scenes and cuts the result.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 18
- Author: tandryukha
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tandryukha/aidemo
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/aidemo

## What it does

The server hands your agent a tool for filming product demos. You describe the flow in a sentence, and the agent writes `storyboard.json`: scenes, narration text, plus a fixed list of browser actions. The engine then opens a real Chrome window, types at a human pace and zooms into elements when the storyboard asks.

Rendering runs in stages. Voice first, from OpenAI, ElevenLabs or a local model. Then the browser replay, then word-level Whisper captions, then a compose pass that trims idle time, syncs audio to picture and writes `output/final-demo.mp4`. The same take also gives you a GIF and named stills for the README. Replays are deterministic, so when the UI shifts you re-run the committed storyboard; nobody re-records by hand.

An API key is needed for cloud voices only. Set `AIDEMO_TTS_PROVIDER=local` and everything renders offline, with nothing uploaded. Recording uses your own Chrome, which is why `localhost` and apps behind a login work fine. In CI one step, `uses: tandryukha/aidemo@stable`, replays the storyboard and commits fresh media.

## Requirements
- Needs: Node.js (commands run via npx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add aidemo -- npx -y @tandryukha/aidemo
```

### Codex

**Platform CLI**
```bash
codex mcp add aidemo -- npx -y @tandryukha/aidemo
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "aidemo": {
            "command": "npx",
            "args": [
                "-y",
                "@tandryukha/aidemo"
            ]
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "aidemo": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@tandryukha/aidemo"
            ]
        }
    }
}
```

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add aidemo npx -y @tandryukha/aidemo
```

## When to use it
- capture a 45-second checkout walkthrough without screen-studio editing
- refresh a demo after a redesign using the same committed storyboard
- add narration and synced captions to a screen recording
- export a README GIF and stills from one take
- keep demo media current from a CI job

## Example prompts
- Film a 45-second walkthrough of checkout — login, cart, payment — and voice it in English.
- Write a `storyboard.json` for the onboarding tour, then render it locally without an API key.
- Re-render `output/final-demo.mp4` from the existing storyboard and pull stills for the README.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md