agentuity-cli-cloud-sandbox-list
List sandboxes with optional filtering. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-sandbox-list skill enables Claude to interact directly with the Agentuity cloud platform to retrieve, filter, and manage virtual sandboxes. By providing real-time visibility into cloud environments through a CLI-integrated interface, this skill streamlines DevOps workflows, allowing users to monitor resource status, track project-specific environments, and maintain operational oversight using natural language commands.
Use Cases
- Environment Monitoring: Quickly list all active sandboxes to verify the health and availability of development or testing environments.
- Resource Management: Filter sandboxes by specific Project IDs to track resource allocation and progress across different development teams.
- Cost Optimization: Identify and list sandboxes based on their status (e.g., 'running' vs 'stopped') to find idle resources that can be decommissioned to save costs.
- Operational Auditing: Retrieve a paginated list of all sandboxes within an organization to perform security audits or inventory checks.
- Automated Reporting: Use the JSON output to generate summaries of cloud usage and environment distribution for stakeholder updates.
| name | agentuity-cli-cloud-sandbox-list |
|---|---|
| description | List sandboxes with optional filtering. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| command | "agentuity cloud sandbox list" |
| tags | "read-only slow requires-auth" |
Cloud Sandbox List
List sandboxes with optional filtering
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox list [options]
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--status |
string | Yes | - | Filter by status |
--projectId |
string | Yes | - | Filter by project ID |
--limit |
number | Yes | - | Maximum number of results (default: 50, max: 100) |
--offset |
number | Yes | - | Pagination offset |
Examples
List all sandboxes:
bunx @agentuity/cli cloud sandbox list
List running sandboxes:
bunx @agentuity/cli cloud sandbox list --status running
List sandboxes for a specific project:
bunx @agentuity/cli cloud sandbox list --project-id proj_123
List with pagination:
bunx @agentuity/cli cloud sandbox list --limit 10 --offset 20
Output
Returns JSON object:
{
"sandboxes": "array",
"total": "number"
}
| Field | Type | Description |
|---|---|---|
sandboxes |
array | List of sandboxes |
total |
number | Total count |