agentuity-cli-cloud-sandbox-run
Run a one-shot command in a sandbox (creates, executes, destroys). Requires authentication. Use for Agentuity cloud platform operations
Installation
Follow the repository instructions for this skill and your agent. Review the files and dependencies before adding it to your workflow.
View source ↗GuidesSkill instructions
Cloud Sandbox Run
Run a one-shot command in a sandbox (creates, executes, destroys)
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor 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 |
Examples
Read the usage examples in the source repository.
View source ↗Source history
- Indexed on
- 2026-01-20
- Index updated
- 2026-01-26
- Branch
- main
Index and sync dates describe this directory. View the source repository for code history.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!