Cloud Sandbox Create
agentuity-cli-cloud-sandbox-create
Create an interactive sandbox for multiple executions. Requires authentication. Use for Agentuity cloud platform operations
SKILL.md
Full skill instructions
Cloud Sandbox Create
Create an interactive sandbox for multiple executions
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox create [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--memory | string | Yes | - | Memory limit (e.g., "500Mi", "1Gi") |
--cpu | string | Yes | - | CPU limit in millicores (e.g., "500m", "1000m") |
--disk | string | Yes | - | Disk limit (e.g., "500Mi", "1Gi") |
--network | boolean | Yes | - | Enable outbound network access |
--idleTimeout | string | Yes | - | Idle timeout before sandbox is reaped (e.g., "10m", "1h") |
--env | array | Yes | - | Environment variables (KEY=VALUE) |
--file | array | Yes | - | Files to create in sandbox (sandbox-path:local-path) |
--snapshot | string | Yes | - | Snapshot ID or tag to restore from |
--dependency | array | Yes | - | Apt packages to install (can be specified multiple times) |
Examples
Create a sandbox with default settings:
bunx @agentuity/cli cloud sandbox create
Create a sandbox with resource limits:
bunx @agentuity/cli cloud sandbox create --memory 1Gi --cpu 1000m
Create a sandbox with network and custom timeout:
bunx @agentuity/cli cloud sandbox create --network --idle-timeout 30m
Create a sandbox with a specific environment variable:
bunx @agentuity/cli cloud sandbox create --env KEY=VAL
Output
Returns JSON object:
{
"sandboxId": "string",
"status": "string",
"stdoutStreamUrl": "string",
"stderrStreamUrl": "string"
}
| Field | Type | Description |
|---|---|---|
sandboxId | string | Unique sandbox identifier |
status | string | Current sandbox status |
stdoutStreamUrl | string | URL to the stdout output stream |
stderrStreamUrl | string | URL to the stderr output stream |