# CUA CLI

Unified command-line interface for CUA (Computer-Use Agents).

## Installation

```bash
pip install cua-cli
```

## Usage

```bash
# Authentication
cua auth login              # Authenticate via browser
cua auth login --api-key    # Authenticate with API key
cua auth list               # List authenticated workspaces
cua auth status             # Show auth status and credits
cua auth logout             # Remove active workspace credentials
cua auth logout --workspace <slug>  # Remove specific workspace
cua auth logout --all       # Remove all credentials
cua auth env                # Export API key to .env file

# Workspace Management
cua ws set <slug>           # Switch active workspace
cua ws set                  # Interactive workspace picker

# Sandbox Management
cua sb list                 # List all sandboxes
cua sb create --os linux --size medium --region north-america
cua sb get <name>           # Get sandbox details
cua sb start <name>         # Start a stopped sandbox
cua sb stop <name>          # Stop a running sandbox
cua sb restart <name>       # Restart a sandbox
cua sb suspend <name>       # Suspend a sandbox
cua sb delete <name>        # Delete a sandbox
cua sb vnc <name>           # Open sandbox in browser

# Image Management
cua image list              # List cloud images
cua image list --local      # List local images
cua image push <name>       # Upload image to cloud
cua image pull <name>       # Download image from cloud
cua image delete <name>     # Delete cloud image

# Skills Management
cua skills list             # List recorded skills
cua skills read <name>      # Read a skill's content
cua skills record <name>    # Record a new skill
cua skills replay <name>    # Replay a skill
cua skills delete <name>    # Delete a skill
cua skills clean            # Delete all skills

# MCP Server (for AI assistants)
cua serve-mcp               # Start MCP server with all permissions
cua serve-mcp --permissions sandbox:all,computer:readonly
```

## Installation Options

```bash
# Basic installation
pip install cua-cli

# With MCP server support
pip install cua-cli[mcp]

# With skills recording (VLM captioning)
pip install cua-cli[skills]

# Full installation
pip install cua-cli[all]
```

## MCP Integration

To use CUA with Claude Code or other MCP-compatible AI assistants:

```bash
# Add CUA as an MCP server
claude mcp add cua -- cua serve-mcp

# With specific permissions
claude mcp add cua -- cua serve-mcp --permissions sandbox:all,computer:readonly

# With a default sandbox
claude mcp add cua -- cua serve-mcp --sandbox my-sandbox
```

### Available Permissions

- `all` - All permissions
- `sandbox:all` - Full sandbox management
- `sandbox:readonly` - List and get sandboxes only
- `computer:all` - Full computer control
- `computer:readonly` - Screenshots only
- `skills:all` - Full skills management
- `skills:readonly` - List and read skills only

Individual permissions: `sandbox:list`, `sandbox:create`, `sandbox:delete`, `sandbox:start`, `sandbox:stop`, `sandbox:restart`, `sandbox:suspend`, `sandbox:get`, `sandbox:vnc`, `computer:screenshot`, `computer:click`, `computer:type`, `computer:key`, `computer:scroll`, `computer:drag`, `computer:hotkey`, `computer:clipboard`, `computer:file`, `computer:shell`, `computer:window`, `skills:list`, `skills:read`, `skills:record`, `skills:delete`

## Environment Variables

- `CUA_API_KEY`: API key for authentication
- `CUA_API_BASE`: API base URL (default: `https://api.cua.ai`)
- `CUA_WEBSITE_URL`: Website URL for OAuth (default: https://cua.ai)
- `CUA_MCP_PERMISSIONS`: Default MCP permissions (comma-separated)
- `CUA_SANDBOX`: Default sandbox name for computer commands