Cua Driver 0.36.0
This release makes background work on macOS more reliable. The driver does more without touching your windows, your keyboard focus or your pointer.
What's new
- Background typing into LibreOffice. Documents and spreadsheets take keystrokes while you work in another app.
- Chrome's first read of a background window now includes the page. You no longer get an empty tree on the first call.
- Background drag. Drags work in native apps and on web pages. Electron windows refuse a background drag in this release and offer a foreground drag instead.
- Background menu commands. Menu and format controls work without bringing the app forward.
- Reading pages on another Space. You can read a page without switching Spaces.
- Dropdowns no longer raise the window.
- No focus bounce after background clicks. Your app keeps focus.
- A clear error when you run the bare binary. The driver now says so and asks you to run the app bundle (CuaDriver.app), which it needs for a WindowServer connection.
health_reporthas a newwindowserver_connectioncheck. - Updated skill guidance for agents.
Changes
Features
- publish isolated browser session lifetime in browser_prepare. (#5183) Thanks @Iflaqbhat.
- background drag on macOS (CUA-1207). (#5309)
Fixes
- advertise coordinate scrolling support. (#5149) Thanks @Iflaqbhat; reported by @amplogik.
- let CUA_LOG=info and debug raise the log level. (#5173) Thanks @Ed-Key.
- type long Linux text in spare-keycode batches. (#5168) Thanks @CMGS.
- stop worker and embedded processes launching Orca on GNOME. (#5179) Thanks @methanoya.
- drain autoreleased objects on SCK capture workers. (#5170) Thanks @Irfanwani.
- report every layer when list_windows is given a pid. (#5162) Thanks @bitomule.
- wait for the client before restoring a borrowed keycode. (#5172) Thanks @CMGS.
- build macOS fixtures for the host architecture. (#5202) Thanks @loonghao.
- list window rows in list_windows text content. (#5211) Thanks @Irfanwani.
- print actionable PATH install hints. (#5219) Thanks @Iflaqbhat.
- report actual browser delivery mode in public results. (#5222)
- refuse unconfirmed macOS Electron scrolls. (#5251) Thanks @SDSLeon.
- honor --pid-file in cua-driver status. (#5246) Thanks @methanoya.
- skip web content during Chrome consent scans. (#5216) Thanks @Iflaqbhat.
- report Linux and Windows permissions status instead of "not granted". (#5237) Thanks @RitikaxG.
- say why a Windows desktop can't be captured (locked, RDP disconnected) (CUA-1727). (#5266)
- stop a batched text before rebinding keycodes the client has not confirmed reading. (#5244) Thanks @CMGS.
- background keyboard into editor surfaces and multi-window apps (CUA-1767). (#5306)
- background menu/format controls and page reads on another Space (CUA-1768, CUA-1769). (#5307)
- make the addressed LibreOffice window key without activating (CUA-1767). (#5319)
- wait for Chrome web content on first read; point background browser_prepare refusals to the AX route (CUA-1766). (#5305)
- refuse background drags in Electron windows and fix the AppKit drag cell. (#5335)
- stop background actions from raising Chrome or re-activating the user's app (CUA-1309, CUA-1791). (#5334)
- resolve launch_app to the app window, not a launcher splash. (#5342) Thanks @abonneth.
- fail loudly when the unbundled daemon has no WindowServer connection (CUA-1777). (#5333)
- keep the current tab's page out of the Chrome setup proof. (#5343) Thanks @abonneth.
Contributors
Thanks to @abonneth, @amplogik, @bitomule, @CMGS, @Ed-Key, @Iflaqbhat, @Irfanwani, @loonghao, @methanoya, @RitikaxG, @SDSLeon for contributing to this release.
Install
macOS and Linux:
/bin/bash -c "$(curl -fsSL https://cua.ai/driver/install.sh)"Windows:
irm https://cua.ai/driver/install.ps1 | iexCua Driver ships universal macOS binaries, x86_64 and arm64 Windows builds,
and Linux preview builds. Release assets also include tag-pinned installer and
uninstaller scripts.
Why GitHub says “Pre-release”
GitHub's label is used only to keep this monorepo's repository-wide “Latest”
pointer from switching between independently released products. A plain Cua
Driver SemVer is a stable release; npm and PyPI publish it on
their normal stable channels, and the installers resolve the versioned
cua-driver-rs-v* releases directly.
SHA256 Checksums
513dfaff1cb75eeab37356e7ac7b569378886b06fa3e13b7d0c4763bbec158ae SHA256SUMS
0c4070611492e16e95aa4bbff7fc5a9fbf97a8b2fcbc837de8418bad467f17a3 SHA256SUMS.sigstore.json
7ad1e9ffe30bd6d1298bf04900b4b7ffe5e6578b60fd77cc3135ab38c8ae233f _install-rust.sh
0c88b8d0dd1f81abde762c55ecf03a382f7716bddb7827c129df4479f4ac6d8e _install-rust.sh.sigstore.json
df0ac5a4af549a4d940dfe130d9cbf1b6fea181a4ebc533479964341e0f874d3 checksums.txt
4a0e229922a1ac6d6f59152e0653541920951afa89a3007e4ff5ffc024eae7a8 cua-driver-rs-0.36.0-darwin-arm64.tar.gz
9ae2ae50a0721985ca693377c4e4caec5f800106b45dba1074a20a888824a916 cua-driver-rs-0.36.0-darwin-arm64.tar.gz.sigstore.json
584e44435a26f5aa90c2f0097242307efbd63e843fc3f61072147c1963b0e592 cua-driver-rs-0.36.0-darwin-universal-binary.tar.gz
717a5652bae371ea81565b55e31a8d646c97523a958d4e22d2846b8a6ca3f55a cua-driver-rs-0.36.0-darwin-universal-binary.tar.gz.sigstore.json
2a83cf9c3a2fa7ae27f3fe62e426aeca5acf76511bb14dd64d10ccb2de6aecae cua-driver-rs-0.36.0-darwin-universal.tar.gz
2a5222dd128a57909c87a4e4fdf375e3c4e17dbf9fb7973eece8028cfff08176 cua-driver-rs-0.36.0-darwin-universal.tar.gz.sigstore.json
b01a31098d89a215707f6630b8270c26e74cf5f94a36b4faaac2fc6ee48c1869 cua-driver-rs-0.36.0-darwin-x86_64.tar.gz
869c73bfb214cc8e287154431f133bf51ccb45ddcce2d648358521bc3cdf90e1 cua-driver-rs-0.36.0-darwin-x86_64.tar.gz.sigstore.json
f64a33889605944a4e5af0e6036496137a25d6375f041d7c56e65c3be456aab2 cua-driver-rs-0.36.0-linux-arm64-binary.tar.gz
1ffc3b1372c69299f5266a97da3c9062cb21993220e3fedfd0b1dc4a7f5f1b5f cua-driver-rs-0.36.0-linux-arm64-binary.tar.gz.sigstore.json
a13751da35c7a719d8f61b11b40abfc423b8613671b94198b7d419533bac0fa6 cua-driver-rs-0.36.0-linux-arm64.tar.gz
1e31f16bc1a733f5103690702a0dd0ca62b70eef133f24e0172018b16ebf166a cua-driver-rs-0.36.0-linux-arm64.tar.gz.sigstore.json
05dae2160c86bdf4855c279d30898213d7a150edb1992b7470afdd69f0df4064 cua-driver-rs-0.36.0-linux-x86_64-binary.tar.gz
76ff51c9b126fde79a4a4ea3c7ec0d41f0d314f28f0ca877d3c0ce7e1b7705bb cua-driver-rs-0.36.0-linux-x86_64-binary.tar.gz.sigstore.json
89eef40a9c574dd2ee1b923586dd7e85b802826a3c4d8f7e96647adf3f3923ba cua-driver-rs-0.36.0-linux-x86_64.tar.gz
fe375fb4e9bc4e2c56f3c0743c375055f1afcf0c7f401558ea8369a65fb144ee cua-driver-rs-0.36.0-linux-x86_64.tar.gz.sigstore.json
520ea584cf11c074bccc4fd2328e8f2b34ec43de9328d97afb7fd03f761b55ee cua-driver-rs-0.36.0-windows-arm64-binary.zip
a9d5391e920240e082df88c25dfb5e4f80e4a3c643c9ce315b76064814ee5a30 cua-driver-rs-0.36.0-windows-arm64-binary.zip.sigstore.json
cf0e490342aeb2f0334017f7096c947eea876cdc92f93c8becb7eeb14eea4a0e cua-driver-rs-0.36.0-windows-arm64.zip
0a0fd0a07f3092212920c12d2db715c152c66b2da7509db7d52819b9ec7cb3ca cua-driver-rs-0.36.0-windows-arm64.zip.sigstore.json
f8c47024b626f4e0e70f8428d2998df39e4879110c5722a29d5fd03e367353ad cua-driver-rs-0.36.0-windows-x86_64-binary.zip
2b56f80fc37fdf72c9bd48fe801ecea9b17ce904d62598cf283a69556d7e88fb cua-driver-rs-0.36.0-windows-x86_64-binary.zip.sigstore.json
7e17c872a1dbc764d31b142303cf3bddf3198c932e36fc9db31d293c069ae2b7 cua-driver-rs-0.36.0-windows-x86_64.zip
a027b9f0e845726a72d0b424268106a32eb249e9c4445153151a017326add692 cua-driver-rs-0.36.0-windows-x86_64.zip.sigstore.json
528e5c95c43bfd03d9f039b5d7cf8ea87804d71adbba139faeff24ea3161cdd6 cua-driver-rs-v0.36.0-skills.tar.gz
b7fa5979d31a9a16d1a2e7e7a81a091b15f692e955659bdfad0bbb726035cbc7 cua-driver-rs-v0.36.0-skills.tar.gz.sigstore.json
65acac102beded9eea20f1e0537d5b4c62c0adcb730289748213434b8a512d63 cua-hyprland-plugin-0.36.0-6d6c734c127025fb39ad5d585a10382808b39dc1-build-kit.tar.gz
6101b031e3d4287287ea87c587718ac63a6249b4436e3f6871d499d8f5e65a5d cua-hyprland-plugin-0.36.0-6d6c734c127025fb39ad5d585a10382808b39dc1-build-kit.tar.gz.sigstore.json
ee6d4890466de04a52636405856f3c7e38cc47bbc63c92e6be1e6ed7d4406f3b cua-hyprland-plugin-0.36.0-6d6c734c127025fb39ad5d585a10382808b39dc1.tar.gz
5033028b0b0b47f62affd5ce138c8661e315d40b820bbff6354e22d5226d631d cua-hyprland-plugin-0.36.0-6d6c734c127025fb39ad5d585a10382808b39dc1.tar.gz.sigstore.json
040985b102e82cbf9464d6df5701343f1dd907eb1c24d52b16bc2eb390cce1ee install.ps1
a231949968fc252ac5b3b93279a79045847d732971d4cb7f5525c59f7591e706 install.ps1.sigstore.json
a103177e0df86d04d752bfa20c73f99a3e501906f1814c3127da84788539d9ba install.sh
dc16a63a47f264d3ea7f2a210bff85456840b0da3b211bdbcf550e737de3f9ed install.sh.sigstore.json
72bfa26fad3b3635c03c67bce5e0663cb019e7d7ac43bdf0f9fb23a519aff061 uninstall.ps1
873414a2c5b92fdf5852601ab635351ae527487118e3fa81d39dc8f3a673c566 uninstall.ps1.sigstore.json
2c64a1ab11e53e1ded4d42c4a52c0c21783935a53182a929ee840409018ae513 uninstall.sh
4da07288c4599414ce820e9af5f49030ab317ebee254ff5f6ffebfc7587118a0 uninstall.sh.sigstore.json