tigris-buckets
Use when creating, configuring, or deleting Tigris buckets — includes regions, tiers, CORS, migrations, TTL, notifications, snapshots, and forks
- Installs
- 83
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/tigrisdata/tigris-agents-plugins --skill tigris-buckets- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads tigris-buckets automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Tigris Bucket Management
Quick Reference
| Command | Description |
|---|---|
tigris mk <name> | Create a bucket (or folder with trailing /) |
tigris buckets list | List all buckets |
tigris buckets get <name> | Inspect bucket details |
tigris buckets delete <name> | Delete a bucket |
tigris buckets set <name> | Update bucket settings |
tigris buckets set-ttl <name> | Configure object expiration |
tigris buckets set-locations <name> | Set data locations |
tigris buckets set-migration <name> | Configure shadow bucket migration |
tigris buckets set-transition <name> | Configure storage class transitions |
tigris buckets set-notifications <name> | Configure event webhooks |
tigris buckets set-cors <name> | Configure CORS rules |
tigris snapshots list <bucket> | List bucket snapshots |
tigris snapshots take <bucket> | Take a snapshot |
Create a Bucket
tigris mk <path> (alias: create)
Create a bucket (bare name) or a folder inside a bucket (trailing /). Supports t3:// and tigris:// URI prefixes.
tigris mk my-bucket
tigris mk my-bucket --access public --locations iad
tigris mk my-bucket/images/ # creates a folder
tigris mk t3://my-bucket
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
tigris buckets create <name> (alias: c)
Same as mk but under the buckets subcommand.
tigris buckets create my-bucket
tigris buckets create my-bucket --access public --locations iad
tigris buckets create my-bucket --enable-snapshots --default-tier STANDARD_IA
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
Flags:
| Flag | Alias | Description | Default |
|---|---|---|---|
--access | -a | Access level (public, private) | private |
--public | Shorthand for --access public | ||
--locations | -l | Bucket location (see Locations) | global |
--default-tier | -t | Default storage tier (see Storage Tiers) | STANDARD |
--enable-snapshots | -s | Enable snapshots for the bucket | false |
--fork-of | --fork | Create as a fork (copy-on-write clone) of the named source bucket | |
--source-snapshot | --source-snap | Fork from a specific snapshot (requires --fork-of) | |
--format | -f | Output format (json, table) | table |
--json | Output as JSON | ||
--consistency | -c | (Deprecated) Use --locations instead | |
--region | -r | (Deprecated) Use --locations instead |
List Buckets
tigris buckets list (alias: l)
List all buckets in the current organization.
tigris buckets list
tigris buckets list --json
tigris buckets list --forks-of my-bucket
| Flag | Description |
|---|---|
--forks-of | Only list buckets that are forks of the named source bucket |
--format / -f | Output format (json, table, xml; default: table) |
--json | Output as JSON |
Inspect a Bucket
tigris buckets get <name> (alias: g)
Show details for a bucket including access level, region, tier, and custom domain.
tigris buckets get my-bucket
tigris buckets get my-bucket --json
| Flag | Description |
|---|---|
--format / -f | Output format (json, table, xml; default: table) |
--json | Output as JSON |
Delete a Bucket
tigris buckets delete <name> (alias: d)
Delete one or more buckets by name. Accepts comma-separated names.
tigris buckets delete my-bucket --force
tigris buckets delete bucket-a,bucket-b --force
| Flag | Description |
|---|---|
--force | Skip confirmation prompt |
--format / -f | Output format (json, table; default: table) |
--json | Output as JSON |
Update Bucket Settings
tigris buckets set <name> (alias: s)
Update settings on an existing bucket.
tigris buckets set my-bucket --access public
tigris buckets set my-bucket --locations iad,fra --cache-control 'max-age=3600'
tigris buckets set my-bucket --custom-domain assets.example.com
| Flag | Description |
|---|---|
--access | Bucket access level (public, private) |
--locations | Bucket locations (see Locations) |
--enable-delete-protection | Enable delete protection (true/false) |
--cache-control | Default cache-control header value |
--custom-domain | Custom domain for the bucket |
--allow-object-acl | Enable object-level ACL (true/false) |
--disable-directory-listing | Disable directory listing (true/false) |
--enable-additional-headers | Enable additional HTTP headers like X-Content-Type-Options: nosniff (true/false) |
--region | (Deprecated) Use --locations instead |
--format | Output format (json, table; default: table) |
--json | Output as JSON |
Bucket Configuration Commands
tigris buckets set-ttl <name>
Configure object expiration (TTL) on a bucket.
tigris buckets set-ttl my-bucket --days 30
tigris buckets set-ttl my-bucket --date 2026-06-01
tigris buckets set-ttl my-bucket --disable
| Flag | Alias | Description |
|---|---|---|
--days | -d | Expire objects after this many days |
--date | Expire objects on this date (ISO-8601, e.g. 2026-06-01) | |
--enable | Enable TTL (uses existing lifecycle rules) | |
--disable | Disable TTL on the bucket |
tigris buckets set-locations <name>
Set the data locations for a bucket.
tigris buckets set-locations my-bucket --locations iad
tigris buckets set-locations my-bucket --locations iad,fra
tigris buckets set-locations my-bucket --locations global
| Flag | Alias | Description |
|---|---|---|
--locations | -l | Bucket location(s) — comma-separated (see Locations) |
tigris buckets set-migration <name>
Configure data migration from an external S3-compatible source bucket. Tigris pulls objects on demand from the source (shadow bucket pattern).
tigris buckets set-migration my-bucket \
--bucket source-bucket \
--endpoint https://s3.amazonaws.com \
--region us-east-1 \
--access-key AKIA... \
--secret-key wJal...
# Enable write-through (writes go to both source and Tigris)
tigris buckets set-migration my-bucket \
--bucket source-bucket \
--endpoint https://s3.amazonaws.com \
--region us-east-1 \
--access-key AKIA... \
--secret-key wJal... \
--write-through
# Disable migration
tigris buckets set-migration my-bucket --disable
Migration workflow: Point Tigris at your existing S3-compatible bucket. Tigris serves objects on demand — when a request hits Tigris and the object isn't cached yet, it fetches from the source. Over time, all accessed objects are pulled into Tigris. Use --write-through to also push new writes back to the source during migration.
| Flag | Alias | Description |
|---|---|---|
--bucket | -b | Name of the source bucket to migrate from |
--endpoint | -e | Endpoint URL of the source S3-compatible service |
--region | -r | Region of the source bucket |
--access-key | --key | Access key for the source bucket |
--secret-key | --secret | Secret key for the source bucket |
--write-through | Enable write-through mode | |
--disable | Disable migration and clear all migration settings |
tigris buckets set-transition <name>
Configure a lifecycle transition rule. Automatically move objects to a different storage class after a number of days or on a specific date.
tigris buckets set-transition my-bucket --storage-class STANDARD_IA --days 30
tigris buckets set-transition my-bucket --storage-class GLACIER --date 2026-06-01
tigris buckets set-transition my-bucket --enable
tigris buckets set-transition my-bucket --disable
| Flag | Alias | Description |
|---|---|---|
--storage-class | -s | Target storage class (STANDARD_IA, GLACIER, GLACIER_IR) |
--days | -d | Transition objects after this many days |
--date | Transition objects on this date (ISO-8601) | |
--enable | Enable lifecycle transition rules | |
--disable | Disable lifecycle transition rules |
tigris buckets set-notifications <name>
Configure object event notifications. Sends webhook requests to a URL when objects are created, updated, or deleted.
tigris buckets set-notifications my-bucket --url https://example.com/webhook
tigris buckets set-notifications my-bucket --url https://example.com/webhook --token secret123
tigris buckets set-notifications my-bucket --url https://example.com/webhook --username admin --password secret
tigris buckets set-notifications my-bucket --url https://example.com/webhook --filter 'WHERE `key` REGEXP "^images"'
tigris buckets set-notifications my-bucket --enable
tigris buckets set-notifications my-bucket --disable
tigris buckets set-notifications my-bucket --reset
| Flag | Alias | Description |
|---|---|---|
--url | -u | Webhook URL (must be http or https) |
--filter | -f | SQL WHERE clause to filter events by key |
--token | -t | Token for webhook authentication |
--username | Username for basic webhook authentication | |
--password | Password for basic webhook authentication | |
--enable | Enable notifications (uses existing config) | |
--disable | Disable notifications (preserves existing config) | |
--reset | Clear all notification settings |
tigris buckets set-cors <name>
Configure CORS rules on a bucket. Each invocation adds a rule unless --override or --reset is used.
tigris buckets set-cors my-bucket --origins '*' --methods GET,HEAD
tigris buckets set-cors my-bucket --origins https://example.com --methods GET,POST --headers Content-Type,Authorization --max-age 3600
tigris buckets set-cors my-bucket --origins https://example.com --override
tigris buckets set-cors my-bucket --reset
| Flag | Alias | Description |
|---|---|---|
--origins | -o | Allowed origins (comma-separated, or * for all) |
--methods | -m | Allowed HTTP methods (comma-separated) |
--headers | Allowed request headers (comma-separated, or *) | |
--expose-headers | Response headers to expose (comma-separated) | |
--max-age | Preflight cache duration in seconds (default: 3600) | |
--override | Replace all existing CORS rules instead of appending | |
--reset | Clear all CORS rules |
Snapshots
Snapshots are point-in-time, read-only copies of a bucket's state. The bucket must be created with --enable-snapshots.
tigris snapshots list <bucket> (alias: l)
List all snapshots for a bucket, ordered by creation time.
tigris snapshots list my-bucket
tigris snapshots list my-bucket --json
| Flag | Description |
|---|---|
--format / -f | Output format (json, table, xml; default: table) |
--json | Output as JSON |
tigris snapshots take <bucket> [name] (alias: t)
Take a new snapshot of the bucket's current state. Optionally provide a name.
tigris snapshots take my-bucket
tigris snapshots take my-bucket my-snapshot
Forks
Forks are copy-on-write clones of a bucket. They are instant, free, and isolated — writes to the fork do not affect the source bucket.
Create a fork
# Preferred: use mk or buckets create with --fork-of
tigris mk my-fork --fork-of my-bucket
tigris mk my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
# Equivalent via buckets create
tigris buckets create my-fork --fork-of my-bucket
tigris buckets create my-fork --fork-of my-bucket --source-snapshot 1765889000501544464
List forks
tigris buckets list --forks-of my-bucket
Deprecated commands:
tigris forks listandtigris forks createstill work but are deprecated. Usetigris buckets list --forks-ofandtigris mk --fork-ofinstead.
Reference Tables
Storage Tiers
| Tier | Value | Description |
|---|---|---|
| Standard | STANDARD | Default. High durability, availability, and performance for frequently accessed data |
| Infrequent Access | STANDARD_IA | Lower-cost for data accessed less frequently but requiring rapid access when needed |
| Archive | GLACIER | Low-cost for long-term data archiving with infrequent access |
| Instant Retrieval Archive | GLACIER_IR | Lowest-cost for long-lived, rarely accessed data requiring retrieval in milliseconds |
Locations
| Name | Value | Description |
|---|---|---|
| Global | global | Global (default) |
| USA | usa | Restrict to USA |
| Europe | eur | Restrict to Europe |
| Amsterdam | ams | Amsterdam, Netherlands |
| Frankfurt | fra | Frankfurt, Germany |
| Sao Paulo | gru | Sao Paulo, Brazil |
| Ashburn | iad | Ashburn, Virginia (US) |
| Johannesburg | jnb | Johannesburg, South Africa |
| London | lhr | London, United Kingdom |
| Tokyo | nrt | Tokyo, Japan |
| Chicago | ord | Chicago, Illinois (US) |
| Singapore | sin | Singapore, Singapore |
| San Jose | sjc | San Jose, California (US) |
| Sydney | syd | Sydney, Australia |
Consistency Levels (deprecated — use --locations instead)
| Level | Value | Description |
|---|---|---|
| Default | default | Strict read-after-write in same region, eventual consistency globally |
| Strict | strict | Strict read-after-write globally (higher latency) |
FAQ
What does the tigris-buckets skill do?
Use when creating, configuring, or deleting Tigris buckets — includes regions, tiers, CORS, migrations, TTL, notifications, snapshots, and forks
How do I install tigris-buckets?
Run npx skills add https://github.com/tigrisdata/tigris-agents-plugins --skill tigris-buckets in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/tigris-buckets/ (personal) or .claude/skills/tigris-buckets/ (project).
Which AI agents can use tigris-buckets?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is tigris-buckets safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains tigris-buckets?
It is published by tigrisdata in tigrisdata/tigris-agents-plugins. It has 83 recorded installs.
More from tigrisdata/tigris-agents-plugins
tigris-objects
tigrisdata/tigris-agents-plugins
Use when uploading, downloading, listing, moving, deleting, or presigning objects in Tigris Storage
tigris-access-keys
tigrisdata/tigris-agents-plugins
Use when creating, listing, assigning, or deleting access keys for Tigris Storage
tigris-iam
tigrisdata/tigris-agents-plugins
Use when managing IAM policies, users, and permissions in a Tigris organization
tigris-authentication
tigrisdata/tigris-agents-plugins
Use when authenticating with Tigris, managing credentials, or setting up the CLI
Popular other skills
hyperframes-cli
heygen-com/hyperframes
The HyperFrames CLI by job - scaffold, check, look at frames, edit the timeline, preview, render locally or in the cloud, publish, project history - plus reading its JSON and recovering from build or render failures.
triage
mattpocock/skills
Move issues and external PRs through a state machine of triage roles, categorise, verify, grill if needed, and write agent-ready briefs.
ask-matt
mattpocock/skills
Ask which skill or flow fits your situation. A router over the skills in this repo.
to-questionnaire
mattpocock/skills
Turn a decision you can't fully answer into a questionnaire for someone else to fill in.
loop-me
mattpocock/skills
Grill me about specs for the workflows I want to build, within this workspace.