cast buckets
Manage cloud storage buckets for agent file access. Supports Amazon S3, Google Cloud Storage, and Cloudflare R2.Subcommands
| Command | Description |
|---|---|
cast buckets list | List all storage buckets |
cast buckets create <name> | Create a new bucket |
cast buckets get <slug> | Get bucket details |
cast buckets delete <slug> | Delete a bucket |
cast buckets test <slug> | Test bucket connection |
cast buckets credentials <slug> | Set bucket credentials |
cast buckets list
List all configured storage buckets.Usage
cast buckets create
Create a new storage bucket configuration.Usage
Arguments
| Argument | Description | Required |
|---|---|---|
name | Display name for the bucket | Yes |
Options
| Option | Description | Required |
|---|---|---|
--slug <slug> | URL-safe identifier | No (auto-generated) |
--provider <provider> | Storage provider: s3, gcs, or r2 | Yes |
--bucket-name <name> | Actual bucket name in the cloud provider | Yes |
--region <region> | AWS region (for S3) | No |
--endpoint <url> | Custom endpoint URL (required for R2) | No |
Example
cast buckets get
Get details for a specific bucket.Usage
cast buckets delete
Delete a bucket configuration.Usage
cast buckets test
Test the connection to a bucket.Usage
cast buckets credentials
Set credentials for a bucket.Usage
Options
| Option | Description |
|---|---|
--access-key-id <id> | AWS/R2 access key ID |
--secret-access-key <key> | AWS/R2 secret access key |
--service-account-file <path> | Path to GCS service account JSON file |
Example (S3/R2)
Example (GCS)
See Also
- cast mounts — Mount buckets to agents
- Storage API (SDK) — Manage buckets programmatically