trycua / cua

Give AI agents computers they can use. Cua Spaces gives your agents full desktops on your Mac and on machines you own. This repository also holds Cua Driver for desktop automation, Lume for local VMs, CUA-S1 decision models and Cua Bench for evaluating computer-use agents. 
 Get Cua Spaces 
## Choose your path
- **Cua Spaces:** Install the app and run your first Space.
- **Cua Driver:** Operate Calculator and verify its result.
- **Lume:** Create a Tahoe VM and connect over SSH.
- **Cua SDK and CLI:** Install `cua` and create a local sandbox.
- **CUA-S1:** Explore small, specialized models for computer-use decisions.
- **Cua Bench:** Create and verify a simulated task.
Bring your own agent and model, or explore CUA-S1 for specialized decisions. Cua provides the computer and automation tools. Computer-Use 2.0 describes an agent moving between code, APIs, and graphical interfaces within the same task.
---
## Cua Spaces
Cua Spaces is a desktop app that gives your agents full desktops. Each desktop is a Space: a macOS VM built locally on your Mac, or a Linux or Omarchy image. Spaces run on your Mac, on other machines you own, and in your own cloud account (AWS, Google Cloud or Modal), and the app keeps them in your menu bar and notch.
- **Teleport.** Move a signed-in app, such as Chrome or Slack, into a Space and it opens there still signed in. Your sessions stay in the Cua Keyvault, encrypted on your Mac, and reach a Space only after you approve.
- **Multiplayer.** You and your agents work on the same desktop, each with your own cursor. Step in to make a choice, then hand the desktop back.
- **Agent-ready images.** Spaces images ship with cua-spacesd, so agents get processes, files, screenshots and input as soon as a Space starts.
https://github.com/user-attachments/assets/a2ccc86b-10d0-48c0-bee6-7ae652ba1c59
**Install on macOS 26 or later**
 [code] 
On macOS the installer selects the Cua Spaces app by default and adds the `cua` CLI. You can also download the signed `.dmg`, or get the `.pkg` from the Cua Spaces 0.9.4 release.
Spaces is free for individuals. Pro is $18 a month and Teams is $30 per seat a month, available now from 1 seat. See pricing. The app is source-available under FSL-1.1-MIT.
**Quickstart** | **Teleport an app** | **Share a Space** | **Host Spaces on a spare Mac (relay, Tailscale or SSH)** | **Your own cloud** | **App source**
---
## Cua Driver
Give your agent tools to inspect and operate native desktop apps and browsers on macOS, Windows, and Linux. Connect through the CLI, MCP, or typed SDKs. Background delivery lets agents work without moving your pointer or taking focus when the app and platform support it; see platform support for the boundaries.
**macOS / Linux**
 [code] 
**Windows (PowerShell)**
 [code] 
**Your first result:** connect your agent, ask it to compute 6 × 7 in Calculator, and have it verify that the app displays 42. The tutorial covers platform setup, permissions, and agent connection.
**Drive your first app**