conductor-create-flow

name	conductor-create-flow
description	Author and run Maestro-compatible YAML flows and command sequences with the conductor CLI, including recording flows from live interactions and sharding them across devices. Use when scripting a repeatable multi-step app journey, running an existing Maestro flow, recording a flow by interacting with the app, or running flows in parallel across booted devices.

Conductor — flows

A flow is a YAML file describing a sequence of conductor commands. Conductor's format is a subset of Maestro's — most existing Maestro flows run unchanged. Use flows for repeatable journeys; use conductor-device-interact for one-off ad-hoc steps.

Run flows

Command	Purpose
conductor run-flow <file> [--env K=V] [--benchmark]	Run a Maestro YAML flow file
conductor run-flow-inline '<yaml>' [--benchmark]	Run inline YAML from the command line
conductor run-sequence [--file path.json]	Run a JSON sequence of conductor commands serially; reads stdin if no --file
conductor run-parallel --flows-dir <path>	Shard a directory of flows across all booted devices

--benchmark prints elapsed time per command and total flow time.

Flow YAML

appId: com.example.myapp
---
- launchApp
- tapOn: "Sign In"
- inputText: "[e-mail]"
- assertVisible: "Dashboard"

run-sequence JSON shape (stops on first non-zero exit):

{ "steps": [ { "cmd": "tap-on", "args": ["Login"] }, { "cmd": "input-text", "args": ["[e-mail]"] } ] }

Record a flow from your interactions

Command	Purpose
conductor flow record start [--out path]	Start recording this session's interactions to a YAML file
conductor flow record echo <text>	Insert a console.log step
conductor flow record status	Show the active recording path
conductor flow record finish	Close the recording, print the file path

Record, then interact via conductor-device-interact; each action is appended to the flow. finish gives you a runnable .yaml.

Tips

• Add --json for machine-readable output; a failed step exits non-zero.
• conductor run-flow --help (and friends) for exact flags.