agentuity-cli-cloud-sandbox-snapshot-create
Create a snapshot from a sandbox. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-sandbox-snapshot-create skill enables users to programmatically capture and persist the exact state of an Agentuity cloud sandbox. This tool is essential for environment versioning, state recovery, and infrastructure management, allowing developers and automated agents to safeguard their progress and manage cloud resources efficiently via the Agentuity CLI.
Use Cases
- Environment State Preservation: Create a point-in-time backup of a sandbox environment before performing major configuration changes or experimental updates to ensure a safe rollback point.
- Automated Workflow Integration: Incorporate snapshot creation into CI/CD pipelines to automatically save the state of test environments for later debugging or audit trails.
- Rapid Environment Cloning: Use snapshots as templates to quickly replicate specific sandbox states, facilitating consistent development and testing across different team members or agent instances.
- Disaster Recovery: Maintain regular snapshots of critical cloud sandboxes to prevent data loss and minimize downtime in case of environment corruption or accidental deletion.
| name | agentuity-cli-cloud-sandbox-snapshot-create |
|---|---|
| description | Create a snapshot from 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 snapshot create" |
| tags | "slow requires-auth" |
Cloud Sandbox Snapshot Create
Create a snapshot from a sandbox
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox snapshot create <sandboxId> [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<sandboxId> |
string | Yes | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--tag |
string | Yes | - | Tag for the snapshot |
Examples
Create a snapshot from a sandbox:
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123
Create a tagged snapshot:
bunx @agentuity/cli cloud sandbox snapshot create sbx_abc123 --tag latest
Output
Returns JSON object:
{
"snapshotId": "string",
"sandboxId": "string",
"tag": "unknown",
"sizeBytes": "number",
"fileCount": "number",
"createdAt": "string"
}
| Field | Type | Description |
|---|---|---|
snapshotId |
string | Snapshot ID |
sandboxId |
string | Source sandbox ID |
tag |
unknown | Snapshot tag |
sizeBytes |
number | Snapshot size in bytes |
fileCount |
number | Number of files in snapshot |
createdAt |
string | Snapshot creation timestamp |