Command Reference
Device management
Section titled “Device management”# List all booted devicesmobilecli devices
# List all devices including offline onesmobilecli devices --include-offline --platform ios --type simulator
# Boot an offline emulator/simulatormobilecli device boot --device <device-id>
# Shutdown a running emulator/simulatormobilecli device shutdown --device <device-id>
# Reboot a devicemobilecli device reboot --device <device-id>
# Get device info (OS, version, screen size)mobilecli device info --device <device-id>
# Get/set device orientationmobilecli device orientation get --device <device-id>mobilecli device orientation set --device <device-id> landscapeApp management
Section titled “App management”# Launch an appmobilecli apps launch --device <device-id> com.example.app
# Terminate an appmobilecli apps terminate --device <device-id> com.example.app
# List installed appsmobilecli apps list --device <device-id>
# Install an app (.apk for Android, .ipa/.zip for iOS)mobilecli apps install --device <device-id> /path/to/app.apk
# Uninstall an appmobilecli apps uninstall --device <device-id> com.example.appScreen & media
Section titled “Screen & media”# Take a PNG screenshotmobilecli screenshot --device <device-id> -o screen.png
# Take a JPEG screenshot with quality settingmobilecli screenshot --device <device-id> -o screen.jpg -f jpeg -q 85
# Stream screen capture (MJPEG)mobilecli screencapture --device <device-id> -f mjpeg | ffplay -Input/output
Section titled “Input/output”# Tap at coordinatesmobilecli io tap --device <device-id> 100,200
# Long press at coordinatesmobilecli io longpress --device <device-id> 100,200
# Swipe from one point to anothermobilecli io swipe --device <device-id> 100,200,300,400
# Press hardware button (HOME, VOLUME_UP, VOLUME_DOWN, POWER)mobilecli io button --device <device-id> HOME
# Send text inputmobilecli io text --device <device-id> "Hello World"Utilities
Section titled “Utilities”# Open a URL or deep linkmobilecli url --device <device-id> https://example.com
# Dump UI treemobilecli dump ui --device <device-id>Server mode
Section titled “Server mode”# Start HTTP/WebSocket servermobilecli server start --listen localhost:12000 --corsThis exposes all MobileCLI functionality via JSON-RPC over HTTP POST and WebSocket.
Common flags
Section titled “Common flags”| Flag | Description |
|---|---|
--device <id> | Target device ID (from mobilecli devices) |
-v, --verbose | Enable verbose output |
--help | Show help for any command |