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): relay hours become remote hours; move relay pages under Advanced (#5453)

Francesco Bonacci313a63d4ea06
diff --git a/docs/content/docs/spaces/guides/host-spaces-on-your-spare-mac.mdx b/docs/content/docs/spaces/guides/host-spaces-on-your-spare-mac.mdx
index c87e0e2f3c..541e86c5b2 100644
--- a/docs/content/docs/spaces/guides/host-spaces-on-your-spare-mac.mdx
+++ b/docs/content/docs/spaces/guides/host-spaces-on-your-spare-mac.mdx
@@ -223,13 +223,6 @@ The spare Mac runs macOS Spaces as Lume VMs:
- The cua daemon on the spare Mac creates the VMs. The host's cua-spacesd
starts it when a request comes in, with the `cua` CLI that ran setup.
-<Callout type="info">
- A Space reaches the relay from inside its VM or container. With a relay on
- the spare Mac itself (a self-hosted relay on `localhost`), a container gets
- it at `host.docker.internal` and a Lume VM at the host's NAT address,
- `192.168.64.1`.
-</Callout>
-
## Troubleshooting
| Error | Meaning | Fix |
diff --git a/docs/content/docs/spaces/guides/mesh.mdx b/docs/content/docs/spaces/guides/mesh.mdx
index 09163344c9..07d6afbff9 100644
--- a/docs/content/docs/spaces/guides/mesh.mdx
+++ b/docs/content/docs/spaces/guides/mesh.mdx
@@ -64,11 +64,11 @@ The relay applies the rules you already manage:
takes it off the mesh within seconds and cuts its open connections. The
next call says why.
-## Your relay allowance
+## Your plan allowance
A desktop view, terminal or agent session over the mesh counts toward your
plan's live sessions, the same as one over the relay's HTTPS path, and one
-machine reached both ways at once counts once. Relay hours count only the
+machine reached both ways at once counts once. Remote hours count only the
time a session's traffic goes through the relay: a direct connection uses
none. `cua usage` and the app's Settings show both.
diff --git a/docs/content/docs/spaces/guides/meta.json b/docs/content/docs/spaces/guides/meta.json
index 633c668be7..5ac7cfe989 100644
--- a/docs/content/docs/spaces/guides/meta.json
+++ b/docs/content/docs/spaces/guides/meta.json
@@ -28,6 +28,7 @@
"---Keep it working---",
"updates",
"troubleshoot-create",
+ "---Advanced---",
"relay-security",
"mesh"
]
diff --git a/docs/content/docs/spaces/guides/plans.mdx b/docs/content/docs/spaces/guides/plans.mdx
index 87decb4efa..c89d96759b 100644
--- a/docs/content/docs/spaces/guides/plans.mdx
+++ b/docs/content/docs/spaces/guides/plans.mdx
@@ -8,34 +8,38 @@ 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 |
+| Plan | Price | Live sessions | Remote hours |
| --- | --- | --- | --- |
| Free | $0 | 2 | 20 a month |
| Pro | $18 a month or $180 a year, one person | 5 | 200 a month |
| Teams | $30 per seat a month or $300 per seat a year, 1 to 100 seats | 5 per seat | 200 per seat a month, pooled across the team |
Every plan includes Spaces on every computer you connect, Teleport and sharing a
-Space with named people. Pro adds more live sessions and relay hours. Teams adds
+Space with named people. Pro adds more live sessions and remote hours. Teams adds
team-owned machines, roles and device approval. SSO and audit export are not
included yet.
## What counts toward the limits
-A **live session** is one person or agent holding a stream open to a machine
-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).
+**Remote hours** are the time you spend using your computers from somewhere
+else. Using a computer from itself is free.
+
+In detail, a **live session** is one person or agent holding a stream open to a
+machine through the relay, such as a desktop view, a terminal or an agent's
+process stream. Each hour with at least one live session counts as one remote
+hour, per calendar month (UTC).
Spaces you reach directly, for example on your own network, don't use the relay
and don't count.
## See your usage
-Open **Settings** in Cua Spaces. **Relay usage** reads like "Live sessions 1 of
-2 · Relay hours 6.5 of 20 this month", and the plan card shows your plan. To read
-the same numbers in a terminal, run `cua usage`.
+Open **Settings** in Cua Spaces. The usage row shows your live sessions and
+remote hours this month, for example 1 of 2 live sessions and 6.5 of 20 remote
+hours, and the plan card shows your plan. To read the same numbers in a
+terminal, run `cua usage`.
-When you have used 80% of your relay hours, the app shows a notice with an
+When you have used 80% of your remote hours, the app shows a notice with an
**Upgrade** button. Nothing stops at the limit: your Spaces keep working.
## Upgrade to Pro
@@ -53,7 +57,7 @@ no refund for partial months. Change or cancel a plan at any time on the
## Start a team
Teams starts at 1 seat, so you can begin with just yourself. Each seat adds to
-one pool the whole team shares: 2 seats give 10 live sessions and 400 relay hours
+one pool the whole team shares: 2 seats give 10 live sessions and 400 remote hours
a month. To buy Teams, invite people and manage seats, see
[Teams](/spaces/guides/teams).
diff --git a/docs/content/docs/spaces/guides/relay-security.mdx b/docs/content/docs/spaces/guides/relay-security.mdx
index afcab0b620..4aad3f9cf4 100644
--- a/docs/content/docs/spaces/guides/relay-security.mdx
+++ b/docs/content/docs/spaces/guides/relay-security.mdx
@@ -1,11 +1,11 @@
---
title: What the relay can see
-description: 'A plain accounting of what relay.cua.ai (or any self-hosted cua-relay) can and cannot see, and what we have done and are still doing about it.'
+description: 'A plain accounting of what relay.cua.ai can and cannot see, and what we have done and are still doing about it.'
---
import { Callout } from 'fumadocs-ui/components/callout';
-`relay.cua.ai` (and any self-hosted `cua-relay`) is a **trusted, TLS-terminating
+`relay.cua.ai` is a **trusted, TLS-terminating
proxy, not a blind relay**. This page says plainly what that means, kept
current as the relay changes. If anything here reads as a surprise, it is a
bug in this page: tell us.
diff --git a/docs/content/docs/spaces/guides/teams/faq.mdx b/docs/content/docs/spaces/guides/teams/faq.mdx
index d128bae2b0..583c995be3 100644
--- a/docs/content/docs/spaces/guides/teams/faq.mdx
+++ b/docs/content/docs/spaces/guides/teams/faq.mdx
@@ -46,7 +46,7 @@ invoices, not a cash refund. The minimum is 1 seat, the maximum 100.
## What if we use more than the pool?
Nothing is cut off. The Cua Spaces app shows a notice with an Upgrade button.
-See [Teams](/spaces/guides/teams) for what a live session and a relay hour are.
+See [Teams](/spaces/guides/teams) for what a live session and a remote hour are.
## Which Spaces count against the pool?
diff --git a/docs/content/docs/spaces/guides/teams/index.mdx b/docs/content/docs/spaces/guides/teams/index.mdx
index 5006aab186..9d2151bc3c 100644
--- a/docs/content/docs/spaces/guides/teams/index.mdx
+++ b/docs/content/docs/spaces/guides/teams/index.mdx
@@ -16,15 +16,16 @@ Cua does not rent them ([FAQ](/spaces/guides/teams/faq)).
| Price | $30 per seat a month, or $300 per seat a year (two months free) |
| Seats | 1 to 100 |
| Includes | Everything in Pro, plus team machines, roles and device approval |
-| Usage | Each seat adds 5 live sessions and 200 relay hours a month to one pool the whole team shares |
+| Usage | Each seat adds 5 live sessions and 200 remote hours a month to one pool the whole team shares |
You can start with 1 seat, just you, and add seats as people join. Two seats
-give 10 live sessions and 400 relay hours a month for the team.
+give 10 live sessions and 400 remote hours a month for the team.
-A **live session** is one person or agent holding a stream open to a machine
-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 on your own network or reached directly do not go
+**Remote hours** are the time your team spends using its computers from
+somewhere else; using a computer from itself is free. A **live session** is one
+person or agent holding a stream open to a machine through the relay, such as a
+desktop view, a terminal or an agent's process stream. Each hour with at least
+one live session counts as one remote hour, per calendar month (UTC). Spaces on your own network or reached directly do not go
through the relay and do not count. If the team goes over, nothing is cut off:
the Cua Spaces app shows a notice with an Upgrade button.
diff --git a/docs/content/docs/spaces/guides/unattended-access.mdx b/docs/content/docs/spaces/guides/unattended-access.mdx
index 7ac5bb20c4..99fdaaebbe 100644
--- a/docs/content/docs/spaces/guides/unattended-access.mdx
+++ b/docs/content/docs/spaces/guides/unattended-access.mdx
@@ -30,7 +30,7 @@ machine is shared with, or enroll devices.
|--------|--------|
| `--remote` | When sign-in is needed, print a device code to approve in a browser on another machine (for example over SSH). The account session is not saved. Cannot be combined with `--direct`. |
| `--direct ip:port` | Serve on your LAN (or a forwarded port) with a local env token instead of the relay. No account needed. |
-| `--relay URL` | Another relay (`CUA_RELAY_URL`, default `https://relay.cua.ai`); any self-hosted `cua-relay` works. |
+| `--relay URL` | Use a different relay (`CUA_RELAY_URL`). The default is `https://relay.cua.ai`. |
| `--name NAME` | Display name (default: host name). |
| `--allow ACCOUNT` | Also allow this account (id or email). Repeatable. |
| `--runner KIND` | `auto`, `systemd`, `launchd`, `windows-task` or `process`. |