@houwert/conductor 0.2.0 → 0.4.0

package/.claude-plugin/plugin.json

@@ -1,6 +1,9 @@
 {
   "name": "conductor",
+  "version": "0.2.0",
   "description": "CLI for mobile UI testing, designed for AI agents",
   "repository": "https://github.com/houwert/conductor",
-  "author": { "name": "Houwert" }
+  "author": { "name": "Houwert" },
+  "category": "service",
+  "skills": ["conductor"]
 }

package/README.md

@@ -1,39 +1,139 @@
-# Conductor
+<div align="center">
 
-A token-efficient CLI for mobile UI testing, designed for AI agents.
+<img src="assets/banner.png" alt="Conductor" width="800" />
 
-Inspired by [`@playwright/cli`](https://github.com/microsoft/playwright-cli), this is a TypeScript reimplementation and partial fork of [Maestro](https://github.com/mobile-dev-inc/maestro) that talks directly to the bundled native drivers — no external CLI installation required.
+# 🎼 Conductor
 
-## Installation
+**Give Claude hands. Let it drive your app.**
 
-```bash
-pnpm install
-pnpm build
-pnpm link --global
-```
+[![CI](https://github.com/DouweBos/conductor/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/DouweBos/conductor/actions/workflows/ci.yml)
+[![npm version](https://img.shields.io/npm/v/@houwert/conductor)](https://www.npmjs.com/package/@houwert/conductor)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+</div>
+
+---
+
+Conductor is a token-efficient CLI for mobile UI interactions, built for AI agents. It's a TypeScript reimplementation and partial fork of [Maestro](https://maestro.mobile.dev) that bundles its own native drivers — no external CLI, no setup friction, no nonsense.
+
+It started as an experiment: what if Claude could tap through your app while it's writing the code? Turns out that's extremely useful. Now it's a proper tool.
 
-## Quick Start
+## ✨ What it does
+
+Conductor gives Claude Code the ability to interact with iOS simulators and Android emulators directly from a coding session. It can navigate UI, inspect the live hierarchy, take screenshots, run flows, and manage multiple devices in parallel across concurrent agents.
 
 ```bash
-conductor list-devices
 conductor launch-app com.example.myapp
 conductor tap "Sign In"
 conductor type "user@example.com"
+conductor assert-visible "Dashboard"
 conductor screenshot --output /tmp/screen.png
 ```
 
-## Documentation
+One agent writes the feature. Another taps through the app. They talk. It works. 🤝
+
+## 🚀 Quick start
+
+```bash
+npm install -g @houwert/conductor
+```
+
+That's it. The postinstall script registers Conductor as a Claude Code plugin automatically — Claude gains full mobile UI control without any extra steps.
+
+## 🧠 Claude Skills
+
+The plugin registers itself globally in `~/.claude/plugins/` and ships two skill files:
+
+```
+skills/conductor/
+├── SKILL.md               # Full command reference and agent workflow guide
+└── references/
+    └── flow-syntax.md     # Maestro YAML flow syntax reference
+```
+
+Claude learns every available command, how to coordinate across devices, and how to write and run Maestro YAML flows. See [`skills/conductor/SKILL.md`](./skills/conductor/SKILL.md) for the full reference.
+
+### Install modes
+
+| Command | What it does |
+|---|---|
+| `npm install -g @houwert/conductor` | Registers global plugin automatically (via postinstall) |
+| `conductor install` | Re-register or update the global plugin |
+| `conductor install --skills` | Copy skills into `.claude/skills/conductor/` in the current project |
+| `conductor install --check` | Print current install status without modifying anything |
+
+### 📱 What Claude can do
+
+| Capability | Commands |
+|---|---|
+| App lifecycle | `launch-app`, `stop-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` |
+| Navigation | `open-link`, `back` |
+| Flows | `run-flow`, `run-flow-inline`, `run-parallel` |
+| Devices | `start-device`, `list-devices`, `set-location`, `set-orientation` |
+
+## 🔨 Building locally
+
+### Prerequisites
 
-See [`skills/conductor/SKILL.md`](./skills/conductor/SKILL.md) for full command reference.
+- Node.js + pnpm v9
+- **iOS:** Xcode with command-line tools
+- **Android:** Android SDK with `adb` on `PATH`
 
-## Requirements
+### Full build
 
-- Android: `adb` on `PATH` with a running emulator/device
-- iOS: Xcode with a running simulator
+```bash
+make build
+```
+
+Builds the iOS driver (xcodebuild), the Android driver (Gradle), packages both into the CLI, and compiles TypeScript. Then link it globally:
+
+```bash
+cd packages/cli && pnpm link --global
+```
+
+### CLI only
+
+If the drivers are already built and packaged:
+
+```bash
+cd packages/cli
+pnpm install && pnpm build
+```
+
+### Individual targets
+
+```bash
+make build-cli          # CLI TypeScript only
+make build-ios-driver   # iOS XCTest driver
+make build-android-driver # Android instrumentation driver
+make package-cli        # Bundle drivers into CLI package
+make copy-skills        # Copy skills/ into packages/cli/skills/ (build artifact)
+```
+
+## 🗂️ Repository structure
+
+```
+conductor/
+├── packages/
+│   ├── cli/              # TypeScript CLI (@houwert/conductor)
+│   ├── android-driver/   # Kotlin/Gradle instrumentation driver
+│   └── ios-driver/       # Swift/Xcode XCTest driver
+└── Makefile
+```
+
+## 🛠️ Development
+
+```bash
+pnpm dev     # TypeScript watch mode
+pnpm lint    # ESLint + Prettier check
+pnpm lint:fix  # Auto-fix formatting
+pnpm test    # Run test suite
+```
 
-## Architecture
+## 📋 Requirements
 
-- `src/session.ts` — persists `appId` + `deviceId` in `~/.conductor/session.json`
-- `src/runner.ts` — resolves devices, manages driver lifecycle, executes flows natively
-- `src/commands/` — one file per command
-- `src/index.ts` — argument parsing with `minimist`, command dispatch
+- **iOS:** Xcode with a booted simulator
+- **Android:** `adb` on `PATH` with a running emulator or connected device

package/dist/commands/assert-not-visible.js

@@ -1,6 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.assertNotVisible = assertNotVisible;
+exports.HELP = `  assert-not-visible <element>        Assert element is absent from screen
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --timeout <ms>                    Max check time in milliseconds (default: 1000)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/assert-visible.js

@@ -1,6 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.assertVisible = assertVisible;
+exports.HELP = `  assert-visible <element>            Assert element is visible
+    --id <id>                         Match by accessibility id instead of text
+    --text <text>                     Match by text only (not id)
+    --index <n>                       Pick the nth match (0-based)
+    --timeout <ms>                    Max wait time in milliseconds
+    --optional                        Do not fail if element is not found
+    --focused                         Match only focused elements
+    --enabled / --no-enabled          Match by enabled state
+    --checked / --no-checked          Match by checked state
+    --selected / --no-selected        Match by selected state
+    --below <text>                    Match element below the given reference
+    --above <text>                    Match element above the given reference
+    --left-of <text>                  Match element left of the given reference
+    --right-of <text>                 Match element right of the given reference`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/back.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.back = back;
+exports.HELP = `  back                                Press back button`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");
@@ -8,7 +10,10 @@ const android_js_1 = require("../drivers/android.js");
 async function back(opts = {}, sessionName = 'default') {
     const result = await (0, runner_js_1.runDirect)(async (driver) => {
         if (driver instanceof ios_js_1.IOSDriver) {
-            // iOS has no universal "back" concept — this is a no-op (same as maestro IOSDriver.backPress)
+            if (driver.platform === 'tvos') {
+                await driver.pressButton('menu');
+            }
+            // Plain iOS has no universal "back" concept — this is a no-op (same as maestro IOSDriver.backPress)
         }
         else if (driver instanceof android_js_1.AndroidDriver) {
             await driver.back(); // adb shell input keyevent 4

package/dist/commands/cheat-sheet.js

@@ -3,7 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.cheatSheet = cheatSheet;
+exports.HELP = `  cheat-sheet                         Print command reference`;
 const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 async function cheatSheet() {
@@ -37,6 +39,8 @@ APP CONTROL
     --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/copy-app.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.copyApp = copyApp;
+exports.HELP = `  copy-app <bundleId>                 Copy an installed app between iOS simulators
+    --from <id>                       Source device ID
+    --to <id>                         Target device ID`;
+const runner_js_1 = require("../runner.js");
+const output_js_1 = require("../output.js");
+const bootstrap_js_1 = require("../drivers/bootstrap.js");
+async function copyApp(bundleId, from, to, opts = {}) {
+    if (!bundleId) {
+        (0, output_js_1.printError)('Usage: conductor copy-app <bundleId> --from <id> --to <id>', opts);
+        return 1;
+    }
+    if (!from || !to) {
+        (0, output_js_1.printError)('Both --from and --to are required.', opts);
+        return 1;
+    }
+    const [fromPlatform, toPlatform] = await Promise.all([(0, bootstrap_js_1.detectPlatform)(from), (0, bootstrap_js_1.detectPlatform)(to)]);
+    if (fromPlatform !== 'ios') {
+        (0, output_js_1.printError)(`--from device "${from}" is not an iOS simulator. copy-app only supports iOS.`, opts);
+        return 1;
+    }
+    if (toPlatform !== 'ios') {
+        (0, output_js_1.printError)(`--to device "${to}" is not an iOS simulator. copy-app only supports iOS.`, opts);
+        return 1;
+    }
+    // Get the .app bundle path from the source simulator
+    const getPath = await (0, runner_js_1.spawnCommand)('xcrun', [
+        'simctl',
+        'get_app_container',
+        from,
+        bundleId,
+        'app',
+    ]);
+    if (!getPath.success) {
+        (0, output_js_1.printError)(`Failed to get app path from source device: ${getPath.stderr}`, opts);
+        return 1;
+    }
+    const appPath = getPath.stdout.trim();
+    // Install on target simulator
+    const install = await (0, runner_js_1.spawnCommand)('xcrun', ['simctl', 'install', to, appPath]);
+    if (!install.success) {
+        (0, output_js_1.printError)(`Failed to install app on target device: ${install.stderr}`, opts);
+        return 1;
+    }
+    if (opts.json) {
+        (0, output_js_1.printData)({ status: 'ok', bundleId, from, to, appPath }, opts);
+    }
+    else {
+        console.log(`Copied ${bundleId} from ${from} to ${to}`);
+    }
+    return 0;
+}

package/dist/commands/daemon.js

@@ -1,8 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP_DAEMON_STATUS = exports.HELP_DAEMON_STOP = exports.HELP_DAEMON_START = void 0;
 exports.daemonStart = daemonStart;
 exports.daemonStop = daemonStop;
 exports.daemonStatusCmd = daemonStatusCmd;
+exports.HELP_DAEMON_START = `  daemon-start                        Start background daemon (manages driver process)`;
+exports.HELP_DAEMON_STOP = `  daemon-stop [--all]                 Stop background daemon (--all stops every session's daemon)`;
+exports.HELP_DAEMON_STATUS = `  daemon-status                       Show daemon status`;
 const client_js_1 = require("../daemon/client.js");
 const output_js_1 = require("../output.js");
 async function daemonStart(opts = {}, sessionName = 'default') {

package/dist/commands/device-pool.js

@@ -3,7 +3,11 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.devicePool = devicePool;
+exports.HELP = `  device-pool --list                  List all devices and pool status
+  device-pool --acquire               Claim a free device (prints device ID)
+  device-pool --release <id>          Release a device back to the pool`;
 /**
  * device-pool: Manage a pool of available devices for concurrent multi-agent use.
  *

package/dist/commands/erase-text.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.eraseText = eraseText;
+exports.HELP = `  erase-text [n]                      Erase n characters (default: 50)`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/focused.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
+exports.focused = focused;
+exports.HELP = `  focused [--poll [interval_ms]]       Print metadata of the currently focused element
+                                       --poll continuously watches for focus changes (default 500ms)`;
+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");
+const element_resolver_js_1 = require("../drivers/element-resolver.js");
+// XCUIElementType rawValue → human-readable name.
+// Source: XCUIElementType enum in XCTest framework.
+const IOS_ELEMENT_TYPE_NAMES = {
+    0: 'Any',
+    1: 'Other',
+    2: 'Application',
+    3: 'Group',
+    4: 'Window',
+    5: 'Sheet',
+    6: 'Drawer',
+    7: 'Alert',
+    8: 'Dialog',
+    9: 'Button',
+    10: 'RadioButton',
+    11: 'RadioGroup',
+    12: 'CheckBox',
+    13: 'DisclosureTriangle',
+    14: 'PopUpButton',
+    15: 'ComboBox',
+    16: 'MenuButton',
+    17: 'ToolbarButton',
+    18: 'Popover',
+    19: 'Keyboard',
+    20: 'Key',
+    21: 'NavigationBar',
+    22: 'TabBar',
+    23: 'TabGroup',
+    24: 'Toolbar',
+    25: 'StatusBar',
+    26: 'Table',
+    27: 'TableRow',
+    28: 'TableColumn',
+    29: 'Outline',
+    30: 'OutlineRow',
+    31: 'Browser',
+    32: 'CollectionView',
+    33: 'Slider',
+    34: 'PageIndicator',
+    35: 'ProgressIndicator',
+    36: 'ActivityIndicator',
+    37: 'SegmentedControl',
+    38: 'Picker',
+    39: 'PickerWheel',
+    40: 'Switch',
+    41: 'Toggle',
+    42: 'Link',
+    43: 'Image',
+    44: 'Icon',
+    45: 'SearchField',
+    46: 'ScrollView',
+    47: 'ScrollBar',
+    48: 'StaticText',
+    49: 'TextField',
+    50: 'SecureTextField',
+    51: 'DatePicker',
+    52: 'TextView',
+    53: 'Menu',
+    54: 'MenuItem',
+    55: 'MenuBar',
+    56: 'MenuBarItem',
+    57: 'Map',
+    58: 'WebView',
+    59: 'IncrementArrow',
+    60: 'DecrementArrow',
+    61: 'Timeline',
+    62: 'RatingIndicator',
+    63: 'ValueIndicator',
+    64: 'SplitGroup',
+    65: 'Splitter',
+    66: 'RelevanceIndicator',
+    67: 'ColorWell',
+    68: 'HelpTag',
+    69: 'Matte',
+    70: 'DockItem',
+    71: 'Ruler',
+    72: 'RulerMarker',
+    73: 'Grid',
+    74: 'LevelIndicator',
+    75: 'Cell',
+    76: 'LayoutArea',
+    77: 'LayoutItem',
+    78: 'Handle',
+    79: 'Stepper',
+    80: 'Tab',
+    81: 'TouchBar',
+    82: 'StatusItem',
+};
+/** DFS children-first so the deepest focused node wins (matches deepestMatchingIOSElements pattern). */
+function findFocusedIOS(node) {
+    for (const child of node.children ?? []) {
+        const found = findFocusedIOS(child);
+        if (found)
+            return found;
+    }
+    if (node.hasFocus)
+        return node;
+    return null;
+}
+function formatIOSElement(node) {
+    const { X, Y, Width, Height } = node.frame;
+    return {
+        text: node.label || node.title || node.value || node.placeholderValue || '',
+        identifier: node.identifier || '',
+        label: node.label,
+        title: node.title ?? null,
+        value: node.value ?? null,
+        placeholderValue: node.placeholderValue ?? null,
+        elementType: node.elementType,
+        elementTypeName: IOS_ELEMENT_TYPE_NAMES[node.elementType] ?? `Unknown(${node.elementType})`,
+        enabled: node.enabled,
+        selected: node.selected,
+        hasFocus: node.hasFocus,
+        bounds: {
+            x: Math.round(X),
+            y: Math.round(Y),
+            width: Math.round(Width),
+            height: Math.round(Height),
+        },
+        center: {
+            x: Math.round(X + Width / 2),
+            y: Math.round(Y + Height / 2),
+        },
+    };
+}
+function formatAndroidNode(node) {
+    const { x1, y1, x2, y2 } = node.bounds;
+    return {
+        text: node.text,
+        resourceId: node.resourceId,
+        contentDesc: node.contentDesc,
+        className: node.className,
+        packageName: node.packageName,
+        hintText: node.hintText || null,
+        error: node.error || null,
+        clickable: node.clickable,
+        enabled: node.enabled,
+        checked: node.checked,
+        focused: node.focused,
+        focusable: node.focusable,
+        selected: node.selected,
+        checkable: node.checkable,
+        longClickable: node.longClickable,
+        scrollable: node.scrollable,
+        password: node.password,
+        visibleToUser: node.visibleToUser,
+        bounds: { x1, y1, x2, y2 },
+        center: {
+            x: Math.round((x1 + x2) / 2),
+            y: Math.round((y1 + y2) / 2),
+        },
+    };
+}
+async function queryFocused(driver) {
+    if (driver instanceof ios_js_1.IOSDriver) {
+        const hierarchy = await driver.viewHierarchy(false);
+        const node = findFocusedIOS(hierarchy.axElement);
+        return node ? formatIOSElement(node) : null;
+    }
+    else if (driver instanceof android_js_1.AndroidDriver) {
+        const xml = await driver.viewHierarchy();
+        const nodes = (0, element_resolver_js_1.parseAndroidHierarchy)(xml);
+        const node = nodes.find((n) => n.focused);
+        return node ? formatAndroidNode(node) : null;
+    }
+    throw new Error('Unknown driver type');
+}
+async function focused(opts = {}, sessionName = 'default', { poll = false, interval = 500 } = {}) {
+    try {
+        const driver = await (0, runner_js_1.getDriver)(sessionName);
+        if (!poll) {
+            const data = await queryFocused(driver);
+            if (!data) {
+                if (opts.json) {
+                    console.log(JSON.stringify({ status: 'ok', focused: null }));
+                }
+                else {
+                    console.log('No element is currently focused');
+                }
+                return 0;
+            }
+            if (opts.json) {
+                console.log(JSON.stringify({ status: 'ok', focused: data }));
+            }
+            else {
+                console.log(JSON.stringify(data, null, 2));
+            }
+            return 0;
+        }
+        // --poll mode: repeatedly query and log on change
+        let lastJson = '';
+        const onSignal = () => process.exit(0);
+        process.on('SIGINT', onSignal);
+        process.on('SIGTERM', onSignal);
+        while (true) {
+            const data = await queryFocused(driver);
+            const currentJson = JSON.stringify(data);
+            if (currentJson !== lastJson) {
+                lastJson = currentJson;
+                if (!data) {
+                    if (opts.json) {
+                        console.log(JSON.stringify({ status: 'ok', focused: null }));
+                    }
+                    else {
+                        console.log('No element is currently focused');
+                    }
+                }
+                else if (opts.json) {
+                    console.log(JSON.stringify({ status: 'ok', focused: data }));
+                }
+                else {
+                    console.log(JSON.stringify(data, null, 2));
+                }
+            }
+            await new Promise((r) => setTimeout(r, interval));
+        }
+    }
+    catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        (0, output_js_1.printError)(`focused — failed\n${msg}`, opts);
+        return 1;
+    }
+}

package/dist/commands/foreground-app.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.foregroundApp = foregroundApp;
+exports.HELP = `  foreground-app                      Print bundle ID / package of the foreground app`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/hide-keyboard.js

@@ -1,6 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.hideKeyboard = hideKeyboard;
+exports.HELP = `  hide-keyboard                       Dismiss the on-screen keyboard`;
 const runner_js_1 = require("../runner.js");
 const output_js_1 = require("../output.js");
 const ios_js_1 = require("../drivers/ios.js");

package/dist/commands/inspect.js

@@ -1,14 +1,36 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.HELP = void 0;
 exports.inspect = inspect;
+exports.HELP = `  inspect [--dump]                     Print UI hierarchy (--dump for raw driver output)`;
 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");
 const element_resolver_js_1 = require("../drivers/element-resolver.js");
-async function inspect(opts = {}, sessionName = 'default') {
+async function inspect(opts = {}, sessionName = 'default', inspectOpts = {}) {
     try {
         const driver = await (0, runner_js_1.getDriver)(sessionName);
+        if (inspectOpts.dump) {
+            let raw;
+            if (driver instanceof ios_js_1.IOSDriver) {
+                const hierarchy = await driver.viewHierarchy(false);
+                raw = JSON.stringify(hierarchy, null, 2);
+            }
+            else if (driver instanceof android_js_1.AndroidDriver) {
+                raw = await driver.viewHierarchy();
+            }
+            else {
+                throw new Error('Unknown driver type');
+            }
+            if (opts.json) {
+                console.log(JSON.stringify({ status: 'ok', dump: raw }));
+            }
+            else {
+                console.log(raw);
+            }
+            return 0;
+        }
         let text;
         if (driver instanceof ios_js_1.IOSDriver) {
             const hierarchy = await driver.viewHierarchy(false);