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:
| Locator | Android | iOS |
|---|---|---|
text=Sign In | text | value, or the label of a control with no text of its own |
label=Email | content-desc | accessibility label |
testid=submit | resource-id | accessibilityIdentifier |
role=button | android.widget.Button and kin | XCUIElementTypeButton |
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
| Surface | For |
|---|---|
| CLI | people, shell scripts, and agents with a shell |
| MCP | agents: mobium mcp is an MCP server on stdio |
| Python, JavaScript, Go, Java, .NET | test code and tools |
mobium test | JSON 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 phone | iOS simulator or iPhone | |
|---|---|---|
| macOS | Yes | Yes — needs Xcode |
| Linux | Yes | No — iOS needs Xcode, which runs only on macOS |
| Windows | Not yet | No |
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 driven | More | |
|---|---|---|
| TVs | a 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 went | Platforms, Apple TV setup |
| Wear OS | a Wear OS 5.1 emulator, through the Android backends with nothing added; not yet a real watch, or the crown | wear-os.sh |
| Cars | the 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 offer | automotive.sh |
| Meta Quest | the 2D app panels on the Meta Spatial Simulator, Meta's Horizon OS emulator; not yet a real headset, or immersive apps | HORIZON-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.