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
Suivez les instructions du dépôt pour votre agent. Consultez les fichiers et dépendances avant l’installation.
Voir la source ↗GuidesInstructions
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 |
Exemples
Consultez les exemples du dépôt source.
Voir la source ↗Historique source
- Date d’indexation
- 2026-01-20
- Mise à jour de l’index
- 2026-01-26
- Branch
- main
Les dates concernent ce répertoire. Consultez le dépôt pour l’historique du code.
GitHub ↗chat Comments (0)
Sign in to join the discussion and leave a comment.
No comments yet. Be the first to share your thoughts!