@limrun/cli 0.2.9 → 0.3.1

package/README.md

@@ -35,11 +35,11 @@ The CLI stores configuration in `~/.lim/config.yaml`. This file is compatible wi
 
 Every command supports these flags:
 
-| Flag | Description |
-|------|-------------|
-| `--api-key <value>` | API key (also reads `LIM_API_KEY` env var) |
-| `--json` | Output as JSON instead of human-readable tables |
-| `--help` | Show help for any command |
+| Flag                | Description                                     |
+| ------------------- | ----------------------------------------------- |
+| `--api-key <value>` | API key (also reads `LIM_API_KEY` env var)      |
+| `--json`            | Output as JSON instead of human-readable tables |
+| `--help`            | Show help for any command                       |
 
 ## Command Structure
 
@@ -67,14 +67,16 @@ You can always provide an ID explicitly to target a specific instance:
 lim ios screenshot -o test.png --id ios_def456
 ```
 
-**Top-level shortcuts** are available for common actions — the platform is auto-detected from the instance ID prefix:
+For repeatable scripts and LLM agents, prefer explicit platform commands plus an explicit `--id` once you have it:
 
 ```bash
-lim screenshot --id ios_abc123   # Works for both iOS and Android
-lim tap 100 200 --id ios_abc123  # Auto-detects platform from ID prefix
-lim delete ios_abc123       # Auto-detects resource type from ID prefix
+lim ios get ios_abc123 --json
+lim ios screenshot --id ios_abc123 -o screenshot.png
+lim android tap --id android_abc123 100 200
 ```
 
+This avoids relying on locally cached "last created" state and keeps the target platform explicit.
+
 ## Commands
 
 - [iOS](#ios) — Create, manage, and interact with iOS instances
@@ -93,6 +95,7 @@ lim ios create          # Create a new iOS instance
 lim ios list            # List all ready iOS instances
 lim ios get <ID>        # Get details of a specific instance
 lim ios delete <ID>     # Delete an instance
+lim ios info            # Get device info from a running instance
 ```
 
 #### Create Options
@@ -116,19 +119,19 @@ lim ios create --region us-west --display-name "CI Test" --label env=ci --rm
 
 **Flags for `ios create`:**
 
-| Flag | Description |
-|------|-------------|
-| `--rm` | Auto-delete the instance on exit (Ctrl+C) |
-| `--model <iphone\|ipad\|watch>` | Simulator device model |
-| `--xcode` | Attach a Xcode build sandbox to the iOS instance |
-| `--region <value>` | Region for the instance (e.g. `us-west`) |
-| `--display-name <value>` | Human-readable name |
-| `--label <key=value>` | Labels (repeatable). Used for filtering and reuse |
-| `--hard-timeout <duration>` | Max lifetime (e.g. `1m`, `10m`, `3h`). Default: none |
-| `--inactivity-timeout <duration>` | Idle timeout. Default: `3m` |
-| `--reuse-if-exists` | Reuse an existing instance with matching labels/region |
-| `--install <file>` | Local file to install (auto-uploads, repeatable) |
-| `--install-asset <name>` | Asset name to install (repeatable) |
+| Flag                              | Description                                            |
+| --------------------------------- | ------------------------------------------------------ |
+| `--rm`                            | Auto-delete the instance on exit (Ctrl+C)              |
+| `--model <iphone\|ipad\|watch>`   | Simulator device model                                 |
+| `--xcode`                         | Attach a Xcode build sandbox to the iOS instance       |
+| `--region <value>`                | Region for the instance (e.g. `us-west`)               |
+| `--display-name <value>`          | Human-readable name                                    |
+| `--label <key=value>`             | Labels (repeatable). Used for filtering and reuse      |
+| `--hard-timeout <duration>`       | Max lifetime (e.g. `1m`, `10m`, `3h`). Default: none   |
+| `--inactivity-timeout <duration>` | Idle timeout. Default: `3m`                            |
+| `--reuse-if-exists`               | Reuse an existing instance with matching labels/region |
+| `--install <file>`                | Local file to install (auto-uploads, repeatable)       |
+| `--install-asset <name>`          | Asset name to install (repeatable)                     |
 
 #### List and Filter
 
