Skip to main content

Overview

A runbook is a YAML file that describes a sequence of browser automation steps. It is produced by generate and consumed by execute.

Minimal example

Top-level fields

settings

metadata

dataSource

Used for batch execution with --data.

Step structure

Each step is a ParsedStep object. See the sections below for details on each sub-structure:

Actions

12 action types: click, input, select, navigate, scroll, wait, hover, extract, download, export, memory, key

Selectors

14 selector fields with priority-based resolution

Variables

6 variable sources with resolution priority

Captures

5 capture strategies to extract data from steps

Loops & Branches

while/forEach loops and conditional branching

Memory Operations

Append and aggregate data across steps

Common step fields

A step cannot have both loop and branches at the same time.