Command Reference
Device management
# List all booted devices
mobilecli devices
# List all devices including offline ones
mobilecli devices --include-offline --platform ios --type simulator
# Boot an offline emulator/simulator
mobilecli device boot --device <device-id>
# Shutdown a running emulator/simulator
mobilecli device shutdown --device <device-id>
# Reboot a device
mobilecli device reboot --device <device-id>
# Get device info (OS, version, screen size)
mobilecli device info --device <device-id>
# Get/set device orientation
mobilecli device orientation get --device <device-id>
mobilecli device orientation set --device <device-id> landscape
App management
# Launch an app
mobilecli apps launch --device <device-id> com.example.app
# Terminate an app
mobilecli apps terminate --device <device-id> com.example.app
# List installed apps
mobilecli 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 app
mobilecli apps uninstall --device <device-id> com.example.app
Screen & media
# Take a PNG screenshot
mobilecli screenshot --device <device-id> -o screen.png
# Take a JPEG screenshot with quality setting
mobilecli 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
# Tap at coordinates
mobilecli io tap --device <device-id> 100,200
# Long press at coordinates
mobilecli io longpress --device <device-id> 100,200
# Swipe from one point to another
mobilecli 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 input
mobilecli io text --device <device-id> "Hello World"
Utilities
# Open a URL or deep link
mobilecli url --device <device-id> https://example.com
# Dump UI tree
mobilecli dump ui --device <device-id>
Server mode
# Start HTTP/WebSocket server
mobilecli server start --listen localhost:12000 --cors
This exposes all MobileCLI functionality via JSON-RPC over HTTP POST and WebSocket.
Common flags
| Flag | Description |
|---|---|
--device <id> | Target device ID (from mobilecli devices) |
-v, --verbose | Enable verbose output |
--help | Show help for any command |