@@ -147,6 +150,10 @@ lim ios get <ID>                               # Single instance details
 All interaction commands accept an optional `--id`. When omitted, the last created iOS instance is used.
 
 ```bash
+# Device info
+lim ios info
+lim ios info --json
+
 # Screenshots
 lim ios screenshot -o screenshot.png
 lim ios screenshot                      # Output base64 to stdout
@@ -158,13 +165,25 @@ lim ios tap-element --accessibility-id btn_ok
 
 # Text input
 lim ios type "Hello World"
-lim ios type "search query" --press-enter
+lim ios type "search query" --enter
 lim ios press-key enter
 lim ios press-key a --modifier shift
 
 # Scrolling
 lim ios scroll down --amount 500
 
+# Batch multiple actions in one call
+lim ios perform --action type=tap,x=100,y=200 --action 'type=typeText,text=Hello World'
+lim ios perform --action type=wait,durationMs=500 --action type=pressKey,key=enter
+lim ios perform --file ./actions.yaml
+
+# actions.yaml
+- type: tap
+  x: 100
+  y: 200
+- type: typeText
+  text: "Hello World"
+
 # UI inspection
 lim ios element-tree
 lim ios element-tree | jq '.'
@@ -210,12 +229,14 @@ lim ios record stop -o recording.mp4
 lim ios record stop --presigned-url https://example.com/upload
 ```
 
-#### Xcode Integration
+#### Built App Sync (iOS only)
 
 ```bash
-# Sync/build use the current directory if no path is provided; pass instance IDs with --id (requires --xcode on create)
-lim ios sync ./MyProject
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
+# Sync a built .app bundle to the current iOS instance
+lim ios sync ./Build/Products/Debug-iphonesimulator/MyApp.app
+
+# Re-sync on changes and relaunch if the app is already running
+lim ios sync ./MyApp.app --watch --launch-mode RelaunchIfRunning
 ```
 
 ---
@@ -232,14 +253,14 @@ lim android delete <ID>  # Delete an instance
 #### Create Options
 
 ```bash
-# Basic (with ADB tunnel and scrcpy streaming)
+# Basic (prints a Console URL you can open in the browser)
 lim android create
 
 # With apps pre-installed
 lim android create --install ./my-app.apk --install ./another.apk
 
-# Without streaming
-lim android create --no-stream
+# Create without opening an ADB tunnel
+lim android create --no-connect
 
 # Full options
 lim android create --region us-west --display-name "CI Test" --label env=ci --rm
@@ -247,11 +268,12 @@ lim android create --region us-west --display-name "CI Test" --label env=ci --rm
 
 **Android-specific flags:**
 
-| Flag | Description |
-|------|-------------|
-| `--[no-]connect` | Start ADB tunnel (default: true) |
-| `--[no-]stream` | Launch scrcpy for visual control (default: true) |
-| `--adb-path <path>` | Path to `adb` binary (default: `adb`) |
+| Flag                | Description                                      |
+| ------------------- | ------------------------------------------------ |
+| `--[no-]connect`    | Start an ADB tunnel immediately (default: true)  |
+| `--adb-path <path>` | Path to `adb` binary (default: `adb`)            |
+
+`lim android create` always prints a Console URL such as `https://console.limrun.com/stream/android_...` that you can open in the browser for live viewing. For automation, `--no-connect` is usually the safest default.
 
 #### Device Interaction
 
@@ -317,12 +339,11 @@ lim xcode delete <ID>     # Delete an instance
 # Create with options
 lim xcode create --rm --region us-west --hard-timeout 1h
 
-# Sync and build
-lim xcode sync ./MyProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace
+# Build (automatically syncs the project path first)
+lim xcode build ./MyProject --scheme MyApp --workspace MyApp.xcworkspace
 
 # Build and upload artifact
