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 (--interactive false)

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

heal autopilot --interactive false

With --interactive false 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 --interactive false when you want to let Heal make decisions without asking for input. This is often used in fully agentic loops or in CI.

Next steps

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