[codex] docs(cua-driver): pivot to rust-first driver

.github/workflows/cd-rust-cua-driver.yml

@@ -408,8 +408,7 @@ jobs:
           # macos-15 and uses the BSD form (`sed -i ''`).
           # The Rust install logic now lives at
           # libs/cua-driver/scripts/_install-rust.sh (a private helper
-          # invoked by libs/cua-driver/scripts/install.sh on
-          # --backend=rust / non-macOS auto-detect).
+          # invoked by libs/cua-driver/scripts/install.sh by default).
           sed -i \
             "s/^CUA_DRIVER_RS_BAKED_VERSION=.*/CUA_DRIVER_RS_BAKED_VERSION=\"${VERSION}\"/" \
             libs/cua-driver/scripts/_install-rust.sh
@@ -442,24 +441,21 @@ jobs:
           # what gets copied here, so the per-tag release assets carry the
           # current version's baked default — not the previous version's.
           # Both user-facing installers live under libs/cua-driver/scripts/:
-          # install.sh is the Swift driver's installer that
-          # auto-delegates to the Rust _install-rust.sh helper on
-          # --experimental-rust / non-macOS hosts. install.ps1 is the
-          # canonical Windows installer (Rust port; Swift has no
-          # Windows build). The Rust install logic itself lives at
-          # _install-rust.sh — published as a release asset alongside
-          # the installers so curl|bash flows can fetch it.
+          # install.sh is the canonical macOS/Linux installer and delegates
+          # to the Rust _install-rust.sh helper by default. install.ps1 is
+          # the canonical Windows installer. The Rust install logic itself
+          # lives at _install-rust.sh — published as a release asset
+          # alongside the installers so curl|bash flows can fetch it.
           cp libs/cua-driver/scripts/install.sh         release-upload/install.sh
           cp libs/cua-driver/scripts/install.ps1        release-upload/install.ps1
           cp libs/cua-driver/scripts/_install-rust.sh   release-upload/_install-rust.sh
 
           # Uninstaller scripts — single canonical file per shell (no
-          # `_uninstall-rust.sh` helper). uninstall.sh handles both Swift
-          # (macOS default) and Rust (Linux auto-select, macOS opt-in via
-          # --experimental-rust / --backend=rust) inline. uninstall.ps1
-          # is the Windows uninstaller (cua-driver-rs only — no Swift
-          # Windows build) and self-elevates via UAC when an -AutoStart
-          # install (RunLevel=Highest task) needs to be torn down.
+          # `_uninstall-rust.sh` helper). uninstall.sh handles Rust by
+          # default and keeps an explicit --backend=swift legacy path for
+          # retired macOS installs. uninstall.ps1 is the Windows uninstaller
+          # and self-elevates via UAC when an -AutoStart install
+          # (RunLevel=Highest task) needs to be torn down.
           cp libs/cua-driver/scripts/uninstall.sh       release-upload/uninstall.sh
           cp libs/cua-driver/scripts/uninstall.ps1      release-upload/uninstall.ps1
 
