Cua
Four ways to give an agent a computer: a background driver, a sandbox for any OS, benchmarks, a macOS hypervisor
What is Cua?
Computer use runs into the same wall every time — the agent needs a machine, and it cannot be the one you are working on. Cua is four answers to that, which is worth knowing before you install it, because you almost certainly want one of them rather than all four. The drivers let an agent click and type in native applications in the background, without taking the cursor or the focus away from you. The sandbox gives Linux, macOS, Windows or Android behind a single API, locally under QEMU or in the maintainers' cloud. Cua-Bench runs OSWorld and similar evaluations and exports trajectories for training. Lume creates macOS virtual machines on Apple Silicon using Apple's own virtualisation.
What can you do with Cua?
- Let an agent work while you keep the screen — The drivers send clicks and keystrokes to a native application in the background, so the cursor and the focus stay where you left them.
- One API for four operating systems — The same calls take a screenshot, click, type and run a shell command whether the machine underneath is Linux, macOS, Windows or Android.
- Run the machine locally or in the cloud — The same sandbox code runs against a local QEMU virtual machine or the maintainers' hosted fleet, so a laptop prototype moves without a rewrite.
- Reach it from an existing coding agent — The drivers ship as a command-line tool and an MCP server, so Claude Code, Cursor or Codex can drive a desktop without custom integration.
- Score an agent on published benchmarks — OSWorld, ScreenSpot and Windows Arena can be run against your agent in parallel, with the trajectories exported for training or review.
- Create macOS virtual machines on Apple Silicon — Lume builds and manages macOS and Linux virtual machines with Apple's own virtualisation framework, which is what makes a macOS sandbox possible at all.
Before you choose Cua
- It is four projects under one name. Working out which piece you need — driver, sandbox, benchmark harness or hypervisor — is the first task, and their install paths and documentation are separate.
- Background input is best supported on macOS and Windows; on Linux the project states explicit limits for raw background input depending on whether the session runs X11 or a particular Wayland compositor.
Star history
27 Aug to 30 Oct · +9.4k
Frequently asked questions
Is Cua free for commercial use?
Cua is released under the MIT licence — OSI-approved open source, which permits commercial use.
How can Cua be deployed?
Cua is available as Runs locally / Self-hosted / Managed cloud.