@houwert/conductor 0.3.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,11 +34,14 @@ 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
     --argument key=value                    Set launch argument (repeatable)
   stop-app [<appId>]                        Stop app (uses session appId if omitted)
+  clear-state [<appId>]                     Clear app data/state (uses session appId if omitted)
+  uninstall-app <appId>                     Uninstall app from device
 
 INTERACTIONS
   tap <element>                             Tap element by text

package/dist/commands/clear-state.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.clearState = clearState;
+exports.HELP = `  clear-state [<appId>]                Clear app data/state`;
+const runner_js_1 = require("../runner.js");
+const session_js_1 = require("../session.js");
+const output_js_1 = require("../output.js");
+async function clearState(appId, opts = {}, sessionName = 'default') {
+    const session = await (0, session_js_1.getSession)(sessionName);
+    const resolvedAppId = appId ?? session.appId;
+    if (!resolvedAppId) {
+        (0, output_js_1.printError)('clear-state: no appId provided and no active session. Run launch-app first.', opts);
+        return 1;
+    }
+    const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        await driver.clearAppState(resolvedAppId);
+    }, sessionName);
+    if (result.success) {
+        (0, output_js_1.printSuccess)(`clear-state "${resolvedAppId}" — done`, opts);
+        return 0;
+    }
+    else {
+        (0, output_js_1.printError)(`clear-state "${resolvedAppId}" — failed\n${result.stderr}`, opts);
+        return 1;
+    }
+}

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/commands/list-apps.js

@@ -21,7 +21,7 @@ async function listApps(opts = {}, sessionName = 'default') {
     }
     const platform = await (0, bootstrap_js_1.detectPlatform)(deviceId);
     let appIds;
