From 72ac68ad546058b1eed8e818ffe4c3cfd38cb8e0 Mon Sep 17 00:00:00 2001 From: Thibaut Fatus Date: Mon, 1 Jun 2026 17:03:32 +0200 Subject: [PATCH] =?UTF-8?q?docs:=20native-runner=20section=20=E2=80=94=20a?= =?UTF-8?q?gent-device=200.16.7,=20tiktok-ios,=20workspace-exec?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - Note agent-device pin is now ^0.16.7 and add tiktok-ios to the registered drivers, with a caveat that CLI slug routing keys on -android only, so kora-app-tiktok-ios is not yet reachable end-to-end (falls through to web). - Replace root-level `npx agent-device …` with the kora-apps workspace-exec form (the pnpm linker does not hoist the CLI to a repo root). Co-Authored-By: Claude Opus 4.8 (1M context) --- README.md | 13 ++++++++----- 1 file changed, 8 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index fb4531a..325a94d 100644 --- a/README.md +++ b/README.md @@ -405,17 +405,20 @@ yarn kora run kora-app-gemini \ ### Native-runner (Android apps) -Drives a physical Android device via [`agent-device`](https://www.npmjs.com/package/agent-device) (pinned in `../kora-apps/packages/native-runner/package.json`). Registered drivers today: `tiktok-android` (slug `kora-app-tiktok-android`). See `../kora-apps/MOBILE_TESTING.md` for the full operator guide; the summary below covers a local run end-to-end. +Drives a physical Android device via [`agent-device`](https://www.npmjs.com/package/agent-device) (pinned `^0.16.7` in `../kora-apps/packages/native-runner/package.json`). Registered drivers today: `tiktok-android` (slug `kora-app-tiktok-android`) and `tiktok-ios`. See `../kora-apps/MOBILE_TESTING.md` for the full operator guide; the summary below covers a local run end-to-end. + +> **iOS not yet routable via the CLI:** slug routing keys on the `-android` suffix only (`NATIVE_SUFFIXES` in `packages/cli/src/models/nativeRunnerModel.ts`), so `kora-app-tiktok-ios` would fall through to the web-runner. The `tiktok-ios` driver exists in the native-runner but needs `-ios` (or platform-explicit) routing before it can run end-to-end. **1. Prep the phone:** - Plug it in, unlock it, leave the screen on (`agent-device` cannot wake or unlock). -- Confirm it's reachable and no stale session is holding it: +- Confirm it's reachable and no stale session is holding it. agent-device lives in the kora-apps workspace (the pnpm linker does not hoist its CLI to a repo root), so invoke it through that workspace: ```bash - npx agent-device devices --platform android - npx agent-device session list - npx agent-device --session close # if needed + cd ../kora-apps + yarn workspace @korabench/apps-native-runner exec agent-device devices --platform android + yarn workspace @korabench/apps-native-runner exec agent-device session list + yarn workspace @korabench/apps-native-runner exec agent-device --session close # if needed ``` **2. Configure `../kora-apps/.env`:**