-lim xcode build --scheme MyApp --upload my-app-build
+lim xcode build ./MyProject --scheme MyApp --upload my-app-build
 ```
 
 ---
@@ -338,8 +359,9 @@ lim asset push ./my-app.ipa -n custom-name
 
 # Download a file
 lim asset pull asset_abc123
-lim asset pull my-app.apk
 lim asset pull asset_abc123 -o ./downloads
+lim asset list --name my-app.apk --json
+lim asset pull asset_abc123
 
 # List assets
 lim asset list
@@ -407,11 +429,12 @@ lim session stop --id ios_abc123
 lim session stop --all
 ```
 
-If only one session is active, `lim session stop` (no ID) stops it automatically.
+If only one session is active, `lim session stop` (no ID) stops it automatically. For scripts and agents, prefer `--id` explicitly so the target instance is unambiguous.
 
 #### How It Works
 
 Each `lim session start` spawns an independent background daemon that:
+
 - Holds a persistent WebSocket connection to that specific instance
 - Listens on its own Unix socket at `/tmp/lim-sessions/<instance-id>/`
 - All interaction commands automatically detect the matching session and route through it
@@ -482,7 +505,7 @@ done
 # Tear down
 lim session stop --all
 for ID in "${IDS[@]}"; do
-  lim delete $ID
+  lim ios delete $ID
 done
 ```
 
@@ -504,26 +527,23 @@ lim ios create --xcode
 #   Xcode Sandbox: https://...limrun.net/v1/sandbox_.../xcode
 #   (sandbox URL is cached locally for sync/build to use)
 
-# 2. Sync your project code to the Xcode sandbox
-lim ios sync ./MyProject
+# 2. Build — automatically syncs your project code first, then auto-installs on the simulator
+lim xcode build ./MyProject --id ios_abc123 --scheme MyApp --workspace MyApp.xcworkspace
 
-# 3. Build — the app is auto-installed on the simulator
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
-
-# 4. Start a session for fast device interaction
+# 3. Start a session for fast device interaction
 lim session start
 
-# 5. Test the built app on the simulator (~50ms per command)
+# 4. Test the built app on the simulator (~50ms per command)
 lim ios launch-app com.example.myapp
 lim ios element-tree | jq '.'
 lim ios screenshot -o built-app.png
 
-# 6. Clean up
+# 5. Clean up
 lim session stop
 lim ios delete ios_abc123
 ```
 
-> **Note:** The Xcode sandbox URL is only returned when the instance is created — not on subsequent `list` calls. The CLI caches it locally at `~/.lim/instances/` so that `sync` and `build` can find it. This means `sync`/`build` must run on the same machine where `ios create --xcode` was executed.
+> **Note:** `lim xcode build` already syncs the project path you pass before invoking `xcodebuild`, so you do not need to call `lim xcode sync` first. The Xcode sandbox URL is only returned when the instance is created — not on subsequent `list` calls. The CLI caches it locally at `~/.lim/instances/` so that build workflows can find it. This means `build` must run on the same machine where `ios create --xcode` was executed.
 
 #### Option B: Standalone Xcode Instance
 
@@ -533,37 +553,19 @@ Use this when you only need to build (no simulator needed), or when you want to
 # 1. Create a standalone Xcode instance
 lim xcode create --rm
 
-# 2. Sync and build
-lim xcode sync ./MyProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace
+# 2. Build (automatically syncs the project path first)
+lim xcode build ./MyProject --scheme MyApp --workspace MyApp.xcworkspace
 
 # 3. Upload build artifact
-lim xcode build --scheme MyApp --upload my-app-build
+lim xcode build ./MyProject --scheme MyApp --upload my-app-build
 
 # 4. Download the artifact
 lim asset pull my-app-build -o ./build-output
 ```
 
-#### Sync Options
-
-```bash
-# Sync the current directory
-lim ios sync
-
-# Watch mode (re-syncs on file changes)
-lim ios sync ./MyProject --watch
-
-# One-shot sync (default)
-lim ios sync ./MyProject
+#### Build Behavior
 
