How Spaces works

Computers and Spaces, bring-your-own compute, where a Space can run, and how you and your agents reach it directly or through the relay.

Cua Spaces connects three things: the computers you own, the Spaces on them, and the people and agents who use those Spaces.

Computers and Spaces#

A computer is a Mac, Windows or Linux PC you own or rent. Sign in and all your computers appear in one list, Computers, each with its state on the row. A computer provides Spaces. A Space is the isolated sandbox: an image plus a kind (vm, gvisor, microvm or container), set up for a task. A computer can also share its own desktop as a Space. See Computers and Spaces for how they relate and Space kinds for the kinds.

Cua doesn't rent computers. You bring them, and your cloud provider bills you for any VM you run in your own account. Cua provides the app, sharing and the relay that lets your computers reach each other.

Where a Space runs#

LocationWhat it is
This computerA container or VM on the Mac, Windows or Linux PC you are using.
Another of your computersA computer you added that provides Spaces, such as a spare Mac mini.
Your own cloudA VM in your own AWS, Google Cloud or Modal account. See Choose where sandboxes run.

Cua Cloud, the hosted option, has ended. See Cua Cloud (Fleets) has ended.

Every Space runs cua-spacesd. It streams the screen, takes input through Cua Driver, and receives teleported apps and files.

How you reach a Space#

  • Directly. On the same network, or over Tailscale, your computer connects to the Space with its address and a token. No account is needed, and the traffic doesn't use the relay.
  • Through the relay. A computer set up with cua host setup joins the cua.ai relay with an outbound connection, so you don't open ports. Your other computers, and people you share a Space with, reach it through the relay. Relay use counts toward your plan's computers in use at once and remote hours.

For what the relay can and can't see, see What the relay can see.

Space ids#

KindIdComes from
Locallocal:<name>spaces.create(options): a new Space, on this computer by default
Directdirect:<host:port>spaces.add(url, token): an existing computer
Relayrelay:<machine-id>Your computers 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 computers come from your account's directory and are never written to spaces.json.

Who can do what#

You own your computers and the Spaces on them. You can share a Space with another account as a viewer or an editor, and with Teams a computer can belong to the team instead of one person. Your agents act through the cua MCP server, and you choose what each one may do. See Connect your agent.