cua team
Teams (organizations), their members, machines and device approvals.
Teams (organizations), their members, machines and device approvals.
| Command | Description |
|---|---|
cua team create | Create a team; you are its owner. |
cua team ls | Your teams. |
cua team show | A team: plan, members, machines, 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 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. |
cua team delete | Delete a team (owner; cancel its subscription first). |
Every command also accepts the global options.
Teams (organizations of your cua.ai account) share machines with every member and their agents. Owners and admins invite by email, approve member devices and add machines.
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 AIGIScua team create#Create a team; you are its owner. Buy Teams for it at app.cua.ai to add machines.
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 --jsoncua team show#A team: plan, members, machines, 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 AIGIScua 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 admincua 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 AIGIScua 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 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, alias 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, 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 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, alias 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, alias 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, alias 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, alias 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. Macs, Linux and Windows machines 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 machine 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 --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, alias 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. 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 AIGIScua team delete#Delete a team (owner; cancel its subscription first). Its machines 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| 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. |