The command line

mobium is one binary. Every command below is a tool of the same layer an MCP client and the five client libraries call, so a command and a method cannot answer differently — the command's page links the same tool on every other surface.

Mobium automates mobile apps — native, hybrid, cross-platform and pages in a
mobile browser — on Android emulators and phones, iOS simulators
and iPhones, using the same map/@ref workflow as vibium:

  mobium map && mobium tap @e1 && mobium map

Global flags

Every command takes these.

Flag	Type	What it does

--json prints the tool's structured answer. A command that fails prints error: … on stderr and exits with the status of its error's code: 2 invalid_argument; 3 no_device, device_not_ready, toolchain_missing; 4 no_such_element, ambiguous_locator, element_not_reachable, no_such_context, no_such_alert; 5 unsupported; 6 timeout; 7 not_confirmed; 1 anything else.

Commands

Command	What it does
mobium accessibility	Read the device's accessibility settings, or change one for the session
mobium alert	Read a system dialog, or answer it
mobium appearance	Read or change the device's light/dark setting
mobium apps	List the apps installed on the device
mobium audit	Run the platform's own accessibility audit on the screen in front (iOS)
mobium background	Send the app in front away for a while, and bring it back
mobium batch	Run several tools in order, in one call
mobium battery	Read the battery: level, charging state, what it is plugged into
mobium biometric	Enroll and present a face or finger (emulators and simulators)
mobium boot	Start an emulator or a simulator, and wait until it has booted
mobium call	Simulate an incoming call
mobium check	Tick a checkbox or turn a switch on
mobium clear-data	Delete an app's data and leave it installed
mobium clipboard	Read the device clipboard, or write it
mobium context	Switch context, or show the current one
mobium contexts	List automatable contexts (native shell and WebViews)
mobium cookies	Read, set or clear the current WebView's cookies
mobium crashes	List the crashes the device recorded, or read one in full
mobium current	Show the app in the foreground
mobium daemon	Manage the background daemon
mobium devices	List running emulators and devices
mobium dialogs	Declare how to answer a dialog that gets in an action's way
mobium doctor	Check that the environment mobium needs is present
mobium double-tap	Tap an element or a point twice, as one gesture
mobium download	Bring back a file from where the device keeps downloads, or list them
mobium drag	Drag something onto something else
mobium eval	Run a JavaScript expression in the current WebView
mobium fill	Clear an element and type text into it
mobium find	Find elements matching a locator, without tapping
mobium grant	Grant permissions so no dialog blocks the flow
mobium grid	Look at the grid MOBIUM_GRID names: its nodes, devices, leases and queue
mobium hit-test	Ask UIKit whether a tap on the target would reach it (iOS)
mobium hook	Call a hook the app registered with its gray-box library
mobium inspect	See the screen, the locator for anything on it, and record what you do as a test
mobium install	Install an app from a local .apk or .app
mobium keyboard	Read, type into, press a key on, or hide the soft keyboard
mobium launch	Bring an app to the foreground
mobium locale	Read or set the language one app runs in
mobium location	Read where the device thinks it is, or move it
mobium lock	Read whether the screen is locked, or lock and unlock it
mobium logs	Read the WebView console, or the device's own log
mobium long-press	Press and hold an element or a point
mobium map	Map actionable elements on screen with @refs
mobium mcp	Run as an MCP server on stdio
mobium network	Read or set network conditions: offline, latency, bandwidth (Android)
mobium notifications	Read the notification shade, post to it, or open it
mobium open	Open a URL or deep link
mobium orientation	Read which way the screen is turned, or turn it
mobium press	Press a hardware button
mobium press-drag	Hold one thing with a finger and drag a second finger elsewhere
mobium press-tap	Hold one thing with a finger and tap another with a second
mobium record	Record the screen to a video
mobium reset-permissions	Put permissions back to their defaults
mobium revoke	Deny permissions, to test the app without them
mobium rotate	Turn two fingers about an element or the screen
mobium screen	Read the screen, or make the device pretend to be a different one
mobium screenshot	Capture the device screen as PNG
mobium scroll-to	Scroll until an element is on screen
mobium session	Start or end the session on a device
mobium shake	Shake the device (emulators and simulators)
mobium show-report	Open the last HTML test report
mobium shutdown	Shut down an emulator or a simulator, its session ended first
mobium sms	Deliver a simulated text message
mobium source	Print the raw hierarchy, as the device-side server sent it
mobium state	Say whether an app is in front, in the background, not running or not installed
mobium storage	Save, restore or clear the current WebView's cookies and web storage
mobium swipe	Swipe the screen, or an element
mobium tap	Tap an element or a point
mobium terminate	Stop a running app
mobium test	Run *.test.json tests on the devices mobium.config.json names
mobium text	Read the text on screen, or of one element
mobium time	Read the device's clock, in its own zone
mobium timezone	Read the device timezone, or change it
mobium trace	Record a session as a trace, in Vibium's record format
mobium type	Type text into an element, after what it holds
mobium uncheck	Clear a checkbox or turn a switch off
mobium uninstall	Remove an app from the device
mobium upload	Put a file where the device keeps downloads, for an app's file picker to find
mobium wait	Wait for an element to appear, disappear, show text, or reach a state
mobium zoom	Pinch to zoom, about an element or the screen