Computers and teams

Your computers, unattended access on this computer, teams, sharing, your remote use this month, and a cua-spacesd by URL.

Command	Description
`cua machines`	Your computers on the relay: remove one that is gone.
`cua machines rm`	Remove a computer that is gone: its row leaves your relay directory, then the signed-in device with exactly its name is revoked (never this device; nothing when several match).
`cua host`	Unattended access to this computer (setup, status, stop, start, remove).
`cua host setup`	Set this computer up for unattended access: install cua-spacesd as a service that joins the cua.ai relay as your account (default) or serves on a direct ip:port.
`cua host pair`	Make a one-time code (with a link and the install command) that adds another computer to your account: run the command it prints on that computer.
`cua host config`	Show or change what this computer shares: its own desktop, and whether it creates Spaces for your other devices.
`cua host cache`	What the repo cache holds, and empty it.
`cua host cache status`	What the repo cache holds: repositories, size and what the last week saved.
`cua host cache fill`	Copy one public repository into the cache now, instead of when a Space first clones it (or bring a copy up to date).
`cua host cache clear`	Delete every repository the cache holds.
`cua host status`	Show whether this computer is set up, the service, and who is connected.
`cua host stop`	Stop sharing: disconnect everyone and refuse new connections.
`cua host start`	Start sharing again after `stop`.
`cua host share`	Share a relay computer (this one, or `--machine`) with people in your team (id or verified email).
`cua host unshare`	Stop sharing a relay computer with accounts; their open connections are cut.
`cua host migrate`	macOS: move the host service into the Cua Spaces app, as its "Cua Spaces Helper" login item, from the LaunchAgent that older versions installed.
`cua host remove`	Unregister from the relay, uninstall the service and delete the host configuration (asks first).
`cua devices`	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 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 signed-in machines and their state.
`cua devices rename`	Rename a device.
`cua devices revoke`	Revoke a device: it can no longer list or reach your computers.
`cua devices audit`	Who accessed what, and when: enrollments, device sessions, computer access (yours and by accounts you share with), sharing changes.
`cua team`	Teams (organizations of your cua.ai account) share computers with every member and their agents.
`cua team create`	Create a team; you are its owner.
`cua team ls`	Your teams.
`cua team show`	A team: plan, members, computers, open invites and devices.
`cua team invite`	Invite someone by email: cua.ai emails them an invitation.
`cua team join`	After accepting an emailed invitation: take the role it offered.
`cua team leave`	Leave a team.
`cua team remove-member`	Remove a member (owner or admin; admins cannot remove admins).
`cua team set-role`	Make a member an admin, or an admin a member (owner).
`cua team devices`	Member devices and whether they may open team computers.
`cua team approve`	Approve a member device so it can open team computers.
`cua team deny`	Decline a member device (it can no longer open team computers).
`cua team request`	Ask the team's admins to approve this device.
`cua team add-machine`	Make a Space (or a computer you host) a team computer: every member and their agents see it and can open it.
`cua team remove-machine`	Take a computer off the team.
`cua team audit`	The team's audit log.
`cua team delete`	Delete a team (owner; cancel its subscription first).
`cua usage`	Your remote use this month: live sessions, remote hours, and your plan.
`cua spacesd`	Talk to a cua-spacesd directly by URL.
`cua spacesd caps`	Print capabilities.
`cua spacesd exec`	Run a command (argv, no shell).
`cua spacesd cp`	Copy files: `cua spacesd cp <URL> local :remote` uploads, `cua spacesd cp <URL> :remote local` downloads.
`cua spacesd shell`	Interactive shell (PTY).
`cua spacesd targets`	List streamable targets (displays, and windows with --windows).
`cua spacesd call`	Call any cua.env.v1 RPC with a proto3-JSON body.
`cua share`	Share a link to a port, a file or a folder that opens on your other signed-in devices (never localhost): `cua share 3000`, `cua share ./report.html`, `cua share ls`, `cua share stop ID`.
`cua share ls`	List the active shares.
`cua share stop`	Stop a share (its link stops working at once), or `all`.
`cua share check`	Open a share's link once, as its owner, and say what came back.

