How do I install the Cua Cloud Sandbox skill?

Run npx skillmds@latest add code-yeongyu/cua-cloud-sandbox in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Cua Cloud Sandbox safe to use?

This skill has not completed SkillMD's automated safety review yet. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Cua Cloud Sandbox?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Cua Cloud Sandbox free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Cua Cloud Sandbox?

code-yeongyu (@code-yeongyu) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Cua Cloud Sandbox by code-yeongyu — Agent Skill

Name: Cua Cloud Sandbox
Author: code-yeongyu

Cua Cloud Sandbox

Use Cua's cloud sandboxes via cua.ai. Requires CUA_API_KEY. Cloud sandboxes are isolated VMs run by trycua with billing per usage. Use when the user wants no local Docker/QEMU, wants Windows/macOS guests without Apple Silicon, or explicitly asks for cloud.

code-yeongyu 5f5e3d5 1.5 KB Updated Sep 17, 2026

File contents

Cloud Cua sandbox

In mode: "cloud", cua_sandbox_start provisions a sandbox in cua.ai. Requires a Cua API key (sign up at https://cua.ai/signin).

Activation

// .pi/cua.jsonc
{
  "mode": "cloud",
  "cloud": {
    "apiKeyEnv": "CUA_API_KEY",
    "region": "north-america"
  }
}

Then export the key before launching Pi:

export CUA_API_KEY=sk_cua-...

Fallback

If the API key env var is empty when the session starts, the extension prints a warning and falls back to mode: "local" for that session.

Image options

cua_sandbox_start({ os: "windows" })   // Windows 11
cua_sandbox_start({ os: "macos" })     // macOS (cloud Lume)
cua_sandbox_start({ os: "linux" })     // Ubuntu container
cua_sandbox_start({ os: "android" })   // Android emulator

Cloud mode is the only way to get macOS/Windows VMs from non-macOS hosts or hosts without Apple Silicon.

Cost notes

Cua bills per sandbox-second. Stop sandboxes promptly with cua_sandbox_stop. The extension also auto-stops on session shutdown.

Region

The region config sets the data center. Default omitted lets cua.ai choose. Available regions are listed in the Cua console.

Frequently asked questions