Running a Test with Fathom

Prerequisites

Before starting a Fathom test run, ensure the following:

1. A local Android emulator is running

2. The emulator is connected to the Drizz Desktop App

Starting a Run

1. Open Fathom by clicking the chat icon in the top left of the page

2. Type the test intent in the chat window describing the scenario to execute

3. Fathom will begin executing the test on the connected emulator

During Execution

Fathom executes each step automatically. In some cases, the agent may encounter situations where it cannot determine the next action — for example, an unexpected application state, a navigation loop, or an ambiguous UI path.

When this occurs, Fathom will pause and prompt the user for guidance. Providing a clarification allows the agent to resume and continue the execution.

This human-in-the-loop mechanism ensures test runs can recover from complex or unexpected application behaviors.

Completing a Run

Once execution is complete, Fathom automatically generates a test script based on the actions performed. The script is available for review in the editor immediately after the run concludes.