Every command also accepts the global options.

`cua machines`#

Your computers on the relay: remove one that is gone.

cua machines [OPTIONS] <COMMAND>

`cua machines rm`#

Remove a computer that is gone: its row leaves your relay directory, then the signed-in device with exactly its name is revoked (never this device; nothing when several match). A computer that is connected now is refused: run cua host remove on it.

cua machines rm [OPTIONS] <NAME>

Argument	Type	Default	Description
`<NAME>`	string	required	The computer's name, machine id or `relay:<id>` (`cua spaces ls`).

Flag	Short	Type	Default	Description
`--yes`	`-y`	boolean	`false`	Remove without asking.

Examples

cua machines rm old-laptop
cua machines rm relay:0123abcd4567ef89 --yes --json

`cua host`#

Unattended access to this computer (setup, status, stop, start, remove).

cua host [OPTIONS] <COMMAND>

`cua host setup`#

Set this computer up for unattended access: install cua-spacesd as a service that joins the cua.ai relay as your account (default) or serves on a direct ip:port. By default it shares this computer's desktop and, on a computer set up for the first time through the relay, provides Spaces to your devices (a host in your pool: cua run jobs and --on auto Spaces can run here, within its limits). --share picks what it shares: desktop, spaces (its own desktop stays private), both or none; cua host config changes it later. A computer set up before keeps what it provides. Running it again with the same options changes nothing (a stopped service starts again).

cua host setup [OPTIONS]

Flag	Type	Default	Description
`--pair`	string		Join with a one-time pairing code (or add-machine link) made in the Cua Spaces app or with `cua host pair`, instead of signing in here. The computer joins the account (or team) that made it.
`--name`	string		Display name (default: the host name).
`--allow`	string		Also allow this account (id or email). Repeatable.
`--driver-bin`	path		cua-spacesd binary (default $CUA_SPACESD_BIN, a bundled one, or the release download).
`--runner`	string	`auto`	auto \| systemd \| launchd \| app-helper \| windows-task \| process. On a Mac with the Cua Spaces app, auto is app-helper: the service runs as the app's own login item ("Cua Spaces").
`--share`	`desktop` \| `spaces` \| `both` \| `none`		What this computer shares: its own desktop (screen, input, shell, files), the Spaces it creates for your enrolled devices (Lume macOS VMs, Docker Linux containers), both, or neither (refused). Default: the desktop, plus Spaces on a new relay setup; a computer set up before keeps what it provides.
`--max-spaces`	integer		Provided Spaces at once (default 4; 0: no limit).
`--remote`	boolean	`false`	When sign-in is needed, use a device code to approve it in a browser on another computer. The account session is not saved.
`--dedicated`	boolean	`false`	This computer exists only for Cua work (a cloud instance made for it; `cua cloud add aws` sets its hosts up this way): jobs may run in its own Space (`kind = "machine"`), with its GPU and drivers as they are. Never on a computer you also use: there jobs run in macOS VMs or containers.

Examples

# Join the cua.ai relay as your account (shares this desktop and provides Spaces to your devices)
cua host setup
 
# Share this desktop only
cua host setup --share desktop
 
# A spare computer: do not share its desktop, run Spaces for your devices
cua host setup --share spaces --name "Mac mini (spare)"
 
# Add this computer with a one-time code from the Cua Spaces app (Add a computer) or `cua host pair`: no sign-in needed here
cua host setup --pair K7QM-4XPB-2RHD

`cua host pair`#

Make a one-time code (with a link and the install command) that adds another computer to your account: run the command it prints on that computer. Codes work once and expire (30 minutes by default). Run from an enrolled device.

cua host pair [OPTIONS]

Flag	Type	Default	Description
`--team`	string		Add the computer to this team (id, alias or name; owner or admin): waits until the computer joins, then makes it a team computer.
`--name`	string		Name the computer gets (default: its own host name).
`--expires`	integer	`30`	Minutes until the code expires (1 to 1440).
`--revoke`	string		Revoke an unused code by id (`pc_…`).
`--no-wait`	boolean	`false`	With --team: print the code and exit instead of waiting; add the computer later with `cua team add-machine <team> relay:<id>`.
`--list`	boolean	`false`	List your codes (used, unused, revoked, expired) instead.

