Creating tests with the CLI

Heal includes an autopilot that creates and fixes tests.

heal autopilot

Run the autopilot from your project root:

heal autopilot

By default, the autopilot runs in an interactive mode:

• It asks you questions about what you want to test (e.g. feature, page, critical path).
• It may ask how to handle ambiguities or multiple possible flows.
• It shows you proposed changes and can ask for confirmation before writing files.

This mode is ideal when you are exploring a new area or want tighter control over what gets generated.

Running autopilot without questions (--yolo)

For fully automated runs (for example, in CI or when you have a clear goal), you can add the --yolo flag:

heal autopilot --yolo

With --yolo enabled:

• The autopilot does not ask interactive questions.
• It proceeds with reasonable defaults for prompts and decisions.
• It writes or updates tests directly based on its understanding of your project.

Use --yolo when you want maximum speed and are comfortable letting Heal make decisions without pausing for input.

Next steps

• Learn how to run and tune tests in Running tests.
• Explore all CLI commands and flags in Commands.