cua devices
Enroll this device on the relay, approve, rename and revoke devices, and read the access log.
Enroll this device on the relay, approve, rename and revoke devices, and read the access log.
| Command | Description |
|---|---|
cua devices status | This device: enrolled, waiting for approval, or not enrolled. |
cua devices enroll | Enroll this device. |
cua devices approve | Approve a new device (or re-verify an expired one) from this enrolled device, by the code it shows or by its id. |
cua devices ls | Your devices and their state. |
cua devices rename | Rename a device. |
cua devices revoke | Revoke a device: it can no longer list or reach your machines. |
cua devices audit | Who accessed what, and when: enrollments, device sessions, machine access (yours and by accounts you share with), sharing changes. |
Every command also accepts the global options.
This device as a client of your cua.ai account on the relay: enroll (second factor), approve other devices, list, rename, revoke, and the audit log of who accessed what.
cua devices [OPTIONS] <COMMAND>Examples
cua devices enroll
cua devices approve K7QX-M2RP
cua devices ls
cua devices auditcua devices status#This device: enrolled, waiting for approval, or not enrolled.
cua devices status [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--relay | string | Relay URL (default $CUA_RELAY_URL, else https://relay.cua.ai). |
Examples
cua devices statuscua devices enroll#Enroll this device. Right after a fresh cua auth login it enrolls at once (and replaces this machine's older device key, if any); otherwise it shows a one-time code to approve from an enrolled device (cua devices approve <code> or the Cua Spaces app).
cua devices enroll [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--name | string | Display name (default: the host name). | |
--relay | string | Relay URL. | |
--wait | boolean | false | Wait (up to 10 minutes) until an enrolled device approves. |
Examples
cua devices enroll
cua devices enroll --name "work laptop" --waitcua devices approve#Approve a new device (or re-verify an expired one) from this enrolled device, by the code it shows or by its id.
cua devices approve [OPTIONS] [CODE]| Argument | Type | Default | Description |
|---|---|---|---|
<CODE> | string | optional | The one-time code the new device shows, or its device id (dev_…, from cua devices ls). |
| Flag | Type | Default | Description |
|---|---|---|---|
--device | string | Or the device id (cua devices ls). | |
--relay | string | Relay URL. | |
--yes | boolean | false | Do not ask for confirmation. |
Examples
cua devices approve K7QX-M2RP
cua devices approve dev_0123456789abcdef01234567cua devices ls#Your devices and their state.
cua devices ls [OPTIONS]Alias: cua devices list.
| Flag | Type | Default | Description |
|---|---|---|---|
--relay | string | Relay URL. |
Examples
cua devices ls
cua devices ls --jsoncua devices rename#Rename a device.
cua devices rename [OPTIONS] <ID> <NAME>| Argument | Type | Default | Description |
|---|---|---|---|
<ID> | string | required | Device id. |
<NAME> | string | required | New name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--relay | string | Relay URL. |
Examples
cua devices rename dev_0123456789abcdef01234567 "work phone"cua devices revoke#Revoke a device: it can no longer list or reach your machines.
cua devices revoke [OPTIONS] <ID>| Argument | Type | Default | Description |
|---|---|---|---|
<ID> | string | required | Device id. |
| Flag | Type | Default | Description |
|---|---|---|---|
--relay | string | Relay URL. | |
--yes | boolean | false | Do not ask for confirmation. |
Examples
cua devices revoke dev_0123456789abcdef01234567cua devices audit#Who accessed what, and when: enrollments, device sessions, machine access (yours and by accounts you share with), sharing changes.
cua devices audit [OPTIONS]| Flag | Type | Default | Description |
|---|---|---|---|
--limit | integer | 50 | Newest events to show. |
--relay | string | Relay URL. |
Examples
cua devices audit
cua devices audit --limit 20 --json| Code | Meaning |
|---|---|
0 | Success. |
1 | Failure, or cua do reported an error. |
2 | Invalid argument, or an ambiguous sandbox name (qualify it: local:NAME, cloud:NAME). |
3 | Not found: sandbox, window, skill or image (or an image not published yet). |
4 | Not supported, or not configured (for example no Fleet credentials). |
5 | No cua-spacesd answered, or a transport failure. |
6 | Unauthenticated or permission denied (by Cua, Fleet or your cloud account). |
7 | Not enough free disk space (see cua cache). |
130 | Cancelled (Ctrl-C during a create): what it made was removed. |