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.
Source facts
- Repository
- code-yeongyu/pi-cua-integration
- Last source activity
- May 13, 2026 at 09:56
- Detected SKILL.md language
- English
- Stars
- 7
- Forks
- 5
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- cua-cloud-sandbox
- description
- 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.
# 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
```jsonc
// .pi/cua.jsonc
{
"mode": "cloud",
"cloud": {
"apiKeyEnv": "CUA_API_KEY",
"region": "north-america"
}
}
```
Then export the key before launching Pi:
```bash
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
```jsonc
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.
View on GitHub