maestro-run

What problem does it solve?

Automates running Maestro end-to-end mobile test flows by discovering project layout, selecting the correct flows, validating the environment, and producing structured results so developers avoid manual trial-and-error when executing tests on iOS Simulator.

Core Features & Use Cases

• Automatic Project Discovery: Finds .maestro, maestro, or flows directories across monorepos and selects the closest project context to run.
• Flexible Flow Resolution: Supports category names, exact flow files, fuzzy keyword matches, run-all, and interactive Studio mode for debugging.
• Pre-flight Validation & Structured Results: Verifies Maestro installation, booted simulators, app installation, optional Metro server, and writes a maestro-run-result.yaml with pass/fail counts, failure summaries, screenshots, and categorized error types.
• Use Case: Mobile engineers in Expo, React Native, native iOS, or Flutter projects can run smoke suites, target specific flows, or analyze failures across multi-app monorepos without manual configuration.

Quick Start

Ask the assistant to run /maestro-run smoke to auto-discover the project, validate the simulator and app, and execute the smoke category flows.