latekvo · Oct 22, 2026 · Aug 10, 2026 · Aug 10, 2026 · Aug 10, 2026 · Aug 10, 2026
diff --git a/README.md b/README.md
@@ -5,7 +5,7 @@
 [![Ad](https://swm-delivery.com/www/images/zone-gh-argent-2?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-2&n=1)
 [![Ad](https://swm-delivery.com/www/images/zone-gh-argent-3?n=1)](https://swm-delivery.com/www/delivery/ck-slug.php?zoneid=zone-gh-argent-3&n=1)
 
-**[Argent](https://argent.swmansion.com)** gives your AI assistant direct control of iOS simulators, Android emulators and devices, TVs (Apple TV, Android TV, Fire TV) and Electron/Chromium apps. Tap a button, profile a screen, reproduce a bug - without leaving the CLI.
+**[Argent](https://argent.swmansion.com)** gives your AI assistant direct control of iOS simulators, Android emulators and devices, HarmonyOS phones and emulators, TVs (Apple TV, Android TV, Fire TV) and Electron/Chromium apps. Tap a button, profile a screen, reproduce a bug - without leaving the CLI.
 
 ```bash
 npx @swmansion/argent@latest init  # pnpm: pnpm dlx @swmansion/argent@latest init

diff --git a/Telemetry.md b/Telemetry.md
@@ -63,7 +63,7 @@ When you use the Argent Lens design-review flow (previewing and choosing between
 
 - Argent version, Node.js version, operating system, processor architecture;
 - whether the process runs in an interactive terminal and whether it runs in a CI environment;
-- whether Argent is used in connection with Android, iOS, tvOS (Apple TV), Android TV, VegaOS, or a Chromium-based target, and whether that target is a simulator or emulator, a virtual device, a physical device, or a desktop application. This category is inferred from the form of the device identifier; the identifier itself is never recorded;
+- whether Argent is used in connection with Android, iOS, tvOS (Apple TV), Android TV, VegaOS, HarmonyOS, or a Chromium-based target, and whether that target is a simulator or emulator, a virtual device, a physical device, or a desktop application. This category is inferred from the form of the device identifier; the identifier itself is never recorded;
 - when a device is supplied by an external device provider, a short label for that provider (the leading segment of the name the provider registers under), never the identifier of the device it supplies.
 
 ### Diagnostics

diff --git a/packages/docs/docs/features/screen-recording.mdx b/packages/docs/docs/features/screen-recording.mdx
@@ -45,7 +45,7 @@ The files stay in the working tree. Add the directory to `.gitignore` when you d
 
 ## Limits
 
-- Argent records iOS simulators, Android emulators, and physical Android devices. Argent does not record tvOS simulators, physical iPhones, Chromium apps, Vega devices, or remote simulators.
+- Argent records iOS simulators, Android emulators, and physical Android devices. Argent does not record tvOS simulators, physical iPhones, Chromium apps, Vega devices, HarmonyOS devices, or remote simulators.
 - One recording per device at a time. Different devices can record at the same time.
 - Argent uses `ffmpeg` to encode the video. Install `ffmpeg` before the first recording.
 - On Android, a secure screen such as a password field or a DRM video comes out black.

diff --git a/packages/docs/docs/features/visual-regression.mdx b/packages/docs/docs/features/visual-regression.mdx
@@ -55,6 +55,6 @@ Thus you can keep visual checks in the repository and run them in CI.
 - The comparison does not replace a check of the accessibility tree, the logs or the network record. The agent uses these sources together with the comparison.
 - The two screenshots must come from the same device class and the same orientation. When the resolution differs, Argent scales one screenshot down, and small differences can come from the scaling.
 - The agent does not use the comparison to find the position of an element for a tap. The agent uses the screen description for that.
-- The comparison works on an iOS simulator, or an Android emulator or device. It does not work on Chromium, Apple TV or Vega apps. On a [physical iPhone](/docs/features/physical-ios-devices), the agent captures full-resolution screenshots and compares them on the host instead.
+- The comparison works on an iOS simulator, an Android emulator or device, or a HarmonyOS device. It does not work on Chromium, Apple TV or Vega apps. On a [physical iPhone](/docs/features/physical-ios-devices), the agent captures full-resolution screenshots and compares them on the host instead.
 
 Argent does this with the `screenshot` and `screenshot-diff` tools. The [tools reference](/docs/reference/tools) contains all tools.
diff --git a/packages/docs/docs/fundamentals/installation.mdx b/packages/docs/docs/fundamentals/installation.mdx
@@ -13,6 +13,7 @@ sidebar_custom_props:
 - **iOS / tvOS**: macOS with **Xcode** installed. Apple TV uses tvOS simulators, and Xcode downloads the tvOS runtime on demand.
 - **Android / Android TV**: **Android SDK Platform Tools** (`adb`) on `PATH`, plus the **Android Emulator** package to boot AVDs from Argent. Create AVDs via Android Studio or `avdmanager`.
 - **Fire TV (Vega)**: the **Vega SDK** (`vega` CLI) on `PATH`, plus **Android SDK Platform Tools** (`adb`) on `PATH`. Most Vega tools, including UI inspection and screenshots, run over `adb`.
+- **HarmonyOS**: **DevEco Studio**, which ships `hdc` (the device connector) and the `Emulator` manager. Argent looks for both in `$DEVECO_STUDIO_HOME` first, then in `/Applications/DevEco-Studio.app` on macOS. Argent also finds `hdc` on `PATH`, for hosts that installed the OpenHarmony command-line tools without the IDE. A phone needs only `hdc`.
 - **Electron / Chromium**: nothing extra to control an already running app. Launch it with `--remote-debugging-port`, or let Argent spawn your Electron app for you.
 
 ## Run `init` in your project

diff --git a/packages/docs/docs/fundamentals/supported-platforms.mdx b/packages/docs/docs/fundamentals/supported-platforms.mdx
@@ -14,6 +14,7 @@ Argent drives a growing set of targets through a single toolkit, each with the r
 | **Android**       | Emulators (AVDs) and physical devices over adb                          | Touch / gesture  |
 | **TV**            | Apple TV (tvOS), Android TV / Google TV, Amazon Fire TV (Vega)          | D-pad / remote   |
 | **Desktop & web** | Electron and Chromium apps (incl. React Native Web / Expo web) over CDP | Mouse / keyboard |
+| **HarmonyOS**     | Phones over `hdc`, and DevEco Studio emulator instances                 | Touch / gesture  |
 
 <Video
   src="/video/ios-android-web.mp4"
@@ -41,6 +42,18 @@ Argent drives the iPhone Duo simulator closed, half-open and open. The agent fol
 
 Argent also drives a physical iPhone over a USB cable. Physical iPads are not supported yet. Automation on hardware is scoped to one app at a time, and a subset of the simulator tools is available. See [Physical iOS devices](/docs/features/physical-ios-devices).
 
+### HarmonyOS
+
+Argent drives any HarmonyOS phone or emulator that `hdc` is connected to. A phone with USB debugging enabled appears as `harmony-<connectKey>`. A DevEco Studio emulator instance appears as `harmony-emulator-<name>`. `boot-device` starts the instance and returns its `harmony-<connectKey>` id, so the same tools drive a phone and an emulator.
+
+- Argent reads the screen and injects taps, swipes and text through the device's own `uitest`.
+- `gesture-pinch` sends the start and end points of both fingers in one `uinput` call. The device interpolates the movement.
+- `launch-app`, `restart-app` and `open-url` use the `bm` and `aa` shell commands.
+- Argent refuses `gesture-rotate` and `gesture-custom`. The device moves each contact along one straight line per call.
+- Argent also refuses `rotate`, the profilers and the debugger. The device has no orientation command, and the profilers and the debugger have no HarmonyOS ingest path.
+
+Huawei restricts the emulator image download to mainland China. Outside mainland China, you cannot create an emulator instance until you get an image.
+
 ## TV targets
 
 A TV UI is focus-driven rather than touch-driven. Argent reads which element currently holds focus, then moves the cursor with directional remote presses and confirms with select.

diff --git a/packages/docs/docs/reference/flow-yaml.mdx b/packages/docs/docs/reference/flow-yaml.mdx
@@ -249,6 +249,8 @@ The identity selector must exist only on the destination. `idle` waits until the
 
 One outcome stops the run: the runner cannot read the UI tree at all. Argent marks the step as errored and skips the later steps.
 
+On HarmonyOS, which has no UI-tree source for flows, `idle` cannot run. The step errors immediately and names `wait:` as the replacement.
+
 `idle` has no `assert` form and no `when` form.
 
 ## Optional steps

diff --git a/packages/docs/docs/reference/tools.mdx b/packages/docs/docs/reference/tools.mdx
@@ -12,24 +12,24 @@ Run `argent tools` to list them from the terminal, `argent tools describe <name>
 
 ## Devices and apps
 
-| Tool                         | Description                                                                                   |
-| ---------------------------- | --------------------------------------------------------------------------------------------- |
-| `list-devices`               | List iOS simulators, Android emulators and devices, Chromium apps, and Vega (Fire TV) devices |
-| `boot-device`                | Boot a simulator, emulator, or Vega Virtual Device, or spawn an Electron app                  |
-| `launch-app`                 | Open an app by bundle id (iOS) or package name (Android)                                      |
-| `restart-app`                | Terminate then relaunch an app                                                                |
-| `terminate-app` (SDK only)   | Stop an app without relaunching it                                                            |
-| `reinstall-app`              | Install or reinstall an app, clearing app data and runtime permissions                        |
-| `open-url`                   | Open a URL or URL scheme on the device                                                        |
-| `settings-permissions`       | Grant, deny, or reset a runtime permission without navigating the Settings UI                 |
-| `rotate`                     | Set the device orientation to portrait or either landscape                                    |
-| `fold`                       | Fold or unfold a foldable iOS simulator to a posture or a hinge angle                         |
-| `shake`                      | Shake the device                                                                              |
-| `button`                     | Press a hardware button: home, back, power, volume, app switch, action button                 |
-| `tv-remote`                  | Press a TV remote or D-pad button on Apple TV, Android TV, or Vega                            |
-| `stop-simulator-server`      | Stop the transport session for one device and free its resources                              |
-| `stop-all-simulator-servers` | Stop every service a device owns: simulator servers, native devtools, TV daemons              |
-| `stop-metro`                 | Stop the Metro bundler listening on a given port                                              |
+| Tool                         | Description                                                                                                                   |
+| ---------------------------- | ----------------------------------------------------------------------------------------------------------------------------- |
+| `list-devices`               | List iOS simulators, Android emulators and devices, Chromium apps, Vega (Fire TV) devices, and HarmonyOS phones and emulators |
+| `boot-device`                | Boot a simulator, emulator, Vega Virtual Device, or HarmonyOS emulator, or spawn an Electron app                              |
+| `launch-app`                 | Open an app by bundle id (iOS) or package name (Android)                                                                      |
+| `restart-app`                | Terminate then relaunch an app                                                                                                |
+| `terminate-app` (SDK only)   | Stop an app without relaunching it                                                                                            |
+| `reinstall-app`              | Install or reinstall an app, clearing app data and runtime permissions                                                        |
+| `open-url`                   | Open a URL or URL scheme on the device                                                                                        |
+| `settings-permissions`       | Grant, deny, or reset a runtime permission without navigating the Settings UI                                                 |
+| `rotate`                     | Set the device orientation to portrait or either landscape                                                                    |
+| `fold`                       | Fold or unfold a foldable iOS simulator to a posture or a hinge angle                                                         |
+| `shake`                      | Shake the device                                                                                                              |
+| `button`                     | Press a hardware button: home, back, power, volume, app switch, action button                                                 |
+| `tv-remote`                  | Press a TV remote or D-pad button on Apple TV, Android TV, or Vega                                                            |
+| `stop-simulator-server`      | Stop the transport session for one device and free its resources                                                              |
+| `stop-all-simulator-servers` | Stop every service a device owns: simulator servers, native devtools, TV daemons                                              |
+| `stop-metro`                 | Stop the Metro bundler listening on a given port                                                                              |
 
 `launch-app` and `restart-app` accept `launchArgs`, a list of arguments that Argent passes to the app process at launch. For example, `["-FeatureFlag", "YES"]` overrides a UserDefaults value. `launchArgs` works on Apple simulators and physical iPhones. Other targets ignore it. If the app already runs, `launch-app` terminates it first, so that the app gets the arguments. On a physical iPhone, the app sees `--` before the arguments. UserDefaults overrides still apply.
 

diff --git a/packages/registry/src/errors.ts b/packages/registry/src/errors.ts
@@ -23,6 +23,8 @@ export const FAILURE_COMMANDS = [
   "adb",
   "emulator",
   "vega",
+  "hdc",
+  "deveco_emulator",
   "xcrun_simctl",
   "xctrace",
   "native_devtools",

diff --git a/packages/registry/src/failure-codes.ts b/packages/registry/src/failure-codes.ts
@@ -63,6 +63,20 @@ export const FAILURE_CODES = {
   VEGA_SCREENSHOT_FAILED: "VEGA_SCREENSHOT_FAILED",
   VEGA_TEXT_INVALID: "VEGA_TEXT_INVALID",
 
+  HARMONY_HDC_NOT_FOUND: "HARMONY_HDC_NOT_FOUND",
+  HARMONY_EMULATOR_NOT_FOUND: "HARMONY_EMULATOR_NOT_FOUND",
+  HARMONY_EMULATOR_COMMAND_FAILED: "HARMONY_EMULATOR_COMMAND_FAILED",
+  HARMONY_HDC_COMMAND_FAILED: "HARMONY_HDC_COMMAND_FAILED",
+  HARMONY_DEVICE_ID_INVALID: "HARMONY_DEVICE_ID_INVALID",
+  HARMONY_DEVICE_UNREACHABLE: "HARMONY_DEVICE_UNREACHABLE",
+  HARMONY_SHELL_NO_STATUS: "HARMONY_SHELL_NO_STATUS",
+  HARMONY_FILE_TRANSFER_FAILED: "HARMONY_FILE_TRANSFER_FAILED",
+  HARMONY_UITEST_FAILED: "HARMONY_UITEST_FAILED",
+  HARMONY_DISPLAY_UNREADABLE: "HARMONY_DISPLAY_UNREADABLE",
+  HARMONY_SCREEN_OFF: "HARMONY_SCREEN_OFF",
+  HARMONY_ABILITY_START_FAILED: "HARMONY_ABILITY_START_FAILED",
+  HARMONY_ABILITY_STOP_FAILED: "HARMONY_ABILITY_STOP_FAILED",
+
   ANDROID_ADB_NOT_FOUND: "ANDROID_ADB_NOT_FOUND",
   ANDROID_EMULATOR_NOT_FOUND: "ANDROID_EMULATOR_NOT_FOUND",
   ANDROID_ADB_COMMAND_FAILED: "ANDROID_ADB_COMMAND_FAILED",
@@ -309,6 +323,12 @@ export const FAILURE_CODES = {
   BOOT_ANDROID_FIRST_FRAME_TIMEOUT: "BOOT_ANDROID_FIRST_FRAME_TIMEOUT",
   BOOT_ANDROID_PACKAGE_MANAGER_UNAVAILABLE: "BOOT_ANDROID_PACKAGE_MANAGER_UNAVAILABLE",
   BOOT_ANDROID_COLD_BOOT_FAILED: "BOOT_ANDROID_COLD_BOOT_FAILED",
+  BOOT_HARMONY_INSTANCE_NOT_FOUND: "BOOT_HARMONY_INSTANCE_NOT_FOUND",
+  BOOT_HARMONY_TARGET_LIST_FAILED: "BOOT_HARMONY_TARGET_LIST_FAILED",
+  BOOT_HARMONY_STOP_FAILED: "BOOT_HARMONY_STOP_FAILED",
+  BOOT_HARMONY_STOP_TIMEOUT: "BOOT_HARMONY_STOP_TIMEOUT",
+  BOOT_HARMONY_MANAGER_EXITED: "BOOT_HARMONY_MANAGER_EXITED",
+  BOOT_HARMONY_START_FAILED: "BOOT_HARMONY_START_FAILED",
 
   /**
    * External device providers

diff --git a/packages/registry/src/types.ts b/packages/registry/src/types.ts
@@ -134,7 +134,7 @@ export interface ToolContext extends InvokeToolOptions {
   artifacts: ArtifactStore;
 }
 
-export type Platform = "ios" | "android" | "ios-remote" | "chromium" | "vega";
+export type Platform = "ios" | "android" | "ios-remote" | "chromium" | "vega" | "harmony";
 
 export type DeviceKind = "simulator" | "emulator" | "vvd" | "device" | "app" | "unknown";
 
@@ -181,6 +181,11 @@ export interface ToolCapability {
     vvd?: boolean;
     device?: boolean;
   };
+  /** `emulator` is a DevEco instance only `boot-device` addresses; interaction tools drive `device`. */
+  harmony?: {
+    emulator?: boolean;
+    device?: boolean;
+  };
   supports?: (device: DeviceInfo) => boolean;
 }
 
@@ -196,7 +201,14 @@ export interface ToolCapability {
  * A missing binary answers 424 Failed Dependency with an install hint the agent
  * can surface verbatim.
  */
-export type ToolDependency = "adb" | "xcrun" | "emulator" | "sim-remote" | "vega";
+export type ToolDependency =
+  | "adb"
+  | "xcrun"
+  | "emulator"
+  | "sim-remote"
+  | "vega"
+  | "harmony-emulator"
+  | "hdc";
 
 export interface ToolDefinition<TParams = void, TResult = unknown> {
   id: string;