-# Explicitly disable watch mode
-lim ios sync ./MyProject --no-watch
-
-# Sync without installing
-lim ios sync ./MyProject --no-install
-```
-
-The sync automatically ignores build artifacts (`build/`, `DerivedData/`, `.build/`), dependency folders (`Pods/`, `Carthage/Build/`, `.swiftpm/`), and user-specific files (`xcuserdata/`, `.dSYM/`).
+`lim xcode build [PATH]` automatically performs a one-shot code sync for the given project path before invoking `xcodebuild`. The sync step automatically ignores build artifacts (`build/`, `DerivedData/`, `.build/`), dependency folders (`Pods/`, `Carthage/Build/`, `.swiftpm/`), and user-specific files (`xcuserdata/`, `.dSYM/`).
 
 ---
 
@@ -577,10 +579,10 @@ The CLI reads configuration from multiple sources (in order of precedence):
 
 **Config file keys:**
 
-| Key | Default | Description |
-|-----|---------|-------------|
-| `api-key` | — | Your Limrun API key |
-| `api-endpoint` | `https://api.limrun.com` | API base URL |
+| Key                | Default                      | Description             |
+| ------------------ | ---------------------------- | ----------------------- |
+| `api-key`          | —                            | Your Limrun API key     |
+| `api-endpoint`     | `https://api.limrun.com`     | API base URL            |
 | `console-endpoint` | `https://console.limrun.com` | Console URL (for login) |
 
 ---
@@ -598,8 +600,8 @@ lim android list --json | jq '.[].metadata.id'
 
 # Use in scripts
 INSTANCE_ID=$(lim ios create --json | jq -r '.metadata.id')
-lim ios screenshot -o test.png
-lim delete $INSTANCE_ID
+lim ios screenshot --id $INSTANCE_ID -o test.png
+lim ios delete $INSTANCE_ID
 ```
 
 ---
@@ -621,7 +623,7 @@ lim ios screenshot -o test-result.png
 
 # Clean up
 lim session stop
-lim delete ios_abc123
+lim ios delete ios_abc123
 ```
 
 ### AI Agent Automation
@@ -646,7 +648,7 @@ lim ios log com.example.myapp --lines 20
 
 # Clean up
 lim session stop
-lim delete $ID
+lim ios delete $ID
 ```
 
 ### Remote Build + Test on iOS Simulator
@@ -655,9 +657,8 @@ lim delete $ID
 # Single instance: Xcode sandbox + iOS simulator
 ID=$(lim ios create --xcode --json | jq -r '.metadata.id')
 
-# Sync, build, and test
-lim ios sync ./MyiOSProject
-lim ios build --scheme MyApp --workspace MyApp.xcworkspace
+# Build and test (build automatically syncs the project path first)
+lim xcode build ./MyiOSProject --id $ID --scheme MyApp --workspace MyApp.xcworkspace
 
 # Verify the built app on the simulator
 lim session start
@@ -667,7 +668,7 @@ lim ios element-tree | grep "Welcome"
 lim ios screenshot -o test-result.png
 lim session stop
 
-lim delete $ID
+lim ios delete $ID
 ```
 
 ### Build-Only with Artifact Upload
@@ -675,9 +676,9 @@ lim delete $ID
 ```bash
 lim xcode create --rm --reuse-if-exists --label project=myapp
 
-lim xcode sync ./MyiOSProject
-lim xcode build --scheme MyApp --workspace MyApp.xcworkspace --upload myapp-latest
-lim asset pull myapp-latest -o ./build-output
+lim xcode build ./MyiOSProject --scheme MyApp --workspace MyApp.xcworkspace --upload myapp-latest
+lim asset list --name myapp-latest --json
+lim asset pull asset_abc123 -o ./build-output
 ```
 
 ---

package/bin/run.js

@@ -1,8 +1,63 @@
 #!/usr/bin/env node
 
-const oclif = require('@oclif/core');
+const { flush } = require('@oclif/core');
+const { Config } = require('@oclif/core/config');
+const { handle } = require('@oclif/core/errors');
+const { Help, standardizeIDFromArgv } = require('@oclif/core/help');
+const { run } = require('@oclif/core/run');
 