@@ -529,43 +525,33 @@ jobs:
         uses: softprops/action-gh-release@v2
         with:
           files: release-upload/*
-          # The `prerelease: true` flag + the explicit BETA banner make it
-          # clear to anyone landing on the release page that cua-driver-rs
-          # is the cross-platform Rust port of the Swift cua-driver and is
-          # still in BETA — the Swift cua-driver remains the production
-          # macOS binary.
           prerelease: true
           body: |
-            > ⚠️ **BETA — cua-driver-rs**
+            > **cua-driver-rs**
             >
-            > `cua-driver-rs` is the **cross-platform Rust port** of the original Swift
+            > `cua-driver-rs` is the Rust implementation of
             > [`cua-driver`](https://github.com/trycua/cua/tree/main/libs/cua-driver),
-            > introducing **Windows and Linux support** to the cua-driver tool surface.
-            >
-            > - **Windows** and **Linux**: feature-complete, recommended for testing /
-            >   integration work.
-            > - **macOS**: parity with the Swift cua-driver is in progress; for production
-            >   macOS automation prefer the Swift binary
-            >   (`cua-driver-v*` releases, installed via the Swift `install.sh`).
+            > shipping the same user-facing `cua-driver` binary for macOS and
+            > Windows, plus Linux pre-release artifacts for early testing.
             >
             > The Rust port and the Swift driver publish to the same GitHub repo under
             > **distinct tag prefixes** (`cua-driver-rs-v*` vs `cua-driver-v*`), so their
-            > installers do not collide.
+            > release artifacts do not collide.
 
             ${{ steps.notes.outputs.RELEASE_NOTES }}
 
             ${{ steps.checksums.outputs.checksums }}
 
-            ### Install (Linux / macOS)
+            ### Install (macOS / Linux pre-release)
 
             ```bash
             /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
             ```
 
-            On macOS the installer defaults to the Swift driver; pass
-            `--experimental-rust` to get the cua-driver-rs Rust port.
-            On Linux it auto-detects the non-macOS host and installs
-            the Rust port directly.
+            The shell installer covers macOS and the Linux pre-release backend
+            and installs the Rust implementation by default. Linux artifacts are
+            published for early testing and are not yet an official supported
+            release tier.
 
             ### Install (Windows)
 
@@ -585,7 +571,7 @@ jobs:
             - `cua-driver-rs-${{ steps.version.outputs.version }}-darwin-x86_64.tar.gz` — same payload, named for x86_64 callers
             - `cua-driver-rs-${{ steps.version.outputs.version }}-darwin-universal-binary.tar.gz` — bare universal binary (single file at archive root; **no** .app — bypasses the TCC auto-relaunch path)
 
-            **Linux**
+            **Linux pre-release**
             - `cua-driver-rs-${{ steps.version.outputs.version }}-linux-x86_64.tar.gz` — directory tarball
             - `cua-driver-rs-${{ steps.version.outputs.version }}-linux-x86_64-binary.tar.gz` — bare binary
 
@@ -596,9 +582,9 @@ jobs:
             - `cua-driver-rs-${{ steps.version.outputs.version }}-windows-arm64-binary.zip` — bare `cua-driver.exe` (Windows on ARM)
 
             **Installer scripts**
-            - `install.sh` — Linux / macOS one-liner installer
+            - `install.sh` — macOS / Linux pre-release one-liner installer
             - `install.ps1` — Windows one-liner installer
-            - `uninstall.sh` — Linux / macOS one-liner uninstaller (mirrors the install flag set: Swift by default; `--experimental-rust` for the Rust port; non-macOS auto-detects)
+            - `uninstall.sh` — macOS / Linux pre-release one-liner uninstaller
             - `uninstall.ps1` — Windows one-liner uninstaller
           generate_release_notes: false
           make_latest: false
@@ -651,7 +637,7 @@ jobs:
           # (`sed -i ''`).
           # Rust install logic lives at libs/cua-driver/scripts/_install-rust.sh
           # (private helper invoked by the canonical libs/cua-driver/scripts/install.sh
-          # on --backend=rust / non-macOS auto-detect).
+          # by default).
           sed -i \
             "s/^CUA_DRIVER_RS_BAKED_VERSION=.*/CUA_DRIVER_RS_BAKED_VERSION=\"${VERSION}\"/" \
             libs/cua-driver/scripts/_install-rust.sh

.github/workflows/ci-check-docs.yml

@@ -3,8 +3,10 @@ name: "CI: Check Docs"
 on:
   pull_request:
     paths:
-      # Cua Driver (Swift)
-      - "libs/cua-driver/Sources/**"
+      # Cua Driver (Rust)
+      - "libs/cua-driver/rust/crates/**"
+      - "libs/cua-driver/rust/Cargo.toml"
+      - "libs/cua-driver/rust/Cargo.lock"
       # Lume (Swift)
       - "libs/lume/src/**"
       # Cua CLI (TypeScript)
