agentuity-cli-cloud-sandbox-snapshot-tag
Add or update a tag on a snapshot. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
This Claude skill enables seamless management of metadata for Agentuity cloud sandbox snapshots. It allows users to programmatically add, update, or remove tags via the Agentuity CLI, facilitating superior organization, environment tracking, and automated lifecycle management within cloud infrastructure workflows.
Use Cases
- Environment Versioning: Tagging specific sandbox snapshots as 'stable', 'production-ready', or 'latest' to maintain a clear version history of cloud environments.
- Automated Resource Cleanup: Labeling temporary snapshots with 'to-be-deleted' or expiration tags to trigger automated scripts for cost optimization and resource hygiene.
- CI/CD Pipeline Integration: Automatically tagging snapshots that have successfully passed automated testing phases to signal readiness for the next stage of deployment.
- Project & Ownership Tracking: Categorizing snapshots by project ID, department, or owner to improve resource discoverability and accountability in multi-tenant cloud platforms.
| name | agentuity-cli-cloud-sandbox-snapshot-tag |
|---|---|
| description | Add or update a tag on a snapshot. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.110" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<snapshotId> [tag]" |
| command | "agentuity cloud sandbox snapshot tag" |
| tags | "slow requires-auth" |
Cloud Sandbox Snapshot Tag
Add or update a tag on a snapshot
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox snapshot tag <snapshotId> [tag] [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<snapshotId> |
string | Yes | - |
<tag> |
string | No | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--clear |
boolean | Yes | - | Remove the tag from the snapshot |
Examples
Tag a snapshot as "latest":
bunx @agentuity/cli cloud sandbox snapshot tag snp_abc123 latest
Remove a tag from a snapshot:
bunx @agentuity/cli cloud sandbox snapshot tag snp_abc123 --clear
Output
Returns JSON object:
{
"snapshotId": "string",
"tag": "unknown"
}
| Field | Type | Description |
|---|---|---|
snapshotId |
string | Snapshot ID |
tag |
unknown | New tag |