@houwert/conductor 0.2.0 → 0.4.0

package/skills/conductor/SKILL.md

@@ -1,3 +1,13 @@
+---
+name: conductor
+version: 0.2.0
+description: "Token-efficient CLI for mobile UI testing (iOS simulator + Android emulator), designed for AI agents"
+metadata.openclaw:
+  category: service
+  requires:
+    bins: [conductor]
+---
+
 # conductor
 
 A token-efficient CLI for Conductor mobile UI testing, designed for AI agents.
@@ -10,6 +20,7 @@ conductor <command> [args] [options]
 
 Global options:
 - `--device <id>` — target device ID; also keys the session and daemon (auto-detected if omitted)
+- `--device-name <name>` — target a booted device by its human-readable name (resolved to ID from booted devices); mutually exclusive with `--device`
 - `--help` — show help
 - `--json` — machine-readable JSON output (avoid unless you need structured parsing)
 - `--verbose / -v` — log daemon calls, driver fallbacks, and raw output
@@ -20,7 +31,7 @@ Global options:
 
 ### `list-devices`
 
-List connected Android emulators and iOS simulators.
+List connected Android emulators and iOS simulators. Shows both booted (running) devices and available (shutdown) simulators/emulators that can be started with `start-device`.
 
 ```bash
 conductor list-devices
@@ -28,10 +39,17 @@ conductor list-devices
 
 Output:
 ```
-android    device     emulator-5554  Pixel_6_API_33
-ios        booted     ABC123-DEF456  iPhone 15
+Booted devices:
+  android  device     emulator-5554  Pixel_6_API_33
+  ios      booted     ABC123-DEF456  iPhone 15
+
+Available devices:
+  ios      shutdown   DEF789-ABC012  iPhone 16 Pro
+  android  available  Pixel_7_API_34  Pixel_7_API_34
 ```
 
+Exits with code 0 if any booted or available devices exist, 1 only if both lists are empty.
+
 ---
 
 ### `foreground-app`
@@ -56,6 +74,22 @@ conductor list-apps --device emulator-5554
 
 ---
 
+### `copy-app <bundleId>`
+
+Copy an installed app from one iOS simulator to another. Useful when you have a compiled `.app` bundle on one simulator and want to install it on others without recompiling.
+
+```bash
+conductor copy-app com.example.myapp --from C59D3241-FB6A-4E3B-AE7B-A82D3C933889 --to 86B1BC33-7D83-47FF-AAFE-1BD70FC53038
+```
+
+Flags:
+- `--from <id>` — source device ID (must be an iOS simulator)
+- `--to <id>` — target device ID (must be an iOS simulator)
+
+Both flags are required. The command reads the `.app` bundle path from the source simulator and installs it on the target.
+
+---
+
 ### `launch-app <appId>`
 
 Launch an app by bundle ID and save it to the session.
@@ -90,6 +124,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.
@@ -159,9 +215,9 @@ conductor back
 
 ### `press-key <key>`
 
-Press a hardware or keyboard key. Valid keys: `Enter`, `Backspace`, `Home`, `End`, `Tab`, `Delete`, `Escape`, `VolumeUp`, `VolumeDown`, `Power`, `Lock`, `Back`, `Camera`, `Search`.
+Press a hardware or keyboard key. Valid keys: `Enter`, `Backspace`, `Home`, `End`, `Tab`, `Delete`, `Escape`, `VolumeUp`, `VolumeDown`, `Power`, `Lock`, `Back`, `Camera`, `Search`, `Remote Dpad Up`, `Remote Dpad Down`, `Remote Dpad Left`, `Remote Dpad Right`, `Remote Dpad Center`.
 
-Not all keys are supported on all platforms — unsupported keys are silently ignored (e.g. `Back` on iOS).
+Not all keys are supported on all platforms — unsupported keys are silently ignored (e.g. `Back` on iOS). The `Remote Dpad *` keys are Android TV only.
 
 ```bash
 conductor press-key Enter
@@ -659,6 +715,8 @@ Boot an iOS simulator or Android emulator. Creates the Simulator window and wait
 conductor start-device --platform ios
 conductor start-device --platform android
 conductor start-device --platform ios --os-version 18
+conductor start-device --platform ios --device-type "iPhone 16 Pro"
+conductor start-device --platform ios --name "Test Device"
 conductor start-device --platform android --avd Pixel_6_API_33
 ```
 
@@ -666,8 +724,10 @@ Flags:
 - `--platform <ios|android>` — required
 - `--os-version <n>` — filter by OS version (iOS: e.g. `18`; Android: API level e.g. `33`)
 - `--avd <name>` — Android AVD name to launch (default: first available AVD)
+- `--name <name>` — set a custom name on the simulator after boot (iOS only)
+- `--device-type <name>` — iOS device type to boot (e.g. `"iPhone 16 Pro"`); if no existing simulator matches, one is created automatically
 
-iOS picks the first available iPhone simulator matching the OS version filter (or any if unfiltered). Android launches the named AVD, or the first AVD found.
+iOS picks the first available iPhone simulator matching the OS version and device type filters (or any if unfiltered). Android launches the named AVD, or the first AVD found.
 
 ---
 

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
@@ -51,6 +53,7 @@ appId: com.example.myapp
 - pressKey: Enter
 - pressKey: Backspace
 - pressKey: Home
+- pressKey: Remote Dpad Down  # Android TV only; also Up, Left, Right, Center, Remote Media Play Pause, Remote Media Stop, Remote Media Next, Remote Media Previous, Remote Media Rewind, Remote Media Fast Forward, Remote System Navigation Up, Remote System Navigation Down, Remote Button A, Remote Button B, Remote Menu, TV Input, TV Input HDMI 1/2/3
 - pasteText: "pasted content" # paste text into focused field
 - copyTextFrom: "Element"     # copy element's text to output.textContent
 ```

package/skills/skills.yaml

@@ -0,0 +1,8 @@
+skills:
+  - name: conductor
+    path: conductor/SKILL.md
+    description: "Token-efficient CLI for mobile UI testing, designed for AI agents"
+    category: service
+    version: 0.2.0
+    requires:
+      bins: [conductor]