agentuity-cli-cloud-storage-list
List storage resources or files in a bucket. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-storage-list skill is a specialized tool designed for managing and auditing cloud storage assets within the Agentuity platform. It allows users to programmatically list storage buckets and specific files using prefix filtering, providing structured JSON output that is essential for cloud resource visibility, automated infrastructure management, and data organization tasks.
Use Cases
- Cloud Resource Auditing: Quickly generate a comprehensive list of all storage buckets within an organization to monitor resource usage and allocation.
- File Verification and Search: Use prefix-based filtering to locate specific files or verify the successful upload of data batches within a cloud bucket.
- Automated Data Pipelines: Integrate into automated workflows to check for the presence of required input files in cloud storage before triggering downstream processing tasks.
- Infrastructure Documentation: Export storage resource metadata to JSON format for maintaining up-to-date documentation of cloud environments and storage hierarchies.
| name | agentuity-cli-cloud-storage-list |
|---|---|
| description | List storage resources or files in a bucket. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.104" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "[name] [prefix]" |
| command | "agentuity cloud storage list" |
| tags | "read-only fast requires-auth" |
Cloud Storage List
List storage resources or files in a bucket
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud storage list [name] [prefix] [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<name> |
string | No | - |
<prefix> |
string | No | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--showCredentials |
boolean | Yes | - | Show credentials in plain text (default: masked in terminal, unmasked in JSON) |
--nameOnly |
boolean | Yes | - | Print the name only |
Examples
List items:
bunx @agentuity/cli cloud storage list
List items:
bunx @agentuity/cli cloud storage list my-bucket
List items:
bunx @agentuity/cli cloud storage list my-bucket path/prefix
Show output in JSON format:
bunx @agentuity/cli --json cloud storage list
List items:
bunx @agentuity/cli cloud storage ls
Use show credentials option:
bunx @agentuity/cli cloud storage list --show-credentials
Output
Returns JSON object:
{
"buckets": "array",
"files": "array"
}
| Field | Type | Description |
|---|---|---|
buckets |
array | List of storage resources |
files |
array | List of files in bucket |