cua cloud
Your own AWS, Google Cloud or Modal account as a place for sandboxes and Spaces: connect, test, status, sweep.
Your own AWS, Google Cloud or Modal account as a place for sandboxes and Spaces: connect, test, status, sweep.
| Command | Description |
|---|---|
cua cloud status | Your clouds: found credentials, the connected account and region, what each runs at what hourly cost, and what Cua created there. |
cua cloud connect | Connect a cloud account Spaces can be created in (after the checks cua cloud test runs). |
cua cloud test | Check a cloud account without creating anything: credentials, permissions (by dry run), quota, the region and machine types. |
cua cloud disconnect | Forget a connected cloud (nothing in it is deleted). |
cua cloud sweep | Find what Cua left in your clouds: expired Spaces and resources whose Space is gone (with --all, every Cua resource). |
Every command also accepts the global options.
Spaces in your own cloud account (AWS, Google Cloud, Modal): connect, status, test, disconnect, sweep.
cua cloud [OPTIONS] <COMMAND>Examples
cua cloud status
cua cloud connect aws --region us-west-2 --default
cua spaces create --on aws
cua cloud sweepcua cloud status#Your clouds: found credentials, the connected account and region, what each runs at what hourly cost, and what Cua created there.
cua cloud status [OPTIONS] [PROVIDER]Alias: cua cloud ls.
| Argument | Type | Default | Description |
|---|---|---|---|
<PROVIDER> | string | optional | Only this cloud (aws, gcp, modal). |
Examples
cua cloud status
cua cloud status aws --jsoncua cloud connect#Connect a cloud account Spaces can be created in (after the checks cua cloud test runs). Credentials stay in the cloud's own CLI; Cua stores only the profile, region, project or environment names.
cua cloud connect [OPTIONS] <PROVIDER>| Argument | Type | Default | Description |
|---|---|---|---|
<PROVIDER> | string | required | aws, gcp or modal. |
| Flag | Type | Default | Description |
|---|---|---|---|
--profile | string | AWS profile (~/.aws/config) or Modal profile (~/.modal.toml). | |
--region | string | AWS or Google Cloud region. | |
--zone | string | Google Cloud zone (default: the region's -a zone). | |
--project | string | Google Cloud project (default: gcloud config get project). | |
--environment | string | Modal environment (default: the profile's). | |
--ttl-hours | integer | Delete each Space there after this many hours (default 8; 0: never; Modal caps a sandbox at 24). | |
--default | boolean | false | Also make it the default location (default.on). |
Examples
cua cloud connect aws --region us-west-2 --default
cua cloud connect aws --profile sandbox
cua cloud connect gcp --project my-project --region us-central1
cua cloud connect modal --environment spaces
# Spaces there delete themselves after 4 hours (default 8; 0: never)
cua cloud connect aws --ttl-hours 4cua cloud test#Check a cloud account without creating anything: credentials, permissions (by dry run), quota, the region and machine types.
cua cloud test [OPTIONS] <PROVIDER>| Argument | Type | Default | Description |
|---|---|---|---|
<PROVIDER> | string | required | aws, gcp or modal. |
| Flag | Type | Default | Description |
|---|---|---|---|
--profile | string | AWS profile (~/.aws/config) or Modal profile (~/.modal.toml). | |
--region | string | AWS or Google Cloud region. | |
--zone | string | Google Cloud zone (default: the region's -a zone). | |
--project | string | Google Cloud project (default: gcloud config get project). | |
--environment | string | Modal environment (default: the profile's). |
Examples
cua cloud test aws
cua cloud test gcp --project my-projectcua cloud disconnect#Forget a connected cloud (nothing in it is deleted).
cua cloud disconnect [OPTIONS] <PROVIDER>| Argument | Type | Default | Description |
|---|---|---|---|
<PROVIDER> | string | required | aws, gcp or modal. |
Examples
cua cloud disconnect awscua cloud sweep#Find what Cua left in your clouds: expired Spaces and resources whose Space is gone (with --all, every Cua resource). Lists them unless --delete. Only resources Cua tagged and recorded are ever touched.
cua cloud sweep [OPTIONS] [PROVIDER]| Argument | Type | Default | Description |
|---|---|---|---|
<PROVIDER> | string | optional | Only this cloud. |
| Flag | Type | Default | Description |
|---|---|---|---|
--delete | boolean | false | Delete what it finds (default: list only). |
--all | boolean | false | Include Cua resources that have not expired (every Space there). |
Examples
cua cloud sweep
cua cloud sweep aws --delete
cua cloud sweep --all --delete| 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. |