Getting started

Heal is an agent that writes end-to-end test code in a lightweight SDK fully compatible with Playwright. Unlike traditional web navigation SDKs, Heal uses a powerful cache so that it calls LLMs only when needed to maximize speed and stability.

The Heal CLI contains:

• a test runner optimized for running and analyzing tests with LLMs
• an autopilot that writes and fixes tests either interactively, or unsupervised (we avoid "headless" because that's already used for testing browsers)

Get started

In this getting started guide, pick the path that matches how you want to try Heal:

git clone https://github.com/heal-dev/heal-test-template.git; 
cd heal-test-template

git clone git@github.com:heal-dev/heal-test-template.git
cd heal-test-template

npm install

npx heal login

npx heal autopilot

npm install -g @heal-dev/heal-cli

heal login

mkdir my-project
cd my-project
heal init

heal autopilot

Editor extensions

To write tests in a more interactive experience, and run test code line by line, you can use Heal's Editor extensions:

VS Code extension

Cursor

Next steps

• Learn about all available commands in Commands reference.