cua team (experimental)
Experimental, not available yet (needs `CUA_EXPERIMENTAL_TEAMS=1`): teams, their members, machines, device approvals and audit log.
Experimental, not available yet (needs `CUA_EXPERIMENTAL_TEAMS=1`): teams, their members, machines, device approvals and audit log.
| Command | Description |
|---|---|
cua team create | Create a team; you are its owner. |
cua team ls | Your teams, and email invites waiting for you. |
cua team show | A team: members, machines, open invites and devices. |
cua team invite | Invite someone by email, or make a link anyone can join with. |
cua team join | Join a team with an invite link or code, or (with --team) the email invite for your account's email. |
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 machines. |
cua team approve | Approve a member device so it can open team machines. |
cua team deny | Decline a member device (it can no longer open team machines). |
cua team request | Ask the team's admins to approve this device. |
cua team add-machine | Make a Space (or a machine you host) a team machine: every member and their agents see it and can open it. |
cua team remove-machine | Take a machine off the team. |
cua team audit | The team's audit log: joins, approvals, machines opened, changes. |
cua team delete | Delete a team (owner). |
Every command also accepts the global options.
Experimental, not available yet (set CUA_EXPERIMENTAL_TEAMS=1): teams share machines with every member and their agents. Owners and admins invite (email or link), approve member devices, add machines and read the audit log.
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 audit AIGIScua team create#Create a team; you are its owner.
cua team create [OPTIONS] <NAME>| Argument | Type | Default | Description |
|---|---|---|---|
<NAME> | string | required | Team name. |
Examples
cua team create "AIGIS"cua team ls#Your teams, and email invites waiting for you.
cua team ls [OPTIONS]Alias: cua team list.
Examples
cua team ls
cua team ls --jsoncua team show#A team: members, machines, open invites and devices.
cua team show [OPTIONS] <TEAM>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id (team-…) or name. |
Examples
cua team show AIGIScua team invite#Invite someone by email, or make a link anyone can join with.
cua team invite [OPTIONS] <TEAM> [EMAIL]| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
<EMAIL> | string | optional | Their email (they join by signing in with it). |
| Flag | Type | Default | Description |
|---|---|---|---|
--role | member | admin | member | member or admin (only the owner invites admins). |
--link | boolean | false | Make a link instead (up to 25 joins, 7 days). |
Examples
cua team invite AIGIS dillon@example.com
cua team invite AIGIS --link
cua team invite AIGIS ops@example.com --role admincua team join#Join a team with an invite link or code, or (with --team) the email invite for your account's email.
cua team join [OPTIONS] [CODE]| Argument | Type | Default | Description |
|---|---|---|---|
<CODE> | string | optional | The invite link or code. |
| Flag | Type | Default | Description |
|---|---|---|---|
--team | string | The team of an email invite. |
Examples
cua team join https://relay.cua.ai/join/team/team-0a1b….xyz
cua team join --team team-0a1b2c3d4e5f6a7bcua team leave#Leave a team.
cua team leave [OPTIONS] <TEAM>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
Examples
cua team leave AIGIScua 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 or name. |
<WHO> | string | required | Their email or account id. |
Examples
cua team remove-member AIGIS bob@example.comcua 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 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 admincua team devices#Member devices and whether they may open team machines.
cua team devices [OPTIONS] <TEAM>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
Examples
cua team devices AIGIScua team approve#Approve a member device so it can open team machines.
cua team approve [OPTIONS] <TEAM> <DEVICE>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
<DEVICE> | string | required | Device id (cua team devices). |
Examples
cua team approve AIGIS dev_0123456789abcdef01234567cua team deny#Decline a member device (it can no longer open team machines).
cua team deny [OPTIONS] <TEAM> <DEVICE>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
<DEVICE> | string | required | Device id. |
Examples
cua team deny AIGIS dev_0123456789abcdef01234567cua 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 or name. |
Examples
cua team request AIGIScua team add-machine#Make a Space (or a machine you host) a team machine: every member and their agents see it and can open it. macOS Spaces cannot.
cua team add-machine [OPTIONS] <TEAM> <SPACE>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
<SPACE> | string | required | Space id or name. |
| 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 --yescua team remove-machine#Take a machine off the team.
cua team remove-machine [OPTIONS] <TEAM> <MACHINE>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
<MACHINE> | string | required | The machine (relay:<id> or its id, as cua team show lists it). |
Examples
cua team remove-machine AIGIS relay:0123abcd4567ef89cua team audit#The team's audit log: joins, approvals, machines opened, changes.
cua team audit [OPTIONS] <TEAM>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--limit | integer | 50 | Newest events to show. |
Examples
cua team audit AIGIS --limit 50cua team delete#Delete a team (owner). Its machines stay yours.
cua team delete [OPTIONS] <TEAM>| Argument | Type | Default | Description |
|---|---|---|---|
<TEAM> | string | required | Team id or name. |
| Flag | Type | Default | Description |
|---|---|---|---|
--yes | boolean | false | Do not ask for confirmation. |
Examples
cua team delete AIGIS --yes| 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. |