mobilecli 1.0.6 → 1.0.8

package/README.md

@@ -2,25 +2,16 @@
 
 A universal command-line tool for managing iOS and Android devices, simulators, emulators and apps from [Mobile Next](https://github.com/mobile-next/).
 
-<p align="center">
+<p align="left">
   <a href="https://github.com/mobile-next/mobilecli">
     <img src="https://img.shields.io/github/stars/mobile-next/mobilecli" alt="Mobile Next Stars" />
   </a>
-  <a href="https://github.com/mobile-next/mobilecli">
-    <img src="https://img.shields.io/github/contributors/mobile-next/mobilecli?color=green" alt="Mobile Next Downloads" />
-  </a>
   <a href="https://www.npmjs.com/package/mobilecli">
     <img src="https://img.shields.io/npm/dm/mobilecli?logo=npm&style=flat&color=red" alt="npm">
   </a>
-  <a href="https://github.com/mobile-next/mobilecli/releases">
-    <img src="https://img.shields.io/github/release/mobile-next/mobilecli">
-  </a>
   <a href="https://github.com/mobile-next/mobilecli/blob/main/LICENSE">
     <img src="https://img.shields.io/badge/license-FSL--1.1--Apache--2.0-blue.svg" alt="mobilecli is released under the FSL-1.1-Apache-2.0 License">
   </a>
-</p>
-
-<p align="center">
   <a href="http://mobilenext.ai/join-slack">
       <img src="https://img.shields.io/badge/join-Slack-blueviolet?logo=slack&style=flat" alt="Slack community channel" />
   </a>
@@ -146,6 +137,9 @@ 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
 
+# Crop to a region (x,y,width,height in screen points), applied before scaling
+mobilecli screenshot --device <device-id> --clip 10,80,300,200
+
 # Save to specific path
 mobilecli screenshot --device <device-id> --output screenshot.png
 
@@ -352,7 +346,7 @@ Example output for `fs ls`:
 
 On **iOS**, the on-device agent is required for touch input (taps, swipes, button presses), screen capture streaming, and UI tree inspection. These capabilities are not available through standard iOS tooling without an agent running on the device.
 
-On **Android**, most features work without the agent, but installing it enables non-ASCII text input (e.g. Japanese, Chinese, Korean, emoji) which is not possible through `adb` alone.
+On **Android**, no agent is needed. Running `mobilecli agent status` on an Android device simply reports that.
 
 ```bash
 # Check if the agent is installed on a device
@@ -541,10 +535,24 @@ npx skills add mobile-next/mobilecli -g
 
 Then ask your agent things like "take a screenshot of my emulator" or "tap the login button" — the skill triggers automatically.
 
+## Daemon ⚙️
+
+Every device command talks to a per-user background daemon that keeps discovered devices, iOS tunnels and on-device agents alive between invocations, so only the first command pays the discovery cost. The daemon starts automatically on the first device command (`mobilecli --help` and `--version` never start it) and exits after 30 minutes without requests.
+
+```bash
+# Inspect or control it explicitly
+mobilecli daemon status
+mobilecli daemon stop
+
+# Run it in the foreground (e.g. under a service manager), with a custom idle timeout
+mobilecli daemon start --idle-timeout 0
+```
+
+The CLI and daemon talk JSON-RPC over a unix domain socket in `~/.mobilecli/` (override with `MOBILECLI_HOME`); the daemon's log is `~/.mobilecli/daemon.log`. A daemon left over from an older mobilecli version is restarted automatically. `auth login` and `auth logout` stop a running daemon so it picks up the new credentials.
+
 ## HTTP API 🔌
 
-***mobilecli*** provides an http interface for all the functionality that is available through command line. As a matter of fact, it is preferable to
-use mobilecli as a webserver, so it can cache and keep tunnels alive, speeding up your interactions with the mobile device or simulator/emulator.
+***mobilecli*** provides an http interface for all the functionality that is available through command line. The server is a thin front for the daemon above, so HTTP clients and the CLI share one set of devices and tunnels.
 
 For the full list of available JSON-RPC methods and their parameters, see the [OpenRPC specification](https://github.com/mobile-next/mobile-openrpc/blob/main/mobilecli/openrpc.md).
 

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.6",
+	"version": "1.0.8",
 	"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.8",
+		"@mobilenext/mobilecli-darwin-arm64": "1.0.8",
+		"@mobilenext/mobilecli-linux-amd64": "1.0.8",
+		"@mobilenext/mobilecli-linux-arm64": "1.0.8",
+		"@mobilenext/mobilecli-windows-amd64": "1.0.8",
+		"@mobilenext/mobilecli-windows-arm64": "1.0.8"
 	}
 }