agentuity-cli-cloud-sandbox-exec

Execute a command in a running sandbox

Prerequisites

• Authenticated with agentuity auth login
• Organization context required (--org-id or default org)

Usage

agentuity cloud sandbox exec <sandboxId> <command...> [options]

Arguments

| Argument | Type | Required | Description | |----------|------|----------|-------------| | <sandboxId> | string | Yes | - | | <command...> | array | Yes | - |

Options

| Option | Type | Required | Default | Description | |--------|------|----------|---------|-------------| | --timeout | string | Yes | - | Execution timeout (e.g., "5m", "1h") | | --timestamps | boolean | No | false | Include timestamps in output (default: false) |

Examples

Execute a command in a sandbox:

bunx @agentuity/cli cloud sandbox exec abc123 -- echo "hello"

Execute with timeout:

bunx @agentuity/cli cloud sandbox exec abc123 --timeout 5m -- bun run build

Output

Returns JSON object:

{
  "executionId": "string",
  "status": "string",
  "exitCode": "number",
  "durationMs": "number",
  "output": "string"
}

| Field | Type | Description | |-------|------|-------------| | executionId | string | Unique execution identifier | | status | string | Execution status | | exitCode | number | Exit code (if completed) | | durationMs | number | Duration in milliseconds (if completed) | | output | string | Combined stdout/stderr output |