TestRelic for Maestro
TestRelic is an AI-driven Testing Observability Platform for engineering teams. The Maestro integration wraps the Maestro CLI to automatically capture rich test analytics from every flow run and sends them to the cloud platform for AI analysis, monitoring, and integrations.
| Layer | What it is | Where it runs |
|---|---|---|
@testrelic/maestro-analytics | CLI wrapper that captures flow results, per-step timing, screenshots, video, and AI defect data from your existing Maestro suite | Locally, alongside your Maestro flows |
| Cloud Platform | Dashboard for visualising test data, running AI analysis, monitoring quality gates, and connecting tools | testrelic.ai |
What does @testrelic/maestro-analytics capture?
Add one command in front of your existing maestro test invocation and the integration automatically captures:
- Flow results — pass, fail, and skip status for every YAML flow in the suite
- Per-step timing — duration and outcome of each Maestro command inside a flow
- Screenshots — device screenshots taken during the run
- Video recordings — full screen recordings captured by Maestro (when enabled in your flows)
- AI defect reports — UI, accessibility, spelling, and layout issues detected by Maestro's
--analyzeflag - Flow metadata —
appId, tags, and environment variables declared in YAML flow headers - CI/CD context — build number, branch, and commit automatically detected from GitHub Actions, GitLab CI, Jenkins, CircleCI, and others
- Interactive HTML report — self-contained report written to
./test-results/testrelic-maestro.htmland opened in the browser automatically after every local run
Requirements
| Requirement | Version |
|---|---|
| Maestro CLI | Latest (install with curl -Ls "https://get.maestro.mobile.dev" | bash) |
| Node.js | ≥ 18 |
Android and iOS support
Maestro supports Android emulators and physical devices, and iOS simulators on macOS. TestRelic captures results from any platform that Maestro itself supports.
Next steps
- Get Started — install the package and run your first instrumented flow in minutes
- Cloud Quickstart — enable cloud upload to explore results in the TestRelic dashboard