cua agents
Install cua skills and the cua MCP server into AI coding agents.
Install cua skills and the cua MCP server into AI coding agents.
| Command | Description |
|---|---|
cua agents detect | List supported AI coding agents and which are installed (read-only). |
cua agents setup | Install the default cua skills and configure the cua MCP server. |
cua agents status | What cua configured for each agent. |
cua agents remove | Remove the skills and MCP entries cua added (nothing else). |
cua agents update | Refresh installed cua skills and managed MCP entries to this version. |
Every command also accepts the global options.
AI coding agents on this machine: install cua skills and configure the cua MCP server.
cua agents [OPTIONS] <COMMAND>cua agents detect#List supported AI coding agents and which are installed (read-only).
cua agents detect [OPTIONS]Examples
cua agents detectcua agents setup#Install the default cua skills and configure the cua MCP server.
cua agents setup [OPTIONS]| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--agents | string | Agents: all (installed), none, or ids such as claude,codex,hermes (cua agents detect lists every supported agent). | ||
--mcp-command | string | Command agents launch for the MCP server (default: the cua on PATH, else this binary). | ||
--skills-only | boolean | false | Only install skills. Alias: --no-mcp. | |
--mcp-only | boolean | false | Only configure the MCP server. Alias: --no-skills. | |
--yes | -y | boolean | false | Answer yes to every prompt. |
--force | boolean | false | Replace skill folders cua did not write (the old one is backed up). | |
--cua-driver | boolean | false | Set up background computer-use instead: the cua-driver skill and the cua-driver MCP server (cua-driver mcp). --mcp-command then names the cua-driver binary. |
Examples
# Every installed agent, asking before each change
cua agents setup
# Claude Code and Codex, no prompts
cua agents setup --agents claude,codex -y
# Hermes Agent (Nous Research): ~/.hermes/skills and ~/.hermes/config.yaml
cua agents setup --agents hermes -y
# Only the MCP server entry
cua agents setup --mcp-only
# Background computer-use: the cua-driver skill and MCP server
cua agents setup --cua-driver --agents all -ycua agents status#What cua configured for each agent.
cua agents status [OPTIONS]Examples
cua agents statuscua agents remove#Remove the skills and MCP entries cua added (nothing else).
cua agents remove [OPTIONS]| Flag | Short | Type | Default | Description |
|---|---|---|---|---|
--agents | string | all | Agents: all (default) or ids such as claude,codex. | |
--skills-only | boolean | false | Only remove skills. | |
--mcp-only | boolean | false | Only remove the MCP entry. | |
--yes | -y | boolean | false | Do not ask for confirmation. |
Examples
cua agents remove
cua agents remove --agents codex --skills-only -ycua agents update#Refresh installed cua skills and managed MCP entries to this version.
cua agents update [OPTIONS]Examples
cua agents update| 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. |