name: agentuity-cli-cloud-sandbox-snapshot-build description: Build a snapshot from a declarative file. Requires authentication. Use for Agentuity cloud platform operations version: "0.1.24" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: "" metadata: command: "agentuity cloud sandbox snapshot build" tags: "slow requires-auth"

Cloud Sandbox Snapshot Build

Build a snapshot from a declarative file

Prerequisites

• Authenticated with agentuity auth login
• Organization context required (--org-id or default org)

Usage

agentuity cloud sandbox snapshot build <directory> [options]

Arguments

Options

Examples

Build a snapshot from the current directory using agentuity-snapshot.yaml:

bunx @agentuity/cli cloud sandbox snapshot build .

Build using a custom build file:

bunx @agentuity/cli cloud sandbox snapshot build ./project --file custom-build.yaml

Build with environment variable substitution and custom tag:

bunx @agentuity/cli cloud sandbox snapshot build . --env API_KEY=secret --tag production

Validate the build file without uploading:

bunx @agentuity/cli cloud sandbox snapshot build . --dry-run

Force rebuild even if content is unchanged:

bunx @agentuity/cli cloud sandbox snapshot build . --force

Output

Returns JSON object:

{
  "snapshotId": "string",
  "name": "string",
  "tag": "unknown",
  "runtime": "string",
  "sizeBytes": "number",
  "fileCount": "number",
  "createdAt": "string",
  "unchanged": "boolean",
  "userMetadata": "object",
  "error": "string",
  "malwareDetected": "boolean",
  "virusName": "string"
}