| 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:*) |
| metadata | [object Object] |
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 |