agentuity-cli-cloud-storage-upload

Upload a file to storage bucket. Requires authentication. Use for Agentuity cloud platform operations

⭐3stars🔀5forks📁View on GitHub🕐Updated Jan 5, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill enables seamless and secure file uploads to cloud storage buckets within the Agentuity platform. It simplifies cloud resource management by allowing agents to automate data persistence, manage object keys, and configure content types via CLI, making it an essential tool for developers and DevOps engineers looking to integrate cloud storage operations into their agentic workflows.

Use Cases

  • Automated Data Persistence: Automatically uploading generated reports, processed datasets, or configuration files to a secure cloud bucket during an agent's task execution.
  • Log and Artifact Management: Streamlining the archival of system logs or build artifacts by programmatically sending them to centralized storage for long-term retention and auditing.
  • Dynamic Asset Uploads: Using stdin or local file paths to programmatically upload media assets or documents with custom metadata and specific object keys for platform-specific operations.
nameagentuity-cli-cloud-storage-upload
descriptionUpload a file to storage bucket. Requires authentication. Use for Agentuity cloud platform operations
version"0.0.103"
licenseApache-2.0
allowed-tools"Bash(agentuity:*)"
argument-hint"<name> <filename>"
command"agentuity cloud storage upload"
tags"write requires-auth"

Cloud Storage Upload

Upload a file to storage bucket

Prerequisites

  • Authenticated with agentuity auth login
  • Organization context required (--org-id or default org)

Usage

agentuity cloud storage upload <name> <filename> [options]

Arguments

Argument Type Required Description
<name> string Yes -
<filename> string Yes -

Options

Option Type Required Default Description
--key string Yes - Remote object key (defaults to basename or "stdin" for piped uploads)
--contentType string Yes - Content type (auto-detected if not provided)

Examples

Upload file to bucket:

bunx @agentuity/cli cloud storage upload my-bucket file.txt

Upload file with content type:

bunx @agentuity/cli cloud storage put my-bucket file.txt --content-type text/plain

Upload file with custom object key:

bunx @agentuity/cli cloud storage upload my-bucket file.txt --key custom-name.txt

Upload from stdin:

cat file.txt | bunx @agentuity/cli cloud storage upload my-bucket -

Upload from stdin with custom key:

cat data.json | bunx @agentuity/cli cloud storage upload my-bucket - --key data.json

Output

Returns JSON object:

{
  "success": "boolean",
  "bucket": "string",
  "filename": "string",
  "size": "number"
}
Field Type Description
success boolean Whether upload succeeded
bucket string Bucket name
filename string Uploaded filename
size number File size in bytes