// readme

@heal-dev/heal-playwright-tracer

heal-playwright-tracer is an agent-first diagnostic layer for your Playwright tests. It gives agents (and humans) everything they need to quickly analyze test results.

πŸ‘‰ Add this to your playwright config, run your tests, point Claude to the improved heal trace, get more accurate test diagnosis

Why

The playwright trace doesn’t contain enough data for LLM-based agents such as Claude or Open Code to analyze tests results reliably. That’s because the trace ifs focused on locator evaluation, while real-life tests also evaluate non-playwright code. Heal adds the missing instrumentation layer to let LLM agents work their magic. And it’s useful for humans in complex test codebases, too!

FeaturePlaywright TraceHeal TracerExample: What Heal Adds
GranularityAction-levelStatement-levelShows let x = calculate() line-by-line, not just the final page.click().…