mobium launch
This tool on every surface: CLI · MCP · Python · JavaScript · Go · Java · .NET
Bring an app to the foreground
Usage
mobium launch <package | bundle-id> [flags]
Flags
| Flag | Type | Default | What it does |
|---|---|---|---|
--gray-box | bool | Launch the app with Mobium's gray-box library on, so every action waits for the app to say it is idle (docs/guides/graybox.md) | |
--hit-test | bool | On an iOS simulator, load the hit probe into the app as it launches, so every tap on an element in it asks UIKit where the touch goes first (docs/guides/autowait.md) |
And the global flags.
Examples
Bring an app to the front
mobium launch com.android.settings
Printed on an Android 15 emulator:
launched com.android.settings
mobium launch com.android.settings on an Android 15 emulator
Launch an app with the gray box on, so every action waits for it to be idle
mobium launch --gray-box dev.mobium.mobiumapp
Printed on an Android 15 emulator:
launched dev.mobium.mobiumapp, with the gray box: every action waits for the app to say it is idle
More, from mobium launch --help
mobium launch com.google.android.dialer
mobium launch com.apple.Preferences
mobium launch --hit-test dev.mobium.mobiumapp
mobium launch --gray-box dev.mobium.mobiumapp
The tool
launch calls app_launch; its arguments and what every client calls it are there.