Getting started
Getting started with Heal for agentic testing.
Heal is a CLI-first agent that writes end-to-end Playwright test code. The SDK is optional, and you can layer it in when your workflow needs it.
The Heal CLI contains an autopilot that writes and fixes tests either interactively, or unsupervised (we avoid "headless" because that's already used for testing browsers). It requires the heal-tracer, an optimized statement level tracer that allows agents to precisely analyze Plwayright code.
Requirements
Before starting, make sure you have:
- Node.js
22.14+ - npm
- Playwright
1.58.1
Get started
In this getting started guide, pick the path that matches how you want to try Heal:
1. Clone the starter test repo
git clone https://github.com/heal-dev/heal-test-template.git;
cd heal-test-templategit clone git@github.com:heal-dev/heal-test-template.git
cd heal-test-template2. Install dependencies
Install dependencies (including Playwright 1.58.1 from the starter template), then run:
npm install3. Authenticate with Heal
npx heal login4. Run the autopilot
npx heal autopilotMake sure your project uses Playwright 1.58.1, then run:
1. Install the Heal CLI globally
npm install -g @heal-dev/heal-cli2. Authenticate with Heal
Run:
heal login3. Initialize a repo
mkdir my-project
cd my-project
heal initheal init installs and configures the Heal Playwright tracer for your project.
4. Get started
heal autopilotEditor extensions
To write tests in a more interactive experience, and run test code line by line, you can use Heal's Editor extensions:
Next steps
- Running in an agent workflow? See Agentic loop mode.
- Learn about all available commands in Commands reference.