agentuity-cli-cloud-sandbox-create
Create an interactive sandbox for multiple executions. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-sandbox-create skill enables the programmatic creation of isolated, interactive cloud sandboxes on the Agentuity platform. It provides a secure and highly configurable environment for executing code and running automated tasks, offering granular control over compute resources like CPU, memory, disk, and network access. This tool is essential for developers and AI agents requiring a controlled workspace for multi-step operations and stateful executions.
Use Cases
- Secure Code Execution: Provisioning isolated, ephemeral environments to safely run and test untrusted or experimental code without risking the host system.
- Automated Agent Workspaces: Creating persistent, interactive sandboxes for AI agents to perform complex, multi-execution tasks that require specific environment variables and state retention via snapshots.
- Resource-Constrained Testing: Simulating specific hardware limitations by configuring precise CPU and memory limits to evaluate application performance under various stress conditions.
- Custom Development Environments: Initializing sandboxes with pre-installed Apt packages, specific file structures, and network configurations to streamline CI/CD pipelines and developer workflows.
| name | agentuity-cli-cloud-sandbox-create |
|---|---|
| description | Create an interactive sandbox for multiple executions. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud sandbox create" |
| tags | "slow requires-auth" |
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 |