LogoCua

Getting Started

Install and set up the CUA CLI

The Cua CLI is a command-line tool for managing your Cua cloud sandboxes. Create, start, stop, and connect to sandboxes directly from your terminal.

Installation

curl -LsSf https://cua.ai/cli/install.sh | sh
powershell -ExecutionPolicy ByPass -c "irm https://cua.ai/cli/install.ps1 | iex"

This installs Bun and the CUA CLI. Verify with:

cua --help

Authentication

Login to your CUA account:

# Browser-based login
cua auth login

# Or with API key
cua auth login --api-key sk-your-api-key-here

Generate a .env file for your project:

cua auth env

Quick Start

# Create a sandbox
cua create --os linux --size small --region north-america

# List sandboxes
cua list

# Open VNC in browser
cua vnc my-sandbox

# Stop a sandbox
cua stop my-sandbox

Next Steps

Was this page helpful?

LLM Integrations

Previous Page

Command Reference

Complete reference for all CUA CLI commands

On this page

InstallationAuthenticationQuick StartNext Steps