MCPInstall

tigris-bucket-management

Use when creating, listing, inspecting, or deleting Tigris Storage buckets

Installs
125
Last 24h
—
Trending rank
—
Security
Not audited

Install

Works with every agent the skills CLI supports.

npx skills add https://github.com/tigrisdata/skills --skill tigris-bucket-management
  1. 01

    Install

    Run the command in your project. The CLI asks which agents to install for.

  2. 02

    Describe the task

    Ask your agent for something this skill covers. It loads tigris-bucket-management automatically when relevant.

  3. 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

Prerequisites

Before doing anything else, install the Tigris CLI if it's not already available:

tigris help || npm install -g @tigrisdata/cli

If you need to install it, tell the user: "I'm installing the Tigris CLI (@tigrisdata/cli) so we can work with Tigris object storage."

Overview

Buckets are containers for objects. This skill covers bucket lifecycle: create, list, inspect, and delete.

Quick Reference

OperationFunctionKey Parameters
CreatecreateBucket(name, options)name, access, region, enableSnapshot
ListlistBuckets(options)limit, paginationToken
InspectgetBucketInfo(name)bucketName
DeleteremoveBucket(name, options)bucketName, force

Create Bucket

import { createBucket } from "@tigrisdata/storage";

// Simple private bucket
const result = await createBucket("my-new-bucket");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Created:", result.data);
}

// Public bucket (objects readable by anyone)
const result = await createBucket("public-assets", {
  access: "public",
});

// Snapshot-enabled bucket (for version control)
const result = await createBucket("my-snapshot-bucket", {
  enableSnapshot: true,
});

// Regional bucket
const result = await createBucket("eu-data", {
  region: "eu",
});

// Fork from existing bucket snapshot
const result = await createBucket("my-forked-bucket", {
  sourceBucketName: "parent-bucket",
  sourceBucketSnapshot: "1751631910169675092",
});

Create Bucket Options

OptionValuesDefaultPurpose
accesspublic/privateprivateObject readability
consistencydefault/strictdefaultRead consistency level
defaultTierSTANDARD/STANDARD_IA/GLACIER/GLACIER_IRSTANDARDDefault storage tier
enableSnapshotbooleanfalseEnable snapshots/forking
regionstringglobalBucket region
sourceBucketNamestring-Fork from this bucket
sourceBucketSnapshotstring-Fork from this snapshot

Note: Snapshot-enabled buckets must use STANDARD tier.

List Buckets

import { listBuckets } from "@tigrisdata/storage";

// List all buckets
const result = await listBuckets();
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Buckets:", result.data?.buckets);
  console.log("Owner:", result.data?.owner);
}

// Paginated list
const allBuckets = [];
let currentPage = await listBuckets({ limit: 10 });
allBuckets.push(...currentPage.data?.buckets);

while (currentPage.data?.paginationToken) {
  currentPage = await listBuckets({
    limit: 10,
    paginationToken: currentPage.data?.paginationToken,
  });
  allBuckets.push(...currentPage.data?.buckets);
}

Get Bucket Info

import { getBucketInfo } from "@tigrisdata/storage";

const result = await getBucketInfo("my-bucket");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Info:", result.data);
  // {
  //   isSnapshotEnabled: true,
  //   hasForks: false,
  //   sourceBucketName: undefined,
  //   sourceBucketSnapshot: undefined
  // }
}

Delete Bucket

import { removeBucket } from "@tigrisdata/storage";

// Delete empty bucket
const result = await removeBucket("my-bucket");
if (result.error) {
  console.error("Error:", result.error);
} else {
  console.log("Deleted successfully");
}

// Force delete (even if not empty)
const result = await removeBucket("my-bucket", {
  force: true,
});

Warning: Force delete is irreversible. All objects will be lost.

Bucket Access Levels

LevelBehaviorUse Case
privateObjects require authDefault, sensitive data
publicObjects publicly readableStatic assets, public content

Consistency Levels

LevelBehaviorTrade-off
defaultLow latency, eventual consistencyMost workloads
strictStrong consistency, higher latencyCritical data

Storage Tiers

TierUse CaseCost
STANDARDGeneral purposeStandard
STANDARD_IAInfrequently accessedLower cost
GLACIERLong-term archiveLowest cost
GLACIER_IRRare access, fast retrievalArchive with occasional access

Regions

Specify region for data locality or compliance:

await createBucket("data-eu", { region: "eu" });
await createBucket("data-asia", { region: "asia-south-1" });

Leave empty for global bucket (recommended for most use cases).

Common Mistakes

MistakeFix
Enable snapshot with non-STANDARD tierSnapshot requires STANDARD tier
Not checking bucket exists before deleteUse getBucketInfo first
Trying to delete non-empty bucket without forceUse force: true or empty bucket first
Name conflictsBucket names must be globally unique

Forking and Snapshots

For version control (snapshots/forking), see the tigris-snapshots-forking skill.

FAQ

What does the tigris-bucket-management skill do?

Use when creating, listing, inspecting, or deleting Tigris Storage buckets

How do I install tigris-bucket-management?

Run npx skills add https://github.com/tigrisdata/skills --skill tigris-bucket-management 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-bucket-management/ (personal) or .claude/skills/tigris-bucket-management/ (project).

Which AI agents can use tigris-bucket-management?

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-bucket-management 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-bucket-management?

It is published by tigrisdata in tigrisdata/skills. It has 125 recorded installs.

More from tigrisdata/skills

View all →

tigris-object-operations

tigrisdata/skills

Use when working with objects in Tigris Storage - uploading, downloading, deleting, listing, getting metadata, or generating presigned URLs

3.2K installs

Use when configuring CORS, rotating access keys, setting bucket policies, or securing Tigris storage — covers key lifecycle, roles, CORS rules, presigned URL security, audit checklist

Security3.2K installs

file-storage

tigrisdata/skills

Use when working with Tigris file storage - uploading, downloading, deleting, listing files, presigned URLs, client uploads, or setting up Tigris CLI and SDK. Covers Next.js, Remix, Express, Rails, and Laravel. For Python/Django, see the tigris-python-sdk skill.

Backend & APIs3.2K installs

tigris-sdk-guide

tigrisdata/skills

Use when choosing between Tigris-native SDKs and AWS S3-compatible SDKs — covers which SDK to use per language, CLI preference, and when AWS SDKs are the only option

DevOps & Cloud3.2K installs

tigris-image-optimization

tigrisdata/skills

Use when resizing images, generating thumbnails, serving responsive images, or optimizing image delivery with Tigris — covers Next.js, Remix, Rails, Django, Laravel, Express

Media & Creative3.2K installs

tigris-s3-migration

tigrisdata/skills

Use when migrating from AWS S3, Google Cloud Storage, or Azure Blob to Tigris — shadow buckets via tigris buckets set-migration, active drain via tigris buckets migrate, bulk copy, SDK endpoint swap, zero-downtime migration

Popular other skills

View category →

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.

1.3M installs

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.

1M installs

ask-matt

mattpocock/skills

Ask which skill or flow fits your situation. A router over the skills in this repo.

778.4K installs

to-questionnaire

mattpocock/skills

Turn a decision you can't fully answer into a questionnaire for someone else to fill in.

508.9K installs

wait-what

mattpocock/skills

Stop. That last message did not land: re-pitch it.

459.7K installs

loop-me

mattpocock/skills

Grill me about specs for the workflows I want to build, within this workspace.

447.9K installs