mobile-next/mobilewright

Mobilewright is a dev framework for Mobile App Testing and Automation. It allows testing iOS/Android app on real devices, emulators and simulators with a single API.

What it solves

Mobilewright simplifies mobile device automation for iOS and Android. It replaces complex, verbose tools like Appium or native frameworks with a clean, auto-waiting API that reduces the need for manual waits and complex locators (like XPath), making it easier to write reliable tests and build AI agents that can control mobile devices.

How it works

Built on top of mobilecli, Mobilewright provides a unified interface for interacting with real devices, simulators, and emulators. It exposes the device's accessibility tree, allowing users to find elements via semantic roles, labels, and text rather than coordinates. For hybrid apps, it bridges into the DOM to provide a Playwright-compatible Page object for web content. It also includes a doctor CLI tool to verify environment dependencies like Xcode and Android SDK.

Who it’s for

  • QA Engineers and Developers who want a Playwright-like developer experience for mobile testing.
  • AI Agent Developers who need a deterministic, token-efficient way for agents to perceive and interact with mobile screens without relying on vision models.
  • Cross-platform Teams needing a single API to target both iOS and Android.

Highlights

  • Playwright-inspired API: Uses familiar patterns like getByRole, getByText, and expect assertions.
  • AI-Ready: Provides direct access to the accessibility tree for deterministic agent control.
  • Auto-waiting: Actions automatically wait for elements to be visible, enabled, and stable.
  • Hybrid App Support: Seamlessly switches between native views and WebViews with a standard Playwright API.
  • Cross-Platform: Unified interface for iOS and Android devices and emulators.
  • Zero Config: Automatically discovers booted simulators.

Related

  • Project
    Core-Mate/OpenGUI

    OpenGUI is a framework that lets AI agents control real Android phones by interpreting screenshots and issuing UI actions. It provides WorkBuddy and DeepSeek Harness plugins for easy chat‑based use, a full optional backend for advanced task planning, and a small Android client that performs taps, swipes, typing, etc. Ideal for AI‑driven testing, automation, and content creation on mobile devices.

  • Project
    microsoft/playwright

    Playwright is a Microsoft‑maintained open‑source framework for automating Chromium, Firefox and WebKit. It offers a full‑featured test runner (Playwright Test), a low‑level library for scripts, a command‑line tool for coding‑assistant agents, and an MCP server that exposes a structured accessibility tree so LLMs can control browsers deterministically. Available for Node.js, Python, .NET and Java, it runs on all major OSes and integrates with VS Code for debugging and trace viewing.

  • Project
    droidrun/mobilerun

    An open-source framework that enables LLM agents to control Android and iOS devices using natural language, providing tools for UI inspection and mobile automation.

  • Project
    minitap-ai/mobile-use

    An open-source AI agent that automates Android and iOS devices using natural language to perform tasks and scrape data from apps.

  • Project
    droidrun/mobile-harness

    Mobile Harness is a Python‑based, Markdown‑driven library that lets LLM agents control Android and iOS devices (locally via ADB/Portal or remotely via Mobilerun cloud). It offers a unified API for UI interaction, screenshots, app launch, and accessibility‑tree queries, and includes benchmarks showing near‑perfect performance on AndroidWorld and iOSWorld task suites.