-oclif
-  .execute({ dir: __dirname, args: process.argv.slice(2) })
-  .then(oclif.flush)
-  .catch(oclif.Errors.handle);
+function isUsageError(error) {
+  return typeof error?.message === 'string' && error.message.includes('\nSee more help with --help');
+}
+
+async function inferCommandArgv(argv) {
+  const config = await Config.load(__dirname);
+  const normalizedArgv = standardizeIDFromArgv([...argv], config);
+  const normalizedCommandId = normalizedArgv[0];
+
+  if (normalizedCommandId && config.findCommand(normalizedCommandId)) {
+    return { commandArgv: normalizedCommandId.split(':'), config };
+  }
+
+  const positionalPrefix = [];
+  for (const token of argv) {
+    if (token === '--' || token.startsWith('-')) break;
+    positionalPrefix.push(token);
+  }
+
+  for (let i = positionalPrefix.length; i > 0; i -= 1) {
+    const commandId = positionalPrefix.slice(0, i).join(':');
+    if (config.findCommand(commandId)) {
+      return { commandArgv: commandId.split(':'), config };
+    }
+  }
+
+  return { commandArgv: undefined, config };
+}
+
+async function handleError(error) {
+  if (!isUsageError(error)) {
+    await handle(error);
+    return;
+  }
+
+  error.message = error.message.replace(/\nSee more help with --help$/, '');
+
+  const { commandArgv, config } = await inferCommandArgv(process.argv.slice(2));
+  if (!commandArgv) {
+    await handle(error);
+    return;
+  }
+
+  console.error(typeof error.render === 'function' ? error.render() : error.message);
+  console.error();
+
+  const help = new Help(config, {
+    ...(config.pjson.oclif.helpOptions ?? config.pjson.helpOptions),
+    sendToStderr: true,
+  });
+  await help.showHelp(commandArgv);
+  process.exitCode = error.oclif?.exit ?? 1;
+}
+
+run(process.argv.slice(2), __dirname).catch(handleError).finally(flush);

package/dist/base-command.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,MAA+B,MAAM,aAAa,CAAC;AAO1D,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;MASd;IAEF,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,SAAS,KAAK,MAAM,IAAI,MAAM,CAc7B;IAED,OAAO,CAAC,YAAY,CAAC,CAA0B;IAE/C,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/D;IAED,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAI9C,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB7D,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAgBhE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKtD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAO5D"}
+{"version":3,"file":"base-command.d.ts","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAS,MAAM,aAAa,CAAC;AAC7C,OAAO,MAA+B,MAAM,aAAa,CAAC;AAO1D,8BAAsB,WAAY,SAAQ,OAAO;IAC/C,MAAM,CAAC,SAAS;;;MAWd;IAEF,OAAO,CAAC,OAAO,CAAC,CAAS;IAEzB,SAAS,KAAK,MAAM,IAAI,MAAM,CAc7B;IAED,OAAO,CAAC,YAAY,CAAC,CAA0B;IAE/C,SAAS,KAAK,WAAW,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAE/D;IAED,SAAS,CAAC,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;cAI9C,QAAQ,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAiB7D,SAAS,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,IAAI;IAgBhE,SAAS,CAAC,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,IAAI;IAIzC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM;IAKtD;;;OAGG;IACH,SAAS,CAAC,SAAS,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM;CAO5D"}

package/dist/base-command.js

