mobilecli 1.0.5 → 1.0.7

package/README.md

@@ -37,7 +37,9 @@ A universal command-line tool for managing iOS and Android devices, simulators,
 - **Device Control**: Reboot devices, tap screen coordinates, press hardware buttons
 - **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
 
@@ -190,6 +198,28 @@ mobilecli io clipboard set --device <device-id> 'hello world'
 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
@@ -438,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/index.js

@@ -3,16 +3,19 @@
 const { join } = require("node:path");
 const { spawn } = require("node:child_process");
 
-let binary;
+let packageName;
+let binaryName;
 
 switch (process.platform) {
 	case "darwin":
 		switch (process.arch) {
 			case "arm64":
-				binary = "mobilecli-darwin-arm64";
+				packageName = "@mobilenext/mobilecli-darwin-arm64";
+				binaryName = "mobilecli-darwin-arm64";
 				break;
 			case "x64":
-				binary = "mobilecli-darwin-amd64";
+				packageName = "@mobilenext/mobilecli-darwin-amd64";
+				binaryName = "mobilecli-darwin-amd64";
 				break;
 		}
 		break;
@@ -20,10 +23,12 @@ switch (process.platform) {
 	case "linux":
 		switch (process.arch) {
 			case "arm64":
-				binary = "mobilecli-linux-arm64";
+				packageName = "@mobilenext/mobilecli-linux-arm64";
+				binaryName = "mobilecli-linux-arm64";
 				break;
 			case "x64":
-				binary = "mobilecli-linux-amd64";
+				packageName = "@mobilenext/mobilecli-linux-amd64";
+				binaryName = "mobilecli-linux-amd64";
 				break;
 		}
 		break;
@@ -31,21 +36,30 @@ switch (process.platform) {
 	case "win32":
 		switch (process.arch) {
 			case "arm64":
-				binary = "mobilecli-windows-arm64.exe";
+				packageName = "@mobilenext/mobilecli-windows-arm64";
+				binaryName = "mobilecli-windows-arm64.exe";
 				break;
 			case "x64":
-				binary = "mobilecli-windows-amd64.exe";
+				packageName = "@mobilenext/mobilecli-windows-amd64";
+				binaryName = "mobilecli-windows-amd64.exe";
 				break;
 		}
 		break;
 }
 
-if (!binary) {
+if (!packageName) {
 	console.error(`Unsupported platform: ${process.platform}-${process.arch}`);
 	process.exit(1);
 }
 
-const binaryPath = join(__dirname, "bin", binary);
+let binaryPath;
+try {
+	const packagePath = require.resolve(`${packageName}/package.json`);
+	binaryPath = join(packagePath, "..", binaryName);
+} catch (error) {
+	console.error(`Failed to find ${packageName}. Please reinstall @mobilenext/mobilecli.`);
+	process.exit(1);
+}
 
 const args = process.argv.slice(2);
 const child = spawn(binaryPath, args, {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "mobilecli",
-	"version": "1.0.5",
+	"version": "1.0.7",
 	"author": "Mobile Next",
 	"description": "A universal command-line tool for managing iOS and Android devices, simulators, emulators and apps",
 	"repository": {
@@ -10,5 +10,13 @@
 	"license": "MIT",
 	"bin": {
 		"mobilecli": "index.js"
+	},
+	"optionalDependencies": {
+		"@mobilenext/mobilecli-darwin-amd64": "1.0.7",
+		"@mobilenext/mobilecli-darwin-arm64": "1.0.7",
+		"@mobilenext/mobilecli-linux-amd64": "1.0.7",
+		"@mobilenext/mobilecli-linux-arm64": "1.0.7",
+		"@mobilenext/mobilecli-windows-amd64": "1.0.7",
+		"@mobilenext/mobilecli-windows-arm64": "1.0.7"
 	}
 }