mobilecli 1.0.4 → 1.0.6

package/README.md

@@ -35,9 +35,11 @@ A universal command-line tool for managing iOS and Android devices, simulators,
 - **Multiple Output Formats**: Save screenshots as PNG or JPEG with quality control
 - **Screencapture video streaming**: Stream mjpeg/h264 video directly from device
 - **Device Control**: Reboot devices, tap screen coordinates, press hardware buttons
-- **App Management**: Launch, terminate, install, uninstall, list, and get foreground apps
+- **App Management**: Launch, terminate, install, uninstall, clear data, list, and get foreground apps
 - **Filesystem**: Push, pull, list, mkdir, and rm files on-device or in app containers (Android, iOS Simulator)
+- **Location Override**: Fake the GPS location reported by a device
 - **Crash Reports**: List and fetch crash reports from iOS and Android devices
+- **Device Logs**: Stream real-time device logs with filtering from iOS and Android devices
 - **Webview Inspection**: List, navigate, query DOM, and evaluate JavaScript in embedded webviews
 
 ### 🎯 Platform Support
@@ -138,6 +140,12 @@ mobilecli screenshot --device <device-id>
 # Take a JPEG screenshot with custom quality
 mobilecli screenshot --device <device-id> --format jpeg --quality 80
 
+# Scale the screenshot down to half size
+mobilecli screenshot --device <device-id> --scale 0.5
+
+# Limit the largest dimension to 800 pixels, keeping aspect ratio
+mobilecli screenshot --device <device-id> --max-size 800
+
 # Save to specific path
 mobilecli screenshot --device <device-id> --output screenshot.png
 
@@ -179,8 +187,39 @@ mobilecli io button --device <device-id> POWER
 
 # Send text
 mobilecli io text --device <device-id> 'hello world'
+
+# Read device clipboard
+mobilecli io clipboard get --device <device-id>
+
+# Write device clipboard
+mobilecli io clipboard set --device <device-id> 'hello world'
+
+# Send keys combination to paste (cmd+v for iOS, ctrl+v for Android)
+mobilecli io keys --device <device-id> "cmd+v"
+```
+
+### Location Override 📍
+
+```bash
+# Fake the device location (latitude,longitude)
+mobilecli device location set --device <device-id> 37.7749,-122.4194
+
+# Hold the override until Ctrl-C, then clear it automatically
+mobilecli device location set --device <device-id> 37.7749,-122.4194 --wait
+
+# Restore the real location
+mobilecli device location clear --device <device-id>
 ```
 
+Caveats per platform:
+
+| Platform | Notes |
+|----------|-------|
+| iOS Simulator | Works out of the box, the override survives mobilecli exiting |
+| iOS Real Device | The override only lives as long as the mobilecli process that set it, so `--wait` is required. `clear` has to come from that same process |
+| Android Emulator | Uses the emulator console. It has no way to undo a fix, so `clear` sets the location back to the coordinates an emulator boots with (the Googleplex), not to a real one |
+| Android Real Device | Runs an on-device agent as a mock location provider, granting the `mock_location` appop to `com.android.shell`. Some OEM ROMs ignore mock providers, and apps checking `Location.isFromMockProvider()` or Play Integrity can tell |
+
 ### Supported Hardware Buttons
 
 - `HOME` - Home button
@@ -209,6 +248,10 @@ mobilecli apps install <path> --device <device-id>
 
 # Uninstall an app
 mobilecli apps uninstall <bundle-id> --device <device-id>
+
+# Clear app data (cache, preferences, databases) without uninstalling
+# Supported on Android and iOS Simulator
+mobilecli apps clear <bundle-id> --device <device-id>
 ```
 
 Example output for `apps foreground`:
@@ -425,6 +468,47 @@ Example output for `crashes list`:
 
 **Note**: On iOS real devices, crash reports are fetched via the Apple crashreport service. On iOS simulators, they are read from `~/Library/Logs/DiagnosticReports/`. On Android, crashes are parsed from `adb logcat -b crash`.
 
+### Device Logs 📋
+
+```bash
+# Stream logs from a device (Ctrl+C to stop)
+mobilecli device logs --device <device-id>
+
+# Stop after 100 entries
+mobilecli device logs --device <device-id> --limit 100
+
+# Filter by field (exact match)
+mobilecli device logs --filter process=SpringBoard
+mobilecli device logs --filter tag=ActivityManager
+
+# Exclude by field
+mobilecli device logs --filter process!=SpringBoard
+
+# Combine filters (AND logic)
+mobilecli device logs --filter level=Error --filter process!=SpringBoard
+```
+
+Supported filter keys: `pid`, `process`, `tag`, `level`, `subsystem`, `category`, `message`
+
+Each log entry is printed as a JSON line:
+```json
+{"timestamp":"2026-04-15 12:17:14.224451+0300","message":"Start proc...","level":"Default","subsystem":"com.apple.UIKit","category":"EventDispatch","pid":54052,"process":"SpringBoard"}
+```
+
+Logs are also available over the [HTTP API](#http-api-) via the `device.logs` method, which takes the same `limit` and `filters` and returns a URL to stream from:
+
+```bash
+curl -X POST http://localhost:12000/rpc -H "Content-Type: application/json" -d '{
+  "jsonrpc": "2.0", "method": "device.logs", "id": 1,
+  "params": { "deviceId": "<device-id>", "limit": 100, "filters": ["level=Error", "process!=SpringBoard"] }
+}'
+# => {"jsonrpc":"2.0","id":1,"result":{"sessionUrl":"/sessions/<session-id>/logs"}}
+
+curl -N http://localhost:12000/sessions/<session-id>/logs
+```
+
+The session expires one minute after creation and accepts a single connection. Disconnecting stops the log stream on the device.
+
 ### Remote Devices ☁️
 
 ```bash

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mobilecli",
-	"version": "1.0.4",
+	"version": "1.0.6",
 	"author": "Mobile Next",
 	"description": "A universal command-line tool for managing iOS and Android devices, simulators, emulators and apps",
 	"repository": {