Maestro CLI

Source: https://docs.maestro.dev/maestro-cli, https://docs.maestro.dev/maestro-cli/how-to-install-maestro-cli, https://github.com/mobile-dev-inc/Maestro

Purpose

The Maestro CLI is an open-source, single-binary framework for end-to-end mobile and web UI testing. Tests are written as declarative YAML "Flows" and executed against Android emulators, iOS simulators, or physical devices. Built on the philosophy of "embracing instability," it provides automatic flakiness tolerance — waiting for the screen to settle before each action — eliminating the need for manual sleep() calls.

When to Use

• Running local UI tests: maestro test flow.yaml against a connected emulator, simulator, or device
• Continuous development: maestro test -c monitors YAML files and re-runs on save
• Debugging selectors: maestro hierarchy prints the full view hierarchy to the terminal
• Device provisioning: maestro start-device launches emulator/simulator configs
• Recording test runs: maestro record produces an MP4 of the test session
• Scaling to Maestro Cloud for parallel execution across managed devices
• NOT for: unit testing, API/backend testing, non-UI integration tests

Basic Usage