---

name: agentuity-cli-cloud-sandbox-cp description: Copy files or directories to or 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: " " metadata: command: "agentuity cloud sandbox cp" tags: "slow requires-auth"

Cloud Sandbox Cp

Copy files or directories to or from a sandbox

Prerequisites

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

Usage

agentuity cloud sandbox cp <source> <destination> [options]

Arguments

Argument	Type	Required	Description
<source>	string	Yes	-
<destination>	string	Yes	-

Options

Option	Type	Required	Default	Description
--timeout	string	Yes	-	Operation timeout (e.g., "5m", "1h")
--recursive	boolean	No	false	Copy directories recursively

Examples

Copy a local file to a sandbox:

bunx @agentuity/cli cloud sandbox cp ./local-file.txt snbx_abc123:/path/to/file.txt

Copy a file from a sandbox to local:

bunx @agentuity/cli cloud sandbox cp snbx_abc123:/path/to/file.txt ./local-file.txt

Copy a local directory to a sandbox recursively:

bunx @agentuity/cli cloud sandbox cp --recursive ./local-dir snbx_abc123:/path/to/dir

Copy a directory from a sandbox to local recursively:

bunx @agentuity/cli cloud sandbox cp -r snbx_abc123:/path/to/dir ./local-dir

Output

Returns JSON object:

{
  "source": "string",
  "destination": "string",
  "bytesTransferred": "number",
  "filesTransferred": "number"
}

Field	Type	Description
source	string	Source path
destination	string	Destination path
bytesTransferred	number	Number of bytes transferred
filesTransferred	number	Number of files transferred