Repository navigation
AutoCua v0.1.7
This release makes the iPhone and Android sub-agents start much faster in Computer use, fixes iPhone app launching over Wi-Fi, and makes Android over Wi-Fi more reliable.
Faster phones in Computer use
- Sub-agents are ready before the task comes. When a phone comes online, its agent starts and gets ready in the background. When the main agent hands it a task, it begins at once: about 0.05 s on Android, where a busy run used to take 43 s.
- The iPhone stays connected between requests. After a request, the iPhone session stays warm for 10 minutes, so the next request gets the phone in about 0.2 s instead of starting again.
- Faster iPhone start over Wi-Fi. WebDriverAgent is built once and reused, so a start takes about 4 to 5 s instead of 6 to 8 s. If the saved build stops working (for example, an expired free signing profile), it rebuilds by itself.
- Lighter iOS agent. The iOS agent now loads only the AI provider it uses: 351 modules at start instead of 3,587.
- A stuck iOS start recovers on its own. If the iOS agent has not started its run after 20 seconds, it is restarted once, and the details are saved for debugging.
Fixes
- iPhone over Wi-Fi: opening apps works.
open_appfailed with "Expecting value: line 1 column 1 (char 0)" when the iPhone was on Wi-Fi. The installed app list now comes from Xcode's own tool, so apps open on Wi-Fi as they do on the cable. - iPhone connect no longer hangs on Xcode. Xcode's
devicectlscript could start an Xcode component install before every command and hang for minutes. AutoCua now calls the realdevicectldirectly. - Android over Wi-Fi after the Mac sleeps. A phone on Wi-Fi could show as "not on Wi-Fi" after the Mac had slept, because adb stopped hearing phones. AutoCua now restarts adb once when nothing is connected, then looks again.
- Claude prompts. The memory field in the screenshot agents' Claude prompts now says clearly what it is for: the screenshot is removed after each step, and this field carries the context forward.
Install
pip install -U autocua
Prebuilt wheels (Python 3.10+):
| Platform | Wheel |
|---|---|
| macOS, Apple silicon | macosx_11_0_arm64 |
| Windows x64 | win_amd64 |
| Linux x86_64 (glibc 2.17+) | manylinux_2_17_x86_64 |
Other platforms build from source and need Rust.
Full changelog: v0.1.6...v0.1.7