---

name: agentuity-cli-cloud-storage-download description: Download a file from storage bucket. Requires authentication. Use for Agentuity cloud platform operations version: "0.0.110" license: Apache-2.0 allowed-tools: "Bash(agentuity:*)" argument-hint: " [output]" metadata: 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-id or 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