Documentation Index
Fetch the complete documentation index at: https://docs.castari.com/llms.txt
Use this file to discover all available pages before exploring further.
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
cast buckets create <name> [options]
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 create "Production Data" \
--provider s3 \
--bucket-name my-data-bucket \
--region us-east-1
cast buckets get
Get details for a specific bucket.
Usage
cast buckets delete
Delete a bucket configuration.
Usage
cast buckets delete <slug> [-f, --force]
cast buckets test
Test the connection to a bucket.
Usage
Verifies that the configured credentials can access the bucket.
cast buckets credentials
Set credentials for a bucket.
Usage
cast buckets credentials <slug> [options]
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)
cast buckets credentials my-bucket \
--access-key-id AKIAIOSFODNN7EXAMPLE \
--secret-access-key wJalrXUtnFEMI/K7MDENG/bPxRfiCYEXAMPLEKEY
Example (GCS)
cast buckets credentials my-gcs-bucket \
--service-account-file ./service-account.json
See Also