@@ -115,11 +115,11 @@ class BaseCommand extends core_1.Command {
 exports.BaseCommand = BaseCommand;
 BaseCommand.baseFlags = {
     'api-key': core_1.Flags.string({
-        description: 'API key for authentication',
+        description: 'API key to use for this command. Overrides the saved login and can also be provided via LIM_API_KEY.',
         env: 'LIM_API_KEY',
     }),
     json: core_1.Flags.boolean({
-        description: 'Output as JSON',
+        description: 'Output structured JSON instead of human-readable tables or plain text when the command supports it.',
         default: false,
     }),
 };

package/dist/base-command.js.map

@@ -1 +1 @@
-{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"base-command.js","sourceRoot":"","sources":["../src/base-command.ts"],"names":[],"mappings":"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"}

package/dist/commands/android/connect.d.ts

@@ -1,7 +1,7 @@
 import { BaseCommand } from '../../base-command';
 export default class AndroidConnect extends BaseCommand {
     static summary: string;
-    static aliases: string[];
+    static description: string;
     static examples: string[];
     static args: {};
     static flags: {

package/dist/commands/android/connect.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/commands/android/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAC,OAAO,SAA4D;IAC1E,MAAM,CAAC,OAAO,WAAuB;IACrC,MAAM,CAAC,QAAQ,WAAwF;IAEvG,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,KAAK;;;;;MAIV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC3B"}
+{"version":3,"file":"connect.d.ts","sourceRoot":"","sources":["../../../src/commands/android/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD,MAAM,CAAC,OAAO,OAAO,cAAe,SAAQ,WAAW;IACrD,MAAM,CAAC,OAAO,SAA4D;IAC1E,MAAM,CAAC,WAAW,SACmN;IACrO,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,IAAI,KAAM;IAEjB,MAAM,CAAC,KAAK;;;;;MAUV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAoC3B"}

package/dist/commands/android/connect.js

@@ -69,13 +69,22 @@ class AndroidConnect extends base_command_1.BaseCommand {
     }
 }
 AndroidConnect.summary = 'Connect to an existing Android instance via ADB tunnel';
-AndroidConnect.aliases = ['connect android'];
-AndroidConnect.examples = ['<%= config.bin %> android connect', '<%= config.bin %> android connect --id <ID>'];
+AndroidConnect.description = 'Open a long-lived ADB tunnel to a running Android instance so local tools can talk to it as if it were attached over USB. The command stays running until you stop it. For scripts and agents, prefer passing `--id` explicitly.';
+AndroidConnect.examples = [
+    '<%= config.bin %> android connect',
+    '<%= config.bin %> android connect --id <ID>',
+    '<%= config.bin %> android connect --id android_abc123 --adb-path /opt/homebrew/bin/adb',
+];
 AndroidConnect.args = {};
 AndroidConnect.flags = {
     ...base_command_1.BaseCommand.baseFlags,
-    id: core_1.Flags.string({ description: 'Android instance ID (defaults to last created)' }),
-    'adb-path': core_1.Flags.string({ description: 'Path to adb binary', default: 'adb' }),
+    id: core_1.Flags.string({
+        description: 'Android instance ID to connect to. Defaults to the last created Android instance, but `--id` is recommended for scripts and agents.',
+    }),
+    'adb-path': core_1.Flags.string({
+        description: 'Path to the adb binary available on your machine',
+        default: 'adb',
+    }),
 };
 exports.default = AndroidConnect;
 //# sourceMappingURL=connect.js.map

package/dist/commands/android/connect.js.map

@@ -1 +1 @@
-{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/android/connect.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sCAAoC;AACpC,qDAAiD;AAEjD,MAAqB,cAAe,SAAQ,0BAAW;IAarD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,wCAAwC,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;YAC7D,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;gBAChD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;gBAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe;gBACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;aAC7B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,cAAc,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YAElD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,GAAG,EAAE;oBACpB,aAAa,CAAC,SAAS,CAAC,CAAC;oBACzB,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;oBAC/B,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,cAAc,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;;AA/CM,sBAAO,GAAG,wDAAwD,CAAC;AACnE,sBAAO,GAAG,CAAC,iBAAiB,CAAC,CAAC;AAC9B,uBAAQ,GAAG,CAAC,mCAAmC,EAAE,6CAA6C,CAAC,CAAC;AAEhG,mBAAI,GAAG,EAAE,CAAC;AAEV,oBAAK,GAAG;IACb,GAAG,0BAAW,CAAC,SAAS;IACxB,EAAE,EAAE,YAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,gDAAgD,EAAE,CAAC;IACnF,UAAU,EAAE,YAAK,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,oBAAoB,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;CAChF,CAAC;kBAXiB,cAAc"}
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../../../src/commands/android/connect.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,sCAAoC;AACpC,qDAAiD;AAEjD,MAAqB,cAAe,SAAQ,0BAAW;IAwBrD,KAAK,CAAC,GAAG;QACP,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;QAE3B,MAAM,IAAI,CAAC,QAAQ,CAAC,KAAK,IAAI,EAAE;YAC7B,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,gBAAgB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAC5D,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBAC5B,IAAI,CAAC,KAAK,CAAC,YAAY,EAAE,wCAAwC,CAAC,CAAC;YACrE,CAAC;YAED,MAAM,EAAE,oBAAoB,EAAE,GAAG,wDAAa,aAAa,GAAC,CAAC;YAC7D,MAAM,cAAc,GAAG,MAAM,oBAAoB,CAAC;gBAChD,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM;gBAC9B,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,eAAe;gBACvC,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK;aAC7B,CAAC,CAAC;YAEH,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,cAAc,EAAE,CAAC;YACrD,IAAI,CAAC,GAAG,CAAC,uCAAuC,CAAC,CAAC;YAElD,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;gBAClC,MAAM,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC;gBACjD,MAAM,QAAQ,GAAG,GAAG,EAAE;oBACpB,aAAa,CAAC,SAAS,CAAC,CAAC;oBACzB,IAAI,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAC;oBAC/B,OAAO,EAAE,CAAC;gBACZ,CAAC,CAAC;gBACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;gBAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;YAClC,CAAC,CAAC,CAAC;YAEH,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,cAAc,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC,CAAC,CAAC;IACL,CAAC;;AA1DM,sBAAO,GAAG,wDAAwD,CAAC;AACnE,0BAAW,GAChB,kOAAkO,CAAC;AAC9N,uBAAQ,GAAG;IAChB,mCAAmC;IACnC,6CAA6C;IAC7C,wFAAwF;CACzF,CAAC;AAEK,mBAAI,GAAG,EAAE,CAAC;AAEV,oBAAK,GAAG;IACb,GAAG,0BAAW,CAAC,SAAS;IACxB,EAAE,EAAE,YAAK,CAAC,MAAM,CAAC;QACf,WAAW,EACT,qIAAqI;KACxI,CAAC;IACF,UAAU,EAAE,YAAK,CAAC,MAAM,CAAC;QACvB,WAAW,EAAE,kDAAkD;QAC/D,OAAO,EAAE,KAAK;KACf,CAAC;CACH,CAAC;kBAtBiB,cAAc"}

package/dist/commands/android/create.d.ts

@@ -2,11 +2,9 @@ import { BaseCommand } from '../../base-command';
 export default class AndroidCreate extends BaseCommand {
     static summary: string;
     static description: string;
-    static aliases: string[];
     static examples: string[];
     static flags: {
         connect: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
-        stream: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         rm: import("@oclif/core/lib/interfaces").BooleanFlag<boolean>;
         'adb-path': import("@oclif/core/lib/interfaces").OptionFlag<string, import("@oclif/core/lib/interfaces").CustomOptions>;
         'display-name': import("@oclif/core/lib/interfaces").OptionFlag<string | undefined, import("@oclif/core/lib/interfaces").CustomOptions>;

package/dist/commands/android/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/android/create.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAC,OAAO,SAAmC;IACjD,MAAM,CAAC,WAAW,SACkF;IACpG,MAAM,CAAC,OAAO,WAAmB;IAEjC,MAAM,CAAC,QAAQ,WAIb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;;;;;MAwBV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAgH3B"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../../src/commands/android/create.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD,MAAM,CAAC,OAAO,OAAO,aAAc,SAAQ,WAAW;IACpD,MAAM,CAAC,OAAO,SAAmC;IACjD,MAAM,CAAC,WAAW,SAC+J;IAEjL,MAAM,CAAC,QAAQ,WAKb;IAEF,MAAM,CAAC,KAAK;;;;;;;;;;;;;;MAsCV;IAEI,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyG3B"}

package/dist/commands/android/create.js

@@ -37,7 +37,6 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 const path_1 = __importDefault(require("path"));
-const child_process_1 = require("child_process");
 const core_1 = require("@oclif/core");
 const base_command_1 = require("../../base-command");
 const formatting_1 = require("../../lib/formatting");
@@ -119,16 +118,7 @@ class AndroidCreate extends base_command_1.BaseCommand {
                     token: instance.status.token,
                 });
                 const tunnel = await instanceClient.startAdbTunnel();
-                if (flags.stream) {
-                    const addr = `${tunnel.address.address}:${tunnel.address.port}`;
-                    const scrcpy = (0, child_process_1.spawn)('scrcpy', ['-s', addr], { stdio: 'inherit' });
-                    scrcpy.on('error', (err) => {
-                        this.warn(`Failed to start scrcpy: ${err.message}`);
-                    });
-                    scrcpy.on('close', () => {
-                        process.kill(process.pid, 'SIGTERM');
-                    });
-                }
+                this.log(`Open the Console URL in your browser to stream the device: ${this.consoleStreamUrl(instance.metadata.id)}`);
                 this.log('Tunnel started. Press Ctrl+C to stop.');
                 await new Promise((resolve) => {
                     const keepAlive = setInterval(() => { }, 1 << 30);
@@ -152,35 +142,48 @@ class AndroidCreate extends base_command_1.BaseCommand {
     }
 }
 AndroidCreate.summary = 'Create a new Android instance';
-AndroidCreate.description = 'Creates and optionally connects to a new Android instance with ADB tunnel and scrcpy streaming.';
-AndroidCreate.aliases = ['run android'];
+AndroidCreate.description = 'Create a new cloud Android instance and optionally connect to it immediately with an ADB tunnel. Use the printed Console URL to open the live device stream in your browser.';
 AndroidCreate.examples = [
     '<%= config.bin %> android create',
     '<%= config.bin %> android create --rm --install ./app.apk',
     '<%= config.bin %> android create --region us-west --label env=dev',
+    '<%= config.bin %> android create --no-connect',
 ];
 AndroidCreate.flags = {
     ...base_command_1.BaseCommand.baseFlags,
     connect: core_1.Flags.boolean({
-        description: 'Connect to the instance (start ADB tunnel)',
+        description: 'Connect to the new instance immediately by starting an ADB tunnel',
         default: true,
         allowNo: true,
     }),
-    stream: core_1.Flags.boolean({ description: 'Stream the instance with scrcpy', default: true, allowNo: true }),
-    rm: core_1.Flags.boolean({ description: 'Delete instance on exit', default: false }),
-    'adb-path': core_1.Flags.string({ description: 'Path to adb binary', default: 'adb' }),
-    'display-name': core_1.Flags.string({ description: 'Display name for the instance' }),
-    region: core_1.Flags.string({ description: 'Region where the instance will be created' }),
+    rm: core_1.Flags.boolean({
+        description: 'Delete the instance automatically when this CLI process exits',
+        default: false,
+    }),
+    'adb-path': core_1.Flags.string({
+        description: 'Path to the adb binary used for tunnel-driven workflows',
+        default: 'adb',
+    }),
+    'display-name': core_1.Flags.string({
+        description: 'Human-friendly display name shown in listings and the console',
+    }),
+    region: core_1.Flags.string({ description: 'Region where the instance should be created, such as us-west' }),
     'hard-timeout': core_1.Flags.string({ description: 'Hard timeout (e.g. 1m, 10m, 3h). Default: no timeout' }),
     'inactivity-timeout': core_1.Flags.string({ description: 'Inactivity timeout (e.g. 1m, 10m, 3h). Default: 3m' }),
-    label: core_1.Flags.string({ description: 'Labels in key=value format', multiple: true }),
+    label: core_1.Flags.string({
+        description: 'Metadata label in key=value format. Repeat to attach multiple labels.',
+        multiple: true,
+    }),
     'reuse-if-exists': core_1.Flags.boolean({
-        description: 'Reuse existing instance with same labels/region',
+        description: 'Reuse an existing matching instance instead of creating a new one',
         default: false,
     }),
-    'install-asset': core_1.Flags.string({ description: 'Asset name to install (can be repeated)', multiple: true }),
+    'install-asset': core_1.Flags.string({
+        description: 'Existing asset name to install after creation. Repeat for multiple assets.',
+        multiple: true,
+    }),
     install: core_1.Flags.string({
-        description: 'Local file to install (auto-uploads if needed, can be repeated)',
+        description: 'Local app file to upload and install automatically after creation. Repeat for multiple files.',
         multiple: true,
     }),
 };