agentuity-cli-cloud-storage-upload
Upload a file to storage bucket. Requires authentication. Use for Agentuity cloud platform operations
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.
| name | agentuity-cli-cloud-storage-upload |
|---|---|
| description | Upload a file to 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>" |
| 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-idor 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 |