Cloud Sandbox Run
Run a one-shot command in a sandbox (creates, executes, destroys)
Prerequisites
- Authenticated with
agentuity auth login
- Organization context required (
--org-id or default org)
Usage
agentuity cloud sandbox run <command...> [options]
Arguments
| Argument |
Type |
Required |
Description |
<command...> |
array |
Yes |
- |
Options
| Option |
Type |
Required |
Default |
Description |
--runtime |
string |
Yes |
- |
Runtime name (e.g., "bun:1", "python:3.14") |
--runtimeId |
string |
Yes |
- |
Runtime ID (e.g., "srt_xxx") |
--name |
string |
Yes |
- |
Sandbox name |
--description |
string |
Yes |
- |
Sandbox 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 |
No |
false |
Enable outbound network access |
--timeout |
string |
Yes |
- |
Execution timeout (e.g., "5m", "1h") |
--env |
array |
Yes |
- |
Environment variables (KEY=VALUE) |
--file |
array |
Yes |
- |
Files to create in sandbox (sandbox-path:local-path) |
--timestamps |
boolean |
No |
false |
Include timestamps in output (default: true) |
--snapshot |
string |
Yes |
- |
Snapshot ID or tag to restore from |
--dependency |
array |
Yes |
- |
Apt packages to install (can be specified multiple times) |
--projectId |
string |
Yes |
- |
Project ID to associate this sandbox with |
Examples
Run a simple command:
bunx @agentuity/cli cloud sandbox run -- echo "hello world"
Run with resource limits:
bunx @agentuity/cli cloud sandbox run --memory 1Gi --cpu 1000m -- bun run index.ts
Run with network access enabled:
bunx @agentuity/cli cloud sandbox run --network -- curl https://api.example.com
Output
Returns JSON object:
{
"sandboxId": "string",
"exitCode": "number",
"durationMs": "number",
"output": "string"
}
| Field |
Type |
Description |
sandboxId |
string |
Sandbox ID |
exitCode |
number |
Exit code from the process |
durationMs |
number |
Duration in milliseconds |
output |
string |
Combined stdout/stderr output |
