stagewright

Record narrated product walkthroughs from YAML, on your machine or in any CI. The same file is the video and an end-to-end check: when a PR breaks the flow, the run fails with the video and the screen it failed on.

npx stagewright init          # .walkthroughs/example.yaml and stagewright.config.ts
npx stagewright doctor        # checks Chromium and ffmpeg; --install adds Chromium
npx stagewright record .walkthroughs/example.yaml

No account needed. The video lands in .stagewright/out/<id>/final.mp4, with captions, chapters, a poster and a Playwright trace.

# .walkthroughs/invite.yaml
id: invite-a-teammate
title: Invite a teammate
steps:
  - id: open
    narration: Team settings list everyone in your workspace.
    actions:
      - goto: /settings/team
    expect:
      - visible: 'role=heading[name="Team"]'
  - id: invite
    narration: Type their email and send the invite.
    actions:
      - fill: { target: 'role=textbox[name="Email"]', value: [email protected] }
      - click: 'role=button[name="Invite"]'
    expect:
      - visible: text=Invite sent

Your app

• baseUrl in stagewright.config.ts points at it: localhost, a dev instance or a preview deploy.
• stagewright auth saves a signed-in session (sign in by hand once; SSO and MFA work).
• The Stagewright plugin gives Claude Code and Codex skills, commands and the MCP server: /plugin marketplace add stagewright-ai/plugins, then /plugin install stagewright@stagewright (Codex: codex plugin marketplace add stagewright-ai/plugins). For other agents, stagewright skills add and stagewright mcp (claude mcp add stagewright -- npx stagewright mcp).
• stagewright import playwright tests/x.spec.ts converts an existing test.

With Stagewright

stagewright login, then stagewright run reports runs (visual diffs against the approved baseline, approvals, publishing to your help center), and stagewright ci does the same in GitHub Actions, GitLab or Buildkite with a PR comment and check.

Needs Node.js 22.18 or newer and ffmpeg. stagewright help lists every command; questions to [email protected].