agentic-emulator 0.1.1 → 0.2.0

package/README.md

@@ -1,6 +1,7 @@
 # agentic-emulator (`agemu`)
 
-An agent-first runtime for the Android emulator and the iOS Simulator on Apple Silicon Macs. LLM
+An agent-first runtime for the Android emulator (macOS, Linux, Windows) and the iOS Simulator
+(Apple Silicon Macs). LLM
 agents drive headless devices through a CLI or an MCP server: screenshots, the UI tree, taps,
 typing, apps, test capabilities, logs and crashes, in milliseconds instead of the hundreds of
 milliseconds to seconds `adb`, `simctl` and Maestro take.
@@ -11,11 +12,14 @@ npm install -g agentic-emulator                               # or the `agemu` C
 agemu doctor                                                  # checks Xcode and the Android SDK
 ```
 
-It needs an Apple Silicon Mac, and Xcode with an iOS Simulator runtime or the Android SDK with
-the emulator. `agemu doctor` says what is missing and prints the commands that install it.
+iOS needs an Apple Silicon Mac with Xcode and an iOS Simulator runtime. Android needs the
+Android SDK with the emulator, on an Apple Silicon Mac, on Linux (x86-64, arm64) with KVM or on
+Windows (x86-64) with WHPX. `agemu doctor` says what is missing and prints the commands that
+install it.
 
-The package holds three native binaries (`agemu`, the `agemud` daemon it starts, and the iOS
-helper); there is no Node code and no install script.
+The package holds native binaries for each of those platforms (`agemu`, the `agemud` daemon it
+starts, and on macOS the iOS helper) and a small Node launcher that runs the ones for this
+computer. There is no install script.
 
 Documentation, measurements and source:
 [github.com/piotr-graczyk-dev/agentic-emulator](https://github.com/piotr-graczyk-dev/agentic-emulator).

package/bin/agemu.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+// Runs the agemu binary built for this computer. The package holds one set of native binaries
+// per supported platform under platforms/<os>-<cpu>/; agemu starts the agemud daemon that sits
+// next to it. There is no install script: this launcher picks the binary at each run.
+"use strict";
+
+const { spawn } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+
+const key = `${process.platform}-${process.arch}`;
+const supported = {
+  "darwin-arm64": "macOS on Apple Silicon (iOS and Android)",
+  "linux-x64": "Linux on x86-64 (Android)",
+  "linux-arm64": "Linux on arm64 (Android)",
+  "win32-x64": "Windows on x86-64 (Android)",
+};
+const exe = path.join(__dirname, "..", "platforms", key, process.platform === "win32" ? "agemu.exe" : "agemu");
+
+if (!supported[key] || !fs.existsSync(exe)) {
+  const list = Object.values(supported).map((s) => `  - ${s}`).join("\n");
+  process.stderr.write(`agemu: no build for ${key} in this package. agemu runs on:\n${list}\n`);
+  process.exit(1);
+}
+
+const child = spawn(exe, process.argv.slice(2), { stdio: "inherit", windowsHide: true });
+
+// Pass on the signals a terminal or an MCP client sends, so agemu shuts down cleanly.
+for (const sig of ["SIGINT", "SIGTERM", "SIGHUP"]) {
+  process.on(sig, () => {
+    try {
+      child.kill(sig);
+    } catch (_) {
+      // already gone
+    }
+  });
+}
+
+child.on("error", (err) => {
+  process.stderr.write(`agemu: could not run ${exe}: ${err.message}\n`);
+  process.exit(1);
+});
+
+child.on("exit", (code, signal) => {
+  if (signal) {
+    process.removeAllListeners(signal);
+    process.kill(process.pid, signal);
+    return;
+  }
+  process.exit(code === null ? 1 : code);
+});

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "agentic-emulator",
-  "version": "0.1.1",
-  "description": "Agent-first runtime for the Android emulator and the iOS Simulator on Apple Silicon Macs: a CLI and MCP server with millisecond screenshots, UI trees and taps.",
+  "version": "0.2.0",
+  "description": "Agent-first runtime for the Android emulator (macOS, Linux, Windows) and the iOS Simulator (Apple Silicon Macs): a CLI and MCP server with millisecond screenshots, UI trees and taps.",
   "keywords": [
     "mcp",
     "mcp-server",
@@ -21,16 +21,20 @@
   "license": "MIT",
   "author": "Piotr Graczyk",
   "os": [
-    "darwin"
+    "darwin",
+    "linux",
+    "win32"
   ],
   "cpu": [
-    "arm64"
+    "arm64",
+    "x64"
   ],
   "bin": {
-    "agemu": "bin/agemu"
+    "agemu": "bin/agemu.js"
   },
   "files": [
     "bin/",
+    "platforms/",
     "THIRD_PARTY_NOTICES.md"
   ]
 }