name: agentuity-cli-cloud-sandbox-files description: List files in a sandbox directory. Requires authentication. Use for Agentuity cloud platform operations version: "0.1.2" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: "<sandboxId> [path]" metadata: command: "agentuity cloud sandbox files" tags: "slow requires-auth"
Cloud Sandbox Files
List files in a sandbox directory
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud sandbox files <sandboxId> [path] [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<sandboxId> | string | Yes | - |
<path> | string | No | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--long | boolean | No | false | Use long listing format with permissions and timestamps |
Examples
List files in the sandbox root directory:
bunx @agentuity/cli cloud sandbox files sbx_abc123
List files in a specific directory:
bunx @agentuity/cli cloud sandbox files sbx_abc123 /path/to/dir
List files with permissions and modification time:
bunx @agentuity/cli cloud sandbox files sbx_abc123 -l
List files with JSON output:
bunx @agentuity/cli cloud sandbox files sbx_abc123 --json
Output
Returns JSON object:
{
"files": "array",
"total": "number"
}
| Field | Type | Description |
|---|---|---|
files | array | - |
total | number | - |