Cua Spaces
The Cua Spaces app and SDK: register any sandbox or machine once, then stream it, run agents in it and teleport apps into it.
The Cua Spaces app and SDK: register any sandbox or machine once, then stream it, run agents in it and teleport apps into it.
A Space is a desktop your agents can use and you can watch: a container or VM on your own Mac, one of your team's machines, or your own cloud (AWS, Google Cloud or Modal). Each runs cua-spacesd, which streams the screen, takes input through Cua Driver, and receives teleported apps and files. Cua Spaces is source-available under the FSL-1.1-MIT. For teams, see Teams.
The Cua Spaces app puts your Spaces in the menu bar and notch, so you can watch them, open them and teleport apps in with a drag. It launches at login (Settings > General > Launch Cua Spaces at login, on after setup unless you untick it), so the Spaces this machine provides, your persistent agents and Cua Volume come back after a restart.
The Cua SDK gives your own apps the same Spaces: create them, stream them and run agents in them from Python, TypeScript, Swift or Rust.
| Kind | Id | Comes from |
|---|---|---|
| Local | local:<name> | spaces.create(options): a new Space, on this machine by default |
| Direct | direct:<host:port> | spaces.add(url, token): an existing machine |
| Relay | relay:<machine-id> | Your machines set up with cua host setup, listed automatically |
The app, the cua CLI, the SDKs and cua daemon share one registry (~/.cua/spaces.json). Relay machines come from the account's directory and are never written to spaces.json.
| Task | Guide |
|---|---|
| Create or add a Space, from any image | Add a Space |
| Reach this machine from your other devices | Unattended access |
| Watch a desktop or one window, with audio | Stream a desktop |
| Send a file or folder into a Space | Send files |
| Move a signed-in app session into a Space | Teleport an app |
| Give an AI agent Spaces tools, or run agents inside a Space | Use from an agent |
| See an app built on the Spaces SDK | Cua Bots, infinite canvas, examples in other languages |
Start with the Quickstart: install the app and CLI, then add your first Space.