agentuity-cli-cloud-sandbox-get

agentuity's avatarfrom agentuity

Get information about a sandbox. Requires authentication. Use for Agentuity cloud platform operations

⭐1stars🔀0forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

The agentuity-cli-cloud-sandbox-get skill allows users to retrieve detailed metadata and real-time status information for specific sandboxes on the Agentuity cloud platform. It provides essential data points such as execution counts, regional placement, and log stream URLs, enabling efficient management and monitoring of isolated cloud environments used for agentic workflows.

Use Cases

  • Environment Monitoring: Check the current status, creation timestamp, and health of a specific cloud sandbox to ensure it is ready for task execution.
  • Debugging and Logging: Retrieve stdout and stderr stream URLs to access real-time logs and troubleshoot agent behavior within a sandbox.
  • Infrastructure Auditing: Verify sandbox configurations, including the region, snapshot IDs, and installed dependencies (apt packages) to maintain environment consistency.
  • Execution Tracking: Monitor the number of executions performed within a sandbox to manage resource usage and platform limits.
nameagentuity-cli-cloud-sandbox-get
descriptionGet information about a sandbox. Requires authentication. Use for Agentuity cloud platform operations
version"0.0.110"
licenseApache-2.0
allowed-tools"Bash(agentuity:*)"
argument-hint"<sandboxId>"
command"agentuity cloud sandbox get"
tags"read-only fast requires-auth"

Cloud Sandbox Get

Get information about a sandbox

Prerequisites

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

Usage

agentuity cloud sandbox get <sandboxId>

Arguments

Argument Type Required Description
<sandboxId> string Yes -

Examples

Get sandbox information:

bunx @agentuity/cli cloud sandbox get abc123

Output

Returns JSON object:

{
  "sandboxId": "string",
  "status": "string",
  "createdAt": "string",
  "region": "string",
  "snapshotId": "string",
  "snapshotTag": "string",
  "executions": "number",
  "stdoutStreamUrl": "string",
  "stderrStreamUrl": "string",
  "dependencies": "array"
}
Field Type Description
sandboxId string Sandbox ID
status string Current status
createdAt string Creation timestamp
region string Region where sandbox is running
snapshotId string Snapshot ID sandbox was created from
snapshotTag string Snapshot tag sandbox was created from
executions number Number of executions
stdoutStreamUrl string URL to stdout output stream
stderrStreamUrl string URL to stderr output stream
dependencies array Apt packages installed