Getting started
Getting started with Heal for agentic testing.
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:
1. Clone the starter test repo
bash 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-template2. Install dependencies
Make sure you have Node.js and npm installed, then run:
npm install3. Set your token
Add your HEAL_API_TOKEN to your .env file in the repo root:
HEAL_API_TOKEN=your_token_here4. Run the autopilot
From the project root, run the autopilot and ask it to build or run tests:
npx heal autopilot1. Install the Heal CLI globally
Make sure you have Node.js and npm installed, then run:
npm install -g @heal-dev/heal-cli2. Set your token
Export your HEAL_API_TOKEN in your shell (or add it to your shell profile):
export HEAL_API_TOKEN=your_token_here3. Run heal autopilot
From the project root, run the autopilot and ask it to build or run tests:
heal autopilotNext steps
- Learn about all available commands in Commands reference.