Skip to content

armgit / cua

Public Imported from GitHub
0

Scale computer-use 2.0 with open-source drivers, cross-OS sandboxes, and benchmarks for training, evaluation, and data generation.

docs(spaces): 0.9.0 install facts, Install and Plans pages, host and URL fixes (CUA-1640) (#5201)

Francesco Bonaccidfe24224a81d
diff --git a/docs/content/docs/cua-cli/guides/authentication.mdx b/docs/content/docs/cua-cli/guides/authentication.mdx
index b4195072a9..609779e2d6 100644
--- a/docs/content/docs/cua-cli/guides/authentication.mdx
+++ b/docs/content/docs/cua-cli/guides/authentication.mdx
@@ -98,7 +98,7 @@ cua auth status # starts with "Environment: staging (...)"
| Sign-in issuer | `CUA_OIDC_ISSUER` | `https://auth.cua.ai/realms/cyclops-cs` | `https://auth.staging.cua.ai/realms/cua-staging` |
| OAuth client | `CUA_OIDC_CLIENT_ID` | `cua-cli` | `cua-cli` |
| Relay | `CUA_RELAY_URL` (or `--relay`) | `https://relay.cua.ai` | `https://relay.staging.cua.ai` |
-| Spaces API | `CUA_SPACES_API_URL` | `https://api.spaces.cua.ai` | `https://api.staging.cua.ai` |
+| Spaces API | `CUA_SPACES_API_URL` | `https://api.cua.ai` | `https://api.staging.cua.ai` |
| Spaces site (add-machine links `<site>/add/<code>`) | `CUA_SPACES_SITE_URL` | `https://spaces.cua.ai` | `https://spaces.staging.cua.ai` |
| cua home | `CUA_HOME` | `~/.cua` | `~/.cua/envs/staging` |
| Keychain / Credential Manager service | none | `run.cua.ai` | `staging.run.cua.ai` |
diff --git a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
index f11f0cc86c..b5a2da3ecc 100644
--- a/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
+++ b/docs/content/docs/cua-driver/guides/connect-your-agent.mdx
@@ -106,7 +106,7 @@ Ollama or by llama.cpp with Unsloth's `UD-Q4_K_XL` GGUF. Every tool schema
costs context, so hide unused tools with the filter:
```bash skip="host-install"
-curl -fsSL https://cua.ai/docs/examples/local-models/cua-mcp-filter.py \
+curl -fsSL https://cua.ai/docs-assets/examples/local-models/cua-mcp-filter.py \
-o "$HOME/.local/bin/cua-mcp-filter" && chmod +x "$HOME/.local/bin/cua-mcp-filter"
```
diff --git a/docs/content/docs/spaces/guides/install.mdx b/docs/content/docs/spaces/guides/install.mdx
new file mode 100644
index 0000000000..8903730767
--- /dev/null
+++ b/docs/content/docs/spaces/guides/install.mdx
@@ -0,0 +1,55 @@
+---
+title: Install
+description: 'Install the Cua Spaces app and the cua CLI on macOS, Windows or Linux.'
+---
+
+import { Callout } from 'fumadocs-ui/components/callout';
+import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
+
+Cua Spaces 0.9.0 runs on macOS, Windows and Linux. One command installs the
+`cua` CLI and the app. Download buttons are on the
+[download page](https://cua.ai/download), and every installer is attached to
+the [GitHub releases](https://github.com/trycua/cua/releases).
+
+<Tabs items={['macOS', 'Windows', 'Linux']}>
+ <Tab value="macOS">
+ ```bash skip="host-install"
+ curl -fsSL https://cua.ai/install.sh | sh
+ ```
+
+ Or open the universal `.dmg` (or `.pkg`) from the release. macOS 26 or later.
+ </Tab>
+ <Tab value="Windows">
+ <Callout type="warn">
+ Cua Spaces for Windows is a preview. Expect rough edges and tell us what
+ you hit.
+ </Callout>
+
+ ```powershell skip="host-install"
+ irm https://cua.ai/install.ps1 | iex
+ ```
+
+ Or run `cua-spaces-<version>-windows-x64-setup.exe` (`windows-arm64` on Arm)
+ from the release. Windows may show a SmartScreen prompt the first time:
+ choose **More info**, then **Run anyway**.
+ </Tab>
+ <Tab value="Linux">
+ ```bash skip="host-install"
+ curl -fsSL https://cua.ai/install.sh | sh
+ ```
+
+ The installer picks the supported **.deb** on Ubuntu 24.04 (x64 and arm64).
+ To install it by hand:
+ `sudo apt install ./cua-spaces_<version>_<arch>.deb`. A portable
+ **AppImage** is also released; it is not supported and has no Keyvault. See
+ [Cua Spaces on Linux](/spaces/quickstart#cua-spaces-on-linux).
+ </Tab>
+</Tabs>
+
+At a console the installer shows a checklist first. Add `--cli-only`
+(`-CliOnly` on Windows) to install the CLI alone.
+
+## Next
+
+- [Quickstart](/spaces/quickstart)
+- [Plans](/spaces/guides/plans): what Free, Pro and Teams include.
diff --git a/docs/content/docs/spaces/guides/meta.json b/docs/content/docs/spaces/guides/meta.json
index 694455e3c3..25d5848027 100644
--- a/docs/content/docs/spaces/guides/meta.json
+++ b/docs/content/docs/spaces/guides/meta.json
@@ -1,6 +1,8 @@
{
"title": "Guides",
"pages": [
+ "install",
+ "plans",
"add-a-space",
"unattended-access",
"share-a-space",
diff --git a/docs/content/docs/spaces/guides/plans.mdx b/docs/content/docs/spaces/guides/plans.mdx
new file mode 100644
index 0000000000..a1d4be12c5
--- /dev/null
+++ b/docs/content/docs/spaces/guides/plans.mdx
@@ -0,0 +1,29 @@
+---
+title: Plans
+description: 'Cua Spaces Free, Pro and Teams: price, live sessions and relay hours.'
+---
+
+Cua Spaces is bring-your-own compute: you connect your own machines, and Cua
+does not rent them out. The plans cover the app, sharing and the hosted relay
+that lets your devices reach your machines. Current prices are on
+[cua.ai/pricing](https://cua.ai/pricing), which is the source of truth.
+
+| Plan | Price | Live sessions | Relay hours |
+| --- | --- | --- | --- |
+| Free | $0 | 2 | about 20 a month |
+| Pro | $12 a month or $120 a year, one person | 5 | 200 a month |
+| Teams | $30 per seat a month or $300 per seat a year, 2 to 100 seats | 5 per seat | 200 per seat a month, pooled across the team |
+
+A **live session** is one person viewing or driving a Space through the relay,
+such as a desktop view, a terminal or an agent's process stream. A **relay
+hour** is an hour with at least one live session, counted per calendar month
+(UTC). Spaces you reach directly, for example on your own network, do not use
+the relay.
+
+Teams has a 2-seat minimum, so 2 seats give 10 live sessions and 400 relay
+hours a month. To set up a team, see [Teams](/spaces/guides/teams).
+
+## Next
+
+- [Install](/spaces/guides/install)
+- [Teams](/spaces/guides/teams)
diff --git a/docs/content/docs/spaces/quickstart.mdx b/docs/content/docs/spaces/quickstart.mdx
index 043779393a..013c3f534a 100644
--- a/docs/content/docs/spaces/quickstart.mdx
+++ b/docs/content/docs/spaces/quickstart.mdx
@@ -1,17 +1,17 @@
---
title: Quickstart
-description: 'Install the cua CLI and, on macOS, the Cua Spaces app, run a local Space in Docker, and register it from code.'
+description: 'Install the cua CLI and the Cua Spaces app, run a local Space in Docker, and register it from code.'
---
import { Tab, Tabs } from 'fumadocs-ui/components/tabs';
-Install the cua CLI (and the macOS-only Cua Spaces app), run a Linux desktop
+Install the cua CLI and the Cua Spaces app (macOS, Windows or Linux), run a Linux desktop
locally, and register it as your first Space.
## Prerequisites
- macOS, Linux or Windows. The Cua Spaces app for macOS needs macOS 26 or
- later.
+ later. On Windows the app is a preview. See [Install](/spaces/guides/install).
- Docker, for the local Space.
### Cua Spaces on Linux
@@ -48,13 +48,13 @@ acceleration of same-architecture guests. The managed runtime is macOS-only.
</Tabs>
In a terminal it first shows a checklist: the `cua` CLI, the Cua Spaces app
-(macOS only, selected by default there), the cua-driver MCP and skill for your
-agents, and hosting this machine. On Linux and Windows the Spaces app is skipped.
-Then it signs you in and offers to set up your AI coding agents.
+(selected by default on macOS, Linux and Windows), the cua-driver MCP and skill
+for your agents, and hosting this machine. Then it signs you in and offers to set up your AI coding agents.
Flags: `--select ITEMS`, `--only ITEMS`, `--cli-only`, `--app-only`,
`--mode host|client`, `--version X`, `--no-onboarding`, `--dry-run`, `--yes`
(`-Select`, `-CliOnly`, ... on Windows). GUI installers are on
-[GitHub releases](https://github.com/trycua/cua/releases).
+[GitHub releases](https://github.com/trycua/cua/releases). See [Install](/spaces/guides/install) for
+per-platform steps.
Start the canonical Linux image with a token: