Maestro

Maestro is an open-source framework from Maestro.dev (mobile-dev-inc) for UI and end-to-end testing of Android, iOS, and web apps. Tests are written as flat YAML flows, run through a CLI, built visually in Maestro Studio, or driven by coding agents through the Maestro MCP server. The project is released under the Apache 2.0 license.

What It Is

Maestro is a mobile and web UI testing framework. Each test is a list of YAML commands such as launchApp, tapOn, inputText, and assertVisible. The README says it drives apps through the platform's accessibility layer and installs as a single binary with no drivers or SDK. Flows are interpreted, so there is no compilation step. Flows run on emulators, simulators, browsers, and physical Android devices; physical iOS devices are not yet supported.

Agentic UI Testing with Maestro MCP

The Maestro MCP server ships inside the CLI (maestro mcp). It gives a coding agent such as Claude Code, Cursor, Codex, or Gemini CLI a live device, so the agent can inspect the screen, tap, scroll, and assert while it builds a feature. An agent can also write an end-to-end flow in plain YAML, run it until it passes, and leave it in the repo as a deterministic test for CI.

Studio, CLI, and Cloud

• Maestro CLI: open-source engine for running YAML flows locally or in CI. Commands include test, cloud, record, start-device, and mcp.
• Maestro Studio: a free desktop IDE (not open source) for macOS, Windows, and Linux with a visual flow builder, element inspector, and embedded emulator.
• Maestro Cloud: hosted infrastructure for running flows in parallel, with step-by-step video playback, logs, and flake detection.

Setup Path

Maestro requires Java 17 or higher. On macOS, Linux, or Windows (WSL), the README installs the CLI with a single curl command. The README states that it works with React Native, Flutter, native iOS and Android, Ionic, and hybrid apps using the same commands.