agentuity-cli-cloud-sandbox-get
Get information about a sandbox. Requires authentication. Use for Agentuity cloud platform operations
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.
| name | agentuity-cli-cloud-sandbox-get |
|---|---|
| description | Get information about a sandbox. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-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-idor 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 |