Examples

cua host pair
cua host pair --name build-box --expires 60
cua host pair --list
cua host pair --revoke pc_0123456789abcdef
 
# Add the computer to a team: waits for it to join, then adds it
cua host pair --team AIGIS

`cua host config`#

Show or change what this computer shares: its own desktop, and whether it creates Spaces for your other devices.

cua host config [OPTIONS]

Flag	Type	Description
`--desktop`	`on` \| `off`	Share this computer's own desktop: on \| off.
`--provide-spaces`	`on` \| `off`	Create Spaces for your enrolled devices: on \| off.
`--max-spaces`	integer	Provided Spaces at once (0: no limit).
`--max-macos-vms`	integer	macOS VMs at once, 0 to 2 (Apple's license allows two per Mac).
`--max-memory`	integer	Memory in GB the Spaces other machines create here may use in total (0: no limit).
`--max-disk`	integer	Disk in GB the Spaces other machines create here may use in total (0: no limit).
`--max-run-time`	integer	Minutes a Space created here by another machine may run before it is stopped (0: no limit).
`--repo-cache`	`on` \| `off`	The repo cache: on \| off. It keeps verified copies of public git repositories on this machine so a repeat `git clone` in a Space starts from one (never private repositories, never anything off this machine's disk).
`--repo-cache-size`	string	The most disk the repo cache may use, in GB (`auto`: the smaller of 5 GB and a tenth of the free disk). The least recently used repositories go first.

Examples

cua host config
 
# Stop sharing this desktop; keep providing Spaces
cua host config --desktop off --provide-spaces on
cua host config --max-spaces 6
 
# Give the Spaces other machines create here at most 32 GB of memory and 200 GB of disk in total, and stop each after 8 hours (0: no limit)
cua host config --max-memory 32 --max-disk 200 --max-run-time 480
 
# Keep no copies of public git repositories on this machine, or at most 2 GB
cua host config --repo-cache off
cua host config --repo-cache on --repo-cache-size 2

`cua host cache`#

What the repo cache holds, and empty it.

cua host cache [OPTIONS] <COMMAND>

`cua host cache status`#

What the repo cache holds: repositories, size and what the last week saved.

cua host cache status [OPTIONS]

Examples

cua host cache status

`cua host cache fill`#

Copy one public repository into the cache now, instead of when a Space first clones it (or bring a copy up to date). A repository that needs a sign-in is never cached.

cua host cache fill [OPTIONS] <URL>

Argument	Type	Default	Description
`<URL>`	string	required	The repository's `https` address.

Examples

cua host cache fill https://github.com/vitejs/vite

`cua host cache clear`#

Delete every repository the cache holds. They are copied again the next time a Space clones them.

cua host cache clear [OPTIONS]

Examples

cua host cache clear

`cua host status`#

Show whether this computer is set up, the service, and who is connected.

cua host status [OPTIONS]

Examples

cua host status

`cua host stop`#

Stop sharing: disconnect everyone and refuse new connections.

cua host stop [OPTIONS]

Examples

cua host stop

`cua host start`#

Start sharing again after stop.

cua host start [OPTIONS]

Examples

cua host start

`cua host share`#

Share a relay computer (this one, or --machine) with people in your team (id or verified email). Run from an enrolled device; every change is in the owner's audit log (cua devices audit).

cua host share [OPTIONS] <WHO>...

Argument	Type	Default	Description
`<WHO>...`	string	required	Accounts to add. Repeatable. Repeatable.

Flag	Type	Default	Description
`--machine`	string		Computer id (default: this computer). Alias: `--computer`.
`--yes`	boolean	`false`	Do not ask for confirmation.

Examples

cua host share friend@example.com
cua host share friend@example.com --machine 0123abcd4567ef89 --yes

`cua host unshare`#

Stop sharing a relay computer with accounts; their open connections are cut.

cua host unshare [OPTIONS] <WHO>...

Argument	Type	Default	Description
`<WHO>...`	string	required	Accounts to remove. Repeatable. Repeatable.

Flag	Type	Default	Description
`--machine`	string		Computer id (default: this computer). Alias: `--computer`.

Examples

cua host unshare friend@example.com

`cua host migrate`#

macOS: move the host service into the Cua Spaces app, as its "Cua Spaces Helper" login item, from the LaunchAgent that older versions installed. This machine keeps its id, registration and Spaces; if the helper does not take over, the old service is put back. macOS then asks once for Screen Recording and Accessibility for Cua Spaces Helper.

cua host migrate [OPTIONS]

Flag	Type	Default	Description
`--force`	boolean	`false`	Try again even if a move failed before with this version.

Examples

cua host migrate
 
# Try again after a move that was rolled back
cua host migrate --force

`cua host remove`#

Unregister from the relay, uninstall the service and delete the host configuration (asks first).

cua host remove [OPTIONS]

Flag	Short	Type	Default	Description
`--force`	`-f`	boolean	`false`	Skip the confirmation prompt. Required when there is no terminal to ask on (scripts, agents): without it nothing is removed.
`--uninstalling`		boolean	`false`	For an uninstall of Cua Spaces: turns off the Spaces this computer provides and takes them off the relay too, instead of refusing while it provides any. The Spaces and their data stay on this computer.

Examples

cua host remove
 
# Without the prompt (required in scripts and agents)
cua host remove --force

`cua devices`#

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 audit

`cua devices status`#

This device: enrolled, waiting for approval, or not enrolled.

cua devices status [OPTIONS]

Examples

cua devices status

`cua devices enroll`#

Enroll this device. Right after a fresh cua auth login it enrolls at once (and replaces this computer'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).
`--wait`	boolean	`false`	Wait (up to 10 minutes) until an enrolled device approves.

Examples

cua devices enroll
cua devices enroll --name "work laptop" --wait

`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 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`).
`--yes`	boolean	`false`	Do not ask for confirmation.

Examples

cua devices approve K7QX-M2RP
cua devices approve dev_0123456789abcdef01234567

`cua devices ls`#

Your signed-in machines and their state.

cua devices ls [OPTIONS]

Alias: cua devices list.

Examples

cua devices ls
cua devices ls --json

`cua 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.

Examples

cua devices rename dev_0123456789abcdef01234567 "work phone"

`cua devices revoke`#

Revoke a device: it can no longer list or reach your computers.

cua devices revoke [OPTIONS] <ID>

Argument	Type	Default	Description
`<ID>`	string	required	Device id.

Flag	Type	Default	Description
`--yes`	boolean	`false`	Do not ask for confirmation.

Examples

cua devices revoke dev_0123456789abcdef01234567

`cua devices audit`#

Who accessed what, and when: enrollments, device sessions, computer 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.

Examples

cua devices audit
cua devices audit --limit 20 --json

`cua team`#

Teams (organizations of your cua.ai account) share computers with every member and their agents. Owners and admins invite by email, approve member devices and add computers.

cua team [OPTIONS] <COMMAND>

Examples

cua team create AIGIS
cua team invite AIGIS dillon@example.com
cua team add-machine AIGIS local:build-box
cua team approve AIGIS dev_0123456789abcdef01234567
cua team show AIGIS

`cua team create`#

Create a team; you are its owner. Buy Teams for it at app.cua.ai to add computers.

cua team create [OPTIONS] <NAME>

Argument	Type	Default	Description
`<NAME>`	string	required	Team name.

Examples

cua team create "AIGIS"

`cua team ls`#

Your teams.

cua team ls [OPTIONS]

Alias: cua team list.

Examples

cua team ls
cua team ls --json

`cua team show`#

A team: plan, members, computers, open invites and devices.

cua team show [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Examples

cua team show AIGIS

`cua team invite`#

Invite someone by email: cua.ai emails them an invitation. Manage invites at app.cua.ai/team.

cua team invite [OPTIONS] <TEAM> <EMAIL>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<EMAIL>`	string	required	Their email.

Flag	Type	Default	Description
`--role`	`member` \| `admin`	`member`	`member` or `admin` (only the owner invites admins).

Examples

cua team invite AIGIS dillon@example.com
cua team invite AIGIS ops@example.com --role admin

`cua team join`#

After accepting an emailed invitation: take the role it offered. Run cua auth login first so your session lists the team.

cua team join [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Examples

cua team join AIGIS

`cua team leave`#

Leave a team.

cua team leave [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Examples

cua team leave AIGIS

`cua team remove-member`#

Remove a member (owner or admin; admins cannot remove admins).

cua team remove-member [OPTIONS] <TEAM> <WHO>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<WHO>`	string	required	Their email or account id.

Examples

cua team remove-member AIGIS bob@example.com

`cua team set-role`#

Make a member an admin, or an admin a member (owner).

cua team set-role [OPTIONS] <TEAM> <WHO> <ROLE>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<WHO>`	string	required	Their email or account id.
`<ROLE>`	`member` \| `admin`	required	`member` or `admin`.

Examples

cua team set-role AIGIS bob@example.com admin

`cua team devices`#

Member devices and whether they may open team computers.

cua team devices [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Examples

cua team devices AIGIS

`cua team approve`#

Approve a member device so it can open team computers.

cua team approve [OPTIONS] <TEAM> <DEVICE>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<DEVICE>`	string	required	Device id (`cua team devices`).

Examples

cua team approve AIGIS dev_0123456789abcdef01234567

`cua team deny`#

Decline a member device (it can no longer open team computers).

cua team deny [OPTIONS] <TEAM> <DEVICE>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<DEVICE>`	string	required	Device id.

Examples

cua team deny AIGIS dev_0123456789abcdef01234567

`cua team request`#

Ask the team's admins to approve this device.

cua team request [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Examples

cua team request AIGIS

`cua team add-machine`#

Make a Space (or a computer you host) a team computer: every member and their agents see it and can open it. Macs, Linux and Windows computers all can. Each Space is added on its own: adding a host does not add the Spaces it provides.

cua team add-machine [OPTIONS] <TEAM> <SPACE>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<SPACE>`	string	required	Space id or name (`relay:<id>` for a computer you host).

Flag	Type	Default	Description
`--yes`	boolean	`false`	Confirm without a prompt.

Examples

cua team add-machine AIGIS local:build-box
cua team add-machine AIGIS relay:0123abcd4567ef89 --yes

`cua team remove-machine`#

Take a computer off the team.

cua team remove-machine [OPTIONS] <TEAM> <COMPUTER>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.
`<COMPUTER>`	string	required	The computer (`relay:<id>` or its id, as `cua team show` lists it).

Examples

cua team remove-machine AIGIS relay:0123abcd4567ef89

`cua team audit`#

The team's audit log. Audit export is coming soon; for now see the account app (app.cua.ai).

cua team audit [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Flag	Type	Default	Description
`--limit`	integer	`50`	Newest events to show (when export arrives).

Examples

cua team audit AIGIS

`cua team delete`#

Delete a team (owner; cancel its subscription first). Its computers stay yours.

cua team delete [OPTIONS] <TEAM>

Argument	Type	Default	Description
`<TEAM>`	string	required	Team id, alias or name.

Flag	Type	Default	Description
`--yes`	boolean	`false`	Do not ask for confirmation.

Examples

cua team delete AIGIS --yes

`cua usage`#

Your remote use this month: live sessions, remote hours, and your plan. Remote hours are time spent using your computers from somewhere else; using a computer from itself is free.

cua usage [OPTIONS]

Examples

cua usage
cua usage --json

`cua spacesd`#

Talk to a cua-spacesd directly by URL.

cua spacesd [OPTIONS] <COMMAND>

`cua spacesd caps`#

Print capabilities.

cua spacesd caps [OPTIONS] <URL>

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).

Flag	Type	Default	Env var	Description
`--token`	string		`CUA_ENV_TOKEN`	spacesd token.

Examples

cua spacesd caps http://127.0.0.1:3211

`cua spacesd exec`#

Run a command (argv, no shell).

cua spacesd exec [OPTIONS] <URL> <COMMAND>...

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).
`<COMMAND>...`	string	required	Program and arguments. Repeatable.

Flag	Short	Type	Default	Env var	Description
`--user`		string			Run as this guest user.
`--cwd`		string			Start in this guest directory.
`--timeout`		integer			Stop the command after this many seconds (0: no limit).
`--token`		string		`CUA_ENV_TOKEN`	spacesd token.
`--stdin`	`-i`	boolean	`false`		Stream: run the command as argv (no shell), forward this command's stdin, write stdout and stderr as they arrive, set no time limit, pass SIGINT/SIGTERM/SIGHUP on, and kill the command when this process ends. Exits with the command's status (128 + n for signal n).

Examples

cua spacesd exec http://127.0.0.1:3211 uname -a
 
# A long-lived stdio stream (stdin forwarded, no time limit, killed with this command)
cua spacesd exec -i http://127.0.0.1:3211 cat

`cua spacesd cp`#

Copy files: cua spacesd cp <URL> local :remote uploads, cua spacesd cp <URL> :remote local downloads.

cua spacesd cp [OPTIONS] <URL> <SRC> <DST>

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).
`<SRC>`	string	required	Source: a local path, or `:/guest/path`.
`<DST>`	string	required	Destination: a local path, or `:/guest/path`.

Flag	Type	Default	Env var	Description
`--token`	string		`CUA_ENV_TOKEN`	spacesd token.

Examples

# Upload
cua spacesd cp http://127.0.0.1:3211 ./notes.txt :/tmp/notes.txt
 
# Download
cua spacesd cp http://127.0.0.1:3211 :/tmp/notes.txt ./notes.txt

`cua spacesd shell`#

Interactive shell (PTY).

cua spacesd shell [OPTIONS] <URL>

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).

Flag	Type	Default	Env var	Description
`--token`	string		`CUA_ENV_TOKEN`	spacesd token.

Examples

cua spacesd shell http://127.0.0.1:3211

`cua spacesd targets`#

List streamable targets (displays, and windows with --windows).

cua spacesd targets [OPTIONS] <URL>

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).

Flag	Type	Default	Env var	Description
`--token`	string		`CUA_ENV_TOKEN`	spacesd token.
`--windows`	boolean	`false`		Include window targets.

Examples

cua spacesd targets http://127.0.0.1:3211 --windows

`cua spacesd call`#

Call any cua.env.v1 RPC with a proto3-JSON body.

cua spacesd call [OPTIONS] <URL> <METHOD> [BODY]

Argument	Type	Default	Description
`<URL>`	string	required	spacesd URL (`http://host:port`).
`<METHOD>`	string	required	`Service/Method`.
`<BODY>`	string	`{}`	Request body (proto3 JSON).

Flag	Type	Default	Env var	Description
`--token`	string		`CUA_ENV_TOKEN`	spacesd token.

Examples

cua spacesd call http://127.0.0.1:3211 SystemService/GetCapabilities

`cua share`#

Share a link to a port, a file or a folder that opens on your other signed-in devices (never localhost): cua share 3000, cua share ./report.html, cua share ls, cua share stop ID.

cua share [OPTIONS] <TARGET>
       cua share <COMMAND>

Argument	Type	Default	Description
`<TARGET>`	string	required	What to share: a port (`3000`), a port in a Space (`space:NAME:3000`), or a file or folder (`./report.html`, `./build/`). Paths are read-only; use `./ls` for a file called `ls`.

Flag	Type	Default	Description
`--ttl`	string		How long the share lasts (`10m`, `1h`, 60s to 24h). Public shares default to 1h; the others have no end unless you set one.
`--name`	string		A name for `cua share ls` (and `cua share stop NAME`).
`--team`	boolean	`false`	Share with the members of your team.
`--public`	boolean	`false`	Anyone with the link can open it. Expires (default 1h, 60s to 24h).

Examples

# A dev server on this machine, for your own devices (phone included)
cua share 3000
 
# A port inside a Space
cua share space:dev:3000
 
# A report or a folder, read-only
cua share ./report.html
cua share ./build/
 
# Members of your team
cua share 3000 --team
 
# Anyone with the link, for an hour
cua share ./report.html --public --ttl 1h
 
# What is shared, and stop it
cua share ls
cua share stop share-1a2b3c4d5e6f
cua share stop all

`cua share ls`#

List the active shares.

cua share ls [OPTIONS]

Examples

# What is shared right now
cua share ls
 
# The same as JSON
cua share ls --json

`cua share stop`#

Stop a share (its link stops working at once), or all.

cua share stop [OPTIONS] <ID>

Argument	Type	Default	Description
`<ID>`	string	required	The share's id or name from `cua share ls`, or `all`.

Examples

# Stop one share by its id
cua share stop share-1a2b3c4d5e6f
 
# Stop everything this machine shares
cua share stop all

`cua share check`#

Open a share's link once, as its owner, and say what came back.

cua share check [OPTIONS] <ID> [PATH]

Argument	Type	Default	Description
`<ID>`	string	required	The share's id or name.
`<PATH>`	string	optional	A path below the link to open.

Examples

# Does the link load?
cua share check share-1a2b3c4d5e6f
 
# Open a page below the link
cua share check share-1a2b3c4d5e6f /index.html

Exit codes#

Code	Meaning
`0`	Success.
`1`	Failure, or `cua do` reported an error.
`2`	Invalid argument, or an ambiguous sandbox name (qualify it: `local:NAME`).
`3`	Not found: sandbox, window, skill or image (or an image not published yet).
`4`	Not supported, or not configured (for example no provider credentials).
`5`	No cua-spacesd answered, or a transport failure.
`6`	Unauthenticated or permission denied (by Cua or your cloud account).
`7`	Not enough free disk space (see `cua cache`).
`8`	No room on the machine: its VMs are at their memory or CPU limit, or it is low on memory.
`130`	Cancelled (Ctrl-C during a create): what it made was removed.

Computers and teams

cua machines#

cua machines rm#

cua host#

cua host setup#

cua host pair#

cua host config#

cua host cache#

cua host cache status#

cua host cache fill#

cua host cache clear#

cua host status#

cua host stop#

cua host start#

cua host share#

cua host unshare#

cua host migrate#

cua host remove#

cua devices#

cua devices status#

cua devices enroll#

cua devices approve#

cua devices ls#

cua devices rename#

cua devices revoke#

cua devices audit#

cua team#

cua team create#

cua team ls#

cua team show#

cua team invite#

cua team join#

cua team leave#

cua team remove-member#

cua team set-role#

cua team devices#

cua team approve#

cua team deny#

cua team request#

cua team add-machine#

cua team remove-machine#

cua team audit#

cua team delete#

cua usage#

cua spacesd#

cua spacesd caps#

cua spacesd exec#

cua spacesd cp#

cua spacesd shell#

cua spacesd targets#

cua spacesd call#

cua share#

cua share ls#

cua share stop#

cua share check#

Exit codes#

`cua machines`#

`cua machines rm`#

`cua host`#

`cua host setup`#

`cua host pair`#

`cua host config`#

`cua host cache`#

`cua host cache status`#

`cua host cache fill`#

`cua host cache clear`#

`cua host status`#

`cua host stop`#

`cua host start`#

`cua host share`#

`cua host unshare`#

`cua host migrate`#

`cua host remove`#

`cua devices`#

`cua devices status`#

`cua devices enroll`#

`cua devices approve`#

`cua devices ls`#

`cua devices rename`#

`cua devices revoke`#

`cua devices audit`#

`cua team`#

`cua team create`#

`cua team ls`#

`cua team show`#

`cua team invite`#

`cua team join`#

`cua team leave`#

`cua team remove-member`#

`cua team set-role`#

`cua team devices`#

`cua team approve`#

`cua team deny`#

`cua team request`#

`cua team add-machine`#

`cua team remove-machine`#

`cua team audit`#

`cua team delete`#

`cua usage`#

`cua spacesd`#

`cua spacesd caps`#

`cua spacesd exec`#

`cua spacesd cp`#

`cua spacesd shell`#

`cua spacesd targets`#

`cua spacesd call`#

`cua share`#

`cua share ls`#

`cua share stop`#

`cua share check`#