ByteZone
Back to listClaim this project

puppeteerDeveloper tools

replay

A Node.js library and CLI tool to replay, customize, and stringify Chrome DevTools Recorder user flows.

  • CLI
  • Library/framework
  • Linux
  • macOS
  • Windows
  • Runs locally
Open websiteView on GitHub
replay screenshot
Popularity
1.4k Stars
GitHub stars
Recent activity
9/20/2026
Updated in the last 30 days
License
APACHE-2.0
Permissive

Why it matters

We look beyond stars: what problem it solves, whether it creates real utility, and what makes its approach worth noticing.

Last 90 days

Problem

Addresses the problem of replaying and transforming browser user flow recordings into executable code and automated tests.

Practical value

Provides a Node.js library and CLI to execute Chrome DevTools recordings directly and convert them into various test framework scripts.

Innovation / differentiation

Allows developers to customize step execution logic and code stringification formats through an extension mechanism.

Leverage potential

Serves as a foundation for extending Chrome recording capabilities across major test frameworks like Cypress, Nightwatch, and WebdriverIO.

Why now

Ecosystem toolchains for browser recorders are maturing alongside the adoption of built-in developer tools.

Community activity

In the last 90 days there were 8 new issues and 19 pull requests; the bounded issue/PR samples include 7 issue authors and 6 PR contributors, with at least 0 releases.

Maintainer responsiveness

The 8-issue window sample had a 100% close rate, and the 17-pull-request sample had a 47% merge rate. Maintainer-comment observations covered only 100% of that issue sample, so response rate and first-response speed are not reported.

6 contributors in PR sampleAt least 0 releasesPR merge rate 47% · 17 sampled in window

Key highlights

  • Replay DevTools user flow JSON files or entire folders via CLI and JavaScript API
  • Customize execution hooks and logging by extending PuppeteerRunnerExtension
  • Transform user flows into Puppeteer or third-party test scripts via PuppeteerStringifyExtension

Quick start

How it is installed, how hard it is, and where to start.

Where it runs

Runs locally

Difficulty

Easy — follow the steps

Runs locally
  1. 01Install the replay library and Puppeteer in your project: npm install @puppeteer/replay puppeteer --save
  2. 02Record and export a user flow JSON file (e.g., recording.json) from the Chrome DevTools Recorder panel.
  3. 03Replay the recording via CLI: npx @puppeteer/replay recording.json
  4. 04Load and execute recordings programmatically in Node.js using createRunner and parse.

Best for

  • Developers who want to try it on their machine

More about it

@puppeteer/replay is a library and CLI tool developed by the Puppeteer team to connect Chrome DevTools Recorder JSON exports with automated execution workflows.

It allows developers to replay recordings either directly from the terminal or programmatically via Node.js APIs, with full control over headless modes and step execution hooks via runner extensions.

Additionally, it provides stringification capabilities to transform recorded JSON flows into executable test scripts for Puppeteer, Cypress, Nightwatch, WebdriverIO, and other testing frameworks.

Sources

Each field shows its status and source — expand to review.

11 · Expand

  • capability tags

    Verified

    Source: admin_cms · cms editor · 8/15/2026

  • Latest release

    Verified

    v4.0.2

    Source: GitHub API · latest_release=v4.0.2 · 10/3/2026

  • License

    Verified

    Apache-2.0

    Source: GitHub API · license.spdx_id=Apache-2.0 · 10/3/2026

  • needs api key

    Verified

    No

    Source: admin_cms · cms editor · 8/15/2026

  • One-liner

    Verified

    {"en":"A Node.js library and CLI tool to replay, customize, and stringify Chrome DevTools Recorder user flows.","zh":"用于重放、自定义执行及转译 Chrome DevTools Recorder 用户流程录制的 Node.js 库与 CLI 工具。"}

    Source: admin_cms · cms editor · 8/15/2026

  • Platforms

    Verified

    linux, macos, windows

    Source: admin_cms · cms editor · 8/15/2026

  • Category hint

    Inferred from materials

    browser-desktop

    Source: Project README · hint=browser-desktop · 8/15/2026

  • product forms

    Verified

    cli, library_framework

    Source: admin_cms · cms editor · 8/15/2026

  • role tags

    Verified

    Source: admin_cms · cms editor · 8/15/2026

  • supports local

    Verified

    Yes

    Source: admin_cms · cms editor · 8/15/2026

  • supports self host

    Verified

    No

    Source: admin_cms · cms editor · 8/15/2026

Related projects

Other verified projects matched by category, capabilities, and intended roles.

claude-code

An agentic coding tool for the terminal that understands codebases, handles routine development tasks, explains code, and works with Git workflows.

Same Developer tools categoryActive in the last 30 days

spec-kit

An open-source CLI toolkit for Spec-Driven Development that guides AI coding agents through structured specification, planning, and code generation steps.

Same Developer tools categoryActive in the last 30 days

llama.cpp

A lightweight LLM inference engine implemented in C/C++, supporting various hardware backends and model quantization.

Same Developer tools categoryActive in the last 30 days

codex

OpenAI’s coding agent that runs locally, with terminal, IDE, and desktop-app entry points.

Same Developer tools categoryActive in the last 30 days

graphify

Convert codebases, docs, and configs into a queryable knowledge graph for AI coding assistants

Same Developer tools categoryActive in the last 30 days

supabase

An open-source Postgres development platform offering auto-generated APIs, authentication, and real-time database subscriptions.

Same Developer tools categoryActive in the last 30 days