@@ -69,7 +71,7 @@ jobs:
           GENERATORS=""
 
           # Source changes
-          if echo "$CHANGED_FILES" | grep -q "^libs/cua-driver/Sources/\|^docs/content/docs/cua-driver/reference/"; then
+          if echo "$CHANGED_FILES" | grep -q "^libs/cua-driver/rust/crates/\|^libs/cua-driver/rust/Cargo.toml\|^libs/cua-driver/rust/Cargo.lock\|^docs/content/docs/cua-driver/reference/"; then
             GENERATORS="$GENERATORS cua-driver"
           fi
           if echo "$CHANGED_FILES" | grep -q "^libs/lume/src/"; then
@@ -115,8 +117,8 @@ jobs:
 
       - name: Build cua-driver (if needed)
         if: contains(steps.changed.outputs.generators, 'cua-driver') || steps.changed.outputs.generators == 'all'
-        run: swift build --configuration release
-        working-directory: libs/cua-driver
+        run: cargo build -p cua-driver --release
+        working-directory: libs/cua-driver/rust
 
       - name: Build Lume (if needed)
         if: contains(steps.changed.outputs.generators, 'lume') || steps.changed.outputs.generators == 'all'

.github/workflows/ci-swift-cua-driver.yml

@@ -20,7 +20,7 @@ jobs:
       - run: uname -a
       - run: sudo xcode-select -s /Applications/Xcode_16.3.app # Swift 6.1
       - run: swift test
-        working-directory: ./libs/cua-driver
+        working-directory: ./libs/cua-driver/swift
   build:
     name: Release build
     runs-on: macos-15
@@ -29,4 +29,4 @@ jobs:
       - run: uname -a
       - run: sudo xcode-select -s /Applications/Xcode_16.3.app # Swift 6.1
       - run: swift build --configuration release
-        working-directory: ./libs/cua-driver
+        working-directory: ./libs/cua-driver/swift

README.md

@@ -26,7 +26,7 @@
   <table>
     <tr>
       <td colspan="3" align="center">
-        <a href="#cua-driver---background-computer-use-on-macos">
+        <a href="#cua-driver---background-computer-use-on-macos-and-windows-with-linux-pre-release">
           <img src="img/card-cua-driver.png" alt="Cua Driver — The background computer-use agent" width="888">
         </a>
       </td>
@@ -53,17 +53,23 @@
 
 ---
 
-## Cua Driver - Background computer-use on macOS
+## Cua Driver - Background computer-use on macOS and Windows, with Linux pre-release
 
-Drive any native macOS app **in the background** — agents click, type, and verify without stealing the cursor, focus, or Space, even on non-AX surfaces like Chromium web content and canvas-based tools (Blender, Figma, DAWs, game engines). Use with the CLI or MCP server for Claude Code, Cursor, and custom clients. Every session records as a replayable trajectory.
+Drive native desktop apps **in the background** — agents click, type, and verify without stealing the cursor or focus. Use the same CLI and MCP server on macOS and Windows from Claude Code, Cursor, Codex, OpenClaw, and custom clients. Linux support is available as a pre-release backend while platform testing is still in progress.
+
+**macOS / Linux pre-release**
 
 ```sh
 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.sh)"
 ```
 
-> Want to try the cross-platform Rust port early? Add `-- --experimental-rust` to the line above — it delegates to the [`cua-driver-rs`](libs/cua-driver/rust/) installer (separate bundle, coexists with the Swift binary).
+**Windows (PowerShell)**
+
+```powershell
+irm https://raw.githubusercontent.com/trycua/cua/main/libs/cua-driver/scripts/install.ps1 | iex
+```
 
-Full tool reference, architecture notes, and the Claude Code skill ship with the package: [`libs/cua-driver/README.md`](libs/cua-driver/README.md).
+Full tool reference, architecture notes, and the optional agent skill pack live here: [`libs/cua-driver/README.md`](libs/cua-driver/README.md).
 
 ---