cua spacesd
Talk to a cua-spacesd directly by URL.
Talk to a cua-spacesd directly by URL.
| Command | Description |
|---|---|
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. |
Every command also accepts the global options.
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:3211cua 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 | Type | Default | Env var | Description |
|---|---|---|---|---|
--token | string | CUA_ENV_TOKEN | spacesd token. |
Examples
cua spacesd exec http://127.0.0.1:3211 uname -acua 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.txtcua 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:3211cua 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 --windowscua 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| 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. |