cua Agent工作流

Cua SDK and CLI

One SDK and one cua command for local VMs and containers, and for any machine that runs cua-spacesd.

macOS / Linux

curl -fsSL https://cua.ai/install.sh | sh

Windows (PowerShell)

irm https://cua.ai/install.ps1 | iex

In a terminal the script first says what Cua Spaces is. The command-line tools (the cua program) are always installed; you choose whether to add the Cua Spaces app (on by default) and Cua Driver, which lets AI agents use your apps while you keep working (off by default). It then runs cua auth login, which signs you in and offers to set up your AI coding agents (Claude Code, Codex, Cursor, and others). The app asks on its first run whether your other devices may use this computer. Add Cua Driver with sh -s -- --select cua-driver, or skip the choice with --only cua-driver. See the installer options.

cua sb create ubuntu --name dev          # a gVisor container, set up on first use
cua sb exec dev uname -a
cua sb screenshot dev
cua sb rm dev

The same sandbox from Python:

from cua_sandbox import Image, Sandbox

async with Sandbox.ephemeral(Image.linux(), local=True) as sb:
    print((await sb.shell.run("uname -a")).stdout)

• SDK: the same API in Python (pip install cua), TypeScript (@trycua/cua) and Rust (cua-sdk), running embedded in your process or through a shared cua daemon. Swift and Kotlin bindings are not yet released.
• Sandboxes need no agent inside. Readiness comes from the runtime and optional port probes. Images that ship cua-spacesd (port 3211) add processes, files, screenshots, input through cua-driver, and low-latency video and audio streaming. There is no agent layer in the SDK either: drive sandboxes from your own harness (guide).
• Your own machines. cua host setup makes this machine reachable through the cua.ai relay with no port forwarding.

SDK README | Quickstart | CLI reference | Sandbox SDK reference

---

Packages

Deprecated packages

Cua no longer maintains these. They will not receive updates or fixes, and existing releases stay on npm and PyPI. See Migrate from deprecated packages.

---