| name | agentuity-cli-cloud-sandbox-files |
| description | List files in a sandbox directory. Requires authentication. Use for Agentuity cloud platform operations |
| version | 0.1.11 |
| 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-id or 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 | - |
