| 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 | <source> <destination> |
| metadata | [object Object] |
Cloud Sandbox Cp
Copy files or directories to or from a sandbox
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor 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 |