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