agentuity-cli-cloud-storage-download
Download a file from storage bucket. Requires authentication. Use for Agentuity cloud platform operations
When & Why to Use This Skill
The agentuity-cli-cloud-storage-download skill enables seamless file retrieval from Agentuity cloud storage buckets via a secure CLI interface. It allows users and AI agents to download files or metadata, supporting authenticated operations and flexible output routing to local files or stdout. This tool is essential for managing cloud assets, automating data transfers, and integrating cloud storage operations into broader DevOps and development workflows.
Use Cases
- Automated Data Retrieval: Use in CI/CD pipelines or automated scripts to fetch configuration files, build artifacts, or datasets from cloud storage buckets.
- Programmatic File Processing: Enable AI agents to download and analyze remote files by piping cloud storage content directly into processing tools or local environments.
- Cloud Asset Auditing: Retrieve file metadata such as size, content type, and last modified timestamps to verify storage states without downloading full file contents.
- Development Environment Setup: Streamline local setup by programmatically downloading required project assets or environment-specific resources from a centralized cloud repository.
| name | agentuity-cli-cloud-storage-download |
|---|---|
| description | Download a file from storage bucket. Requires authentication. Use for Agentuity cloud platform operations |
| version | "0.0.103" |
| license | Apache-2.0 |
| allowed-tools | "Bash(agentuity:*)" |
| argument-hint | "<name> <filename> [output]" |
| command | "agentuity cloud storage download" |
| tags | "read-only requires-auth" |
Cloud Storage Download
Download a file from storage bucket
Prerequisites
- Authenticated with
agentuity auth login - Organization context required (
--org-idor default org)
Usage
agentuity cloud storage download <name> <filename> [output] [options]
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
<name> |
string | Yes | - |
<filename> |
string | Yes | - |
<output> |
string | No | - |
Options
| Option | Type | Required | Default | Description |
|---|---|---|---|---|
--metadata |
boolean | Yes | - | Download metadata only (not file contents) |
Examples
Download file from bucket:
bunx @agentuity/cli cloud storage download my-bucket file.txt
Download file to specific path:
bunx @agentuity/cli cloud storage download my-bucket file.txt output.txt
Download file to stdout:
bunx @agentuity/cli cloud storage download my-bucket file.txt - > output.txt
Download metadata only:
bunx @agentuity/cli cloud storage download my-bucket file.txt --metadata
Output
Returns JSON object:
{
"success": "boolean",
"bucket": "string",
"filename": "string",
"size": "number",
"contentType": "string",
"lastModified": "string"
}
| Field | Type | Description |
|---|---|---|
success |
boolean | Whether download succeeded |
bucket |
string | Bucket name |
filename |
string | Downloaded filename |
size |
number | File size in bytes |
contentType |
string | Content type |
lastModified |
string | Last modified timestamp |