heal-dev

heal-dev / heal-playwright-tracer

Public

Open-source statement-level Playwright tracer, purpose-built for AI agents. Analyzes test runs with increased accuracy.

automation claude-code claude-skill playwright qa-automation
32
0
100% credibility
Found Apr 29, 2026 at 32 stars -- GitGems finds repos before they trend. Get early access to the next one.
Sign Up Free
AI Analysis
TypeScript
AI Summary

An open-source enhancement for Playwright tests that records detailed execution traces at the statement level, including screenshots and variable states, optimized for analysis by AI agents and humans.

How It Works

1
🔍 Discover better test debugging

You hear about a helpful tool that makes Playwright tests easier to understand by showing exactly what each line does.

2
📦 Add it to your project

You simply include the tool in your existing setup with a quick addition.

3
⚙️ Link it to your tests

You make one easy change so it watches every step in your tests automatically.

4
▶️ Run your tests normally

You start your tests just like always, and the tool quietly records everything.

5
📊 Get detailed insights

You find rich logs with timings, variable values, errors, and glowing screenshots of what was clicked.

✅ Debug like a pro

Now you or an AI assistant can quickly spot and fix issues, making tests reliable and fun.

Sign up to see the full architecture

4 more

Sign Up Free

Star Growth

See how this repo grew from 32 to 32 stars Sign Up Free
Repurpose This Repo

Repurpose is a Pro feature

Generate ready-to-use prompts for X threads, LinkedIn posts, blog posts, YouTube scripts, and more -- with full repo context baked in.

Unlock Repurpose
AI-Generated Review

What is heal-playwright-tracer?

heal-playwright-tracer is an open-source TypeScript tracer for Playwright tests, purpose-built for AI agents. It instruments your test code at the statement level, outputting NDJSON streams with execution timings, variable snapshots, serialized errors, and highlighted screenshots for locator actions like clicks or assertions. This gives agents increased accuracy when analyzing test runs, capturing non-Playwright logic that standard traces miss.

Why is it gaining traction?

Unlike Playwright's action-level traces, it delivers statement-level granularity with full variable states and per-statement details, making LLM-based debugging reliable for complex tests. As a lightweight Babel plugin addition to your config, it outputs self-hosted traces ready for agents like Claude, standing out among open-source GitHub tools as a GitHub Actions alternative for precise test analysis.

Who should use this?

Playwright users building E2E tests who pipe traces to AI agents for failure triage, especially in CI where open-source GitHub Copilot alternatives shine. Suited for QA engineers debugging flaky locators or custom logic, or teams listing open-source GitHub projects under AGPL licenses.

Verdict

Early maturity at 32 stars and 1.0% credibility score, but strong docs, full test coverage, and clean install make it viable for agent-driven workflows. Grab it if Playwright traces fall short—pair with the optional reporter for crash recovery.

(178 words)

Sign up to read the full AI review Sign Up Free

Similar repos coming soon.