@houwert/conductor 0.4.0 → 0.5.0

package/README.md

@@ -66,7 +66,7 @@ Claude learns every available command, how to coordinate across devices, and how
 
 | Capability | Commands |
 |---|---|
-| App lifecycle | `launch-app`, `stop-app`, `foreground-app`, `copy-app` |
+| App lifecycle | `launch-app`, `stop-app`, `clear-state`, `uninstall-app`, `install-app`, `foreground-app`, `copy-app` |
 | Interaction | `tap`, `type`, `scroll`, `scroll-until-visible`, `swipe`, `press-key`, `erase-text`, `hide-keyboard` |
 | Inspection | `inspect`, `focused`, `screenshot`, `list-apps` |
 | Assertions | `assert-visible`, `assert-not-visible` |

package/dist/commands/cheat-sheet.js

@@ -34,6 +34,7 @@ DEVICE MANAGEMENT
   session --list                            List all device sessions
 
 APP CONTROL
+  install-app <path>                        Install .app / .ipa / .apk onto device
   launch-app <appId> [--device <id>]        Launch app and save to session
     --clear-state                           Wipe app data/state before launching
     --clear-keychain                        Wipe keychain before launching

package/dist/commands/install-app.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.installApp = installApp;
+exports.HELP = `  install-app <path>                   Install .app / .ipa / .apk onto device`;
+const runner_js_1 = require("../runner.js");
+const session_js_1 = require("../session.js");
+const output_js_1 = require("../output.js");
+const bootstrap_js_1 = require("../drivers/bootstrap.js");
+async function resolveDeviceId(sessionName) {
+    if (sessionName !== 'default')
+        return sessionName;
+    const session = await (0, session_js_1.getSession)(sessionName);
+    return session.deviceId ?? (await (0, runner_js_1.detectFirstDevice)());
+}
+async function installApp(appPath, opts = {}, sessionName = 'default') {
+    if (!appPath) {
+        (0, output_js_1.printError)('install-app requires <path> to a .app, .ipa, or .apk', opts);
+        return 1;
+    }
+    const deviceId = await resolveDeviceId(sessionName);
+    if (!deviceId) {
+        (0, output_js_1.printError)('No device found. Connect a device or start a simulator first.', opts);
+        return 1;
+    }
+    const platform = await (0, bootstrap_js_1.detectPlatform)(deviceId);
+    if (platform === 'ios' || platform === 'tvos') {
+        const result = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'install', deviceId, appPath]);
+        if (!result.success) {
+            (0, output_js_1.printError)(`install-app failed: ${result.stderr}`, opts);
+            return 1;
+        }
+    }
+    else {
+        const result = await (0, runner_js_1.spawnCommand)('adb', [
+            '-s',
+            deviceId,
+            'install',
+            '-r',
+            '-t',
+            '-g',
+            appPath,
+        ]);
+        if (!result.success) {
+            (0, output_js_1.printError)(`install-app failed: ${result.stderr}`, opts);
+            return 1;
+        }
+    }
+    (0, output_js_1.printSuccess)(`install-app "${appPath}" — done`, opts);
+    return 0;
+}

package/dist/index.js

@@ -32,6 +32,7 @@ const run_parallel_js_1 = require("./commands/run-parallel.js");
 const foreground_app_js_1 = require("./commands/foreground-app.js");
 const list_apps_js_1 = require("./commands/list-apps.js");
 const copy_app_js_1 = require("./commands/copy-app.js");
+const install_app_js_1 = require("./commands/install-app.js");
 const erase_text_js_1 = require("./commands/erase-text.js");
 const assert_not_visible_js_1 = require("./commands/assert-not-visible.js");
 const open_link_js_1 = require("./commands/open-link.js");
@@ -48,6 +49,7 @@ const COMMAND_HELP = {
     'foreground-app': foreground_app_js_1.HELP,
     'list-apps': list_apps_js_1.HELP,
     'copy-app': copy_app_js_1.HELP,
+    'install-app': install_app_js_1.HELP,
     'launch-app': launch_app_js_1.HELP,
     'stop-app': stop_app_js_1.HELP,
     'clear-state': clear_state_js_1.HELP,
@@ -223,6 +225,11 @@ async function main() {
             exitCode = await (0, copy_app_js_1.copyApp)(bundleId, from ?? '', to ?? '', opts);
             break;
         }
+        case 'install-app': {
+            const appPath = rest[0] ?? '';
+            exitCode = await (0, install_app_js_1.installApp)(appPath, opts, sessionName);
+            break;
+        }
         case 'launch-app': {
             const appId = rest[0] ?? '';
             // --argument key=value (repeatable) → Record<string, string>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houwert/conductor",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "CLI tool for mobile app interactions — optimized for AI agents",
   "license": "MIT",
   "repository": {

package/skills/conductor/SKILL.md

@@ -90,6 +90,17 @@ Both flags are required. The command reads the `.app` bundle path from the sourc
 
 ---
 
+### `install-app <path>`
+
+Install an app from a local `.app` bundle, `.ipa`, or `.apk` file onto the device.
+
+```bash
+conductor install-app ./build/MyApp.app
+conductor install-app ./build/app-debug.apk --device emulator-5554
+```
+
+---
+
 ### `launch-app <appId>`
 
 Launch an app by bundle ID and save it to the session.