-    if (platform === 'ios') {
+    if (platform === 'ios' || platform === 'tvos') {
         const result = await (0, runner_js_1.spawnCommand)('bash', [
             '-c',
             `xcrun simctl listapps ${deviceId} | plutil -convert json - -o -`,

package/dist/commands/uninstall-app.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.uninstallApp = uninstallApp;
+exports.HELP = `  uninstall-app <appId>                Uninstall app from device`;
+const runner_js_1 = require("../runner.js");
+const output_js_1 = require("../output.js");
+const ios_js_1 = require("../drivers/ios.js");
+const android_js_1 = require("../drivers/android.js");
+async function uninstallApp(appId, opts = {}, sessionName = 'default') {
+    if (!appId) {
+        (0, output_js_1.printError)('uninstall-app requires <appId>', opts);
+        return 1;
+    }
+    const result = await (0, runner_js_1.runDirect)(async (driver) => {
+        if (driver instanceof ios_js_1.IOSDriver) {
+            await driver.uninstallApp(appId);
+        }
+        else if (driver instanceof android_js_1.AndroidDriver) {
+            await driver.uninstallApp(appId);
+        }
+    }, sessionName);
+    if (result.success) {
+        (0, output_js_1.printSuccess)(`uninstall-app "${appId}" — done`, opts);
+        return 0;
+    }
+    else {
+        (0, output_js_1.printError)(`uninstall-app "${appId}" — failed\n${result.stderr}`, opts);
+        return 1;
+    }
+}

package/dist/drivers/android.js

@@ -208,6 +208,10 @@ class AndroidDriver {
     async clearAppState(packageName) {
         await this.adb(['shell', 'pm', 'clear', packageName]);
     }
+    async uninstallApp(packageName) {
+        await this.adb(['shell', 'am', 'force-stop', packageName]).catch(() => { });
+        await this.adb(['uninstall', packageName]);
+    }
     async clearKeychain() {
         // No-op on Android — keychain is an iOS concept
     }

package/dist/drivers/flow-runner.js

@@ -987,6 +987,21 @@ async function executeCommandBody(key, val, driver, opts) {
             await driver.clearKeychain();
             break;
         }
+        case 'uninstallApp': {
+            const appId = val == null || val === ''
+                ? (opts.appId ??
+                    (() => {
+                        throw new Error('uninstallApp: no appId in command or flow header');
+                    })())
+                : resolveAppId(val, 'uninstallApp');
+            if (driver instanceof ios_js_1.IOSDriver) {
+                await driver.uninstallApp(appId);
+            }
+            else {
+                await driver.uninstallApp(appId);
+            }
+            break;
+        }
         // ── Keys ───────────────────────────────────────────────────────────────
         case 'pressKey': {
             const keyName = val.toUpperCase();

package/dist/drivers/ios.js

@@ -168,6 +168,11 @@ class IOSDriver {
             await promises_1.default.rm(tmpDir, { recursive: true, force: true }).catch(() => { });
         }
     }
+    async uninstallApp(bundleId) {
+        const deviceId = this.requireDeviceId();
+        await this.simctl(['terminate', deviceId, bundleId]).catch(() => { });
+        await this.simctl(['uninstall', deviceId, bundleId]);
+    }
     async clearKeychain() {
         const deviceId = this.requireDeviceId();
         await this.simctl(['keychain', deviceId, 'reset']);

package/dist/index.js

@@ -9,6 +9,8 @@ const verbose_js_1 = require("./verbose.js");
 const list_devices_js_1 = require("./commands/list-devices.js");
 const launch_app_js_1 = require("./commands/launch-app.js");
 const stop_app_js_1 = require("./commands/stop-app.js");
+const clear_state_js_1 = require("./commands/clear-state.js");
+const uninstall_app_js_1 = require("./commands/uninstall-app.js");
 const tap_js_1 = require("./commands/tap.js");
 const type_js_1 = require("./commands/type.js");
 const back_js_1 = require("./commands/back.js");
@@ -30,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");
@@ -46,8 +49,11 @@ 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,
+    'uninstall-app': uninstall_app_js_1.HELP,
     tap: tap_js_1.HELP,
     type: type_js_1.HELP,
     'erase-text': erase_text_js_1.HELP,
@@ -219,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>
@@ -240,6 +251,16 @@ async function main() {
             exitCode = await (0, stop_app_js_1.stopApp)(appId, opts, sessionName);
             break;
         }
+        case 'clear-state': {
+            const appId = rest[0];
+            exitCode = await (0, clear_state_js_1.clearState)(appId, opts, sessionName);
+            break;
+        }
+        case 'uninstall-app': {
+            const appId = rest[0] ?? '';
+            exitCode = await (0, uninstall_app_js_1.uninstallApp)(appId, opts, sessionName);
+            break;
+        }
         case 'tap': {
             const element = rest.join(' ');
             exitCode = await (0, tap_js_1.tap)(element, opts, sessionName, {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@houwert/conductor",
-  "version": "0.3.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.
@@ -124,6 +135,28 @@ conductor stop-app com.example.myapp
 
 ---
 
+### `clear-state [<appId>]`
+
+Clear app data/state without relaunching. Uses the session `appId` if not specified. On iOS this terminates the app, preserves the .app bundle, uninstalls, and reinstalls (clearing all user data). On Android this runs `pm clear`.
+
+```bash
+conductor clear-state
+conductor clear-state com.example.myapp
+```
+
+---
+
+### `uninstall-app <appId>`
+
+Uninstall an app from the device. The app ID is required.
+
+```bash
+conductor uninstall-app com.example.myapp
+conductor uninstall-app com.example.myapp --device emulator-5554
+```
+
+---
+
 ### `tap <element>`
 
 Tap a UI element by its text label or accessibility ID. **Try the most obvious text label or ID first** — e.g. `"Sign In"`, `"Submit"`, `"btn_login"`. Only run `inspect` to look up the exact identifier if your first attempt fails. **For icon-only buttons (no visible text label), always run `inspect` first** to find the accessibility ID before tapping.

package/skills/conductor/references/flow-syntax.md

@@ -26,6 +26,8 @@ appId: com.example.myapp
     appId: com.other.app
 - clearState               # clear app data
 - clearKeychain            # clear keychain (iOS: full keychain; Android: account credentials)
+- uninstallApp             # uninstall app from device
+- uninstallApp: com.other.app  # uninstall a specific app
 ```
 
 ### Tapping