Skip to main content
Mobium — mobile app automation for AI agents and people. Android, iOS, TV, Wear OS, Car, Meta Quest.

Mobium

Mutatis mutandis.

Mobile app automation for AI agents and people. Android emulators, Android phones, iOS simulators and iPhones — and TVs, Wear OS, Android Automotive and Meta Quest's 2D app panels — driven through one tool layer from a single Go binary with no runtime dependencies.

mobium launch com.example.shop && mobium map && mobium tap @e5 && mobium map

Mobium is for letting a coding agent check its own work on mobile. An agent that changed a login screen should be able to open the app, read what is actually on screen, tap through the flow and look at the result — without a person driving an emulator for it. People get the same commands.

It drives native, hybrid and cross-platform apps, and pages in a mobile browser or installed as a PWA, the way Vibium drives browsers: a map → @ref → act loop that an agent can follow without learning a new model.

What each app type needs, and which apps of each type were driven, is in APP-TYPES.

The loop​

map reads the screen and gives everything a person could act on a ref:

$ mobium map
@e1 Navigate up (button)
@e2 Email address (input)
@e3 password (password)
@e4 Remember me (checkbox, unchecked)
@e5 Sign In (button)
@e6 Forgot password? (link)

$ mobium type @e2 "someone@example.com"
$ mobium tap @e5
tapped @e5 at (540, 930)

A ref stands for the most durable locator that picks out that one element — a resource id, then an accessibility label, then visible text. tap @e5 reads the screen again and re-resolves the locator before it touches anything; it never replays the coordinates map saw, because the screen moves between commands. A locator that has become ambiguous is refused, not guessed.

The same locators work on both platforms:

LocatorAndroidiOS
text=Sign Intextvalue, or the label of a control with no text of its own
label=Emailcontent-descaccessibility label
testid=submitresource-idaccessibilityIdentifier
role=buttonandroid.widget.Button and kinXCUIElementTypeButton

Coordinates are device pixels on both, so a point read off a screenshot can be tapped directly.

Actions wait, and refuse what they cannot do​

Before it acts, every action waits for its target to exist, be on screen, stop moving and be enabled, and scrolls to it if it is off screen. It refuses — rather than taps — a target under a dialog or the keyboard, and type refuses what is certainly not a text field. A refusal carries a code that is the same in every client and on the wire, and a remedy that works. Auto-wait goes through each check.

Seven front doors, one tool layer​

SurfaceFor
CLIpeople, shell scripts, and agents with a shell
MCPagents: mobium mcp is an MCP server on stdio
Python, JavaScript, Go, Java, .NETtest code and tools
mobium testJSON test files, run on the devices a config names

Every command, MCP tool and client method is the same code underneath: the CLI parses flags and calls a tool by name, the MCP server hands the tool to an agent, and each client speaks to it through mobium pipe. So they cannot answer differently, and the reference links each tool across all seven.

Where it runs​

Android emulator or phoneiOS simulator or iPhone
macOSYesYes — needs Xcode
LinuxYesNo — iOS needs Xcode, which runs only on macOS
WindowsNot yetNo

Verified on devices, not only compiled: a Pixel 7 emulator on Android 15 and 17, a Pixel 8 Pro on Android 17, an iPhone 17 Pro simulator on iOS 26.5 and an iPhone 18 Pro simulator on iOS 27.0, and an iPhone 15 Plus on iOS 26.6.2 and, since its update, iOS 27.0.1.

Beyond phones, from the same binary:

What is drivenMore
TVsa Fire TV over adb connect, an Android TV, and an Apple TV simulator — with a remote: the D-pad, select, back and media keys, each press reported by where focus wentPlatforms, Apple TV setup
Wear OSa Wear OS 5.1 emulator, through the Android backends with nothing added; not yet a real watch, or the crownwear-os.sh
Carsthe Android Automotive 15 emulator, through the UiAutomator2 backend: the system bars and the app between them, its dialogs and the car's permission prompt, acting for user 10, the driver, as the car's apps do; not yet a real car, the instrument cluster, Android Auto, or CarPlay, which Xcode 27.1's simulator does not offerautomotive.sh
Meta Questthe 2D app panels on the Meta Spatial Simulator, Meta's Horizon OS emulator; not yet a real headset, or immersive appsHORIZON-OS

Windows is not declared supported yet: an Android emulator and a phone have been driven from a Windows laptop through the CLI, MCP and all five clients, the checks a person at the machine runs passed on the v0.1.0-rc1 prerelease, and the windows/arm64 build drove a device from Windows on ARM. Left is a full sweep of the device checks on an emulator; the state of it is in WINDOWS.

Next​

  • Quick start — from nothing to a script that starts a session, taps, takes a screenshot and quits, in the language you use.
  • Guides — auto-wait, the test runner, a grid of devices, network conditions, the CLI and MCP in depth.
  • Reference — every command, tool and method, each with examples.