tigris-objects
Use when uploading, downloading, listing, moving, deleting, or presigning objects in Tigris Storage
- Installs
- 84
- 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-objects- 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-objects 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 Object Operations
Quick Reference
| Command | Description |
|---|---|
tigris ls [path] | List objects under a bucket/prefix |
tigris cp <src> <dest> | Copy files local↔remote or remote↔remote |
tigris mv <src> <dest> | Move/rename objects within Tigris |
tigris rm <path> | Delete objects or folders |
tigris touch <path> | Create an empty object |
tigris stat <path> | Show object metadata or storage stats |
tigris presign <path> | Generate a presigned URL |
tigris objects list <bucket> | List objects (low-level) |
tigris objects get <bucket> <key> | Download an object (low-level) |
tigris objects put <bucket> <key> <file> | Upload an object (low-level) |
tigris objects delete <bucket> <key> | Delete an object (low-level) |
tigris objects set <bucket> <key> | Update object settings (low-level) |
URI Scheme
Remote paths use t3://bucket/key or tigris://bucket/key. Bare bucket/key paths are also accepted.
Unix-Style Commands (primary interface)
tigris ls [path] (alias: list)
List all buckets (no arguments) or objects under a bucket/prefix path.
tigris ls # list all buckets
tigris ls my-bucket # list objects in bucket
tigris ls my-bucket/images/ # list objects under prefix
tigris ls t3://my-bucket/prefix/
| Flag | Alias | Description | Default |
|---|---|---|---|
--snapshot-version | --snapshot | Read from a specific bucket snapshot | |
--format | -f | Output format (json, table, xml) | table |
--json | Output as JSON |
tigris cp <src> <dest> (alias: copy)
Copy files between local filesystem and Tigris, or between paths within Tigris. At least one side must be a remote t3:// path. Quote wildcard patterns to prevent shell expansion.
tigris cp ./file.txt t3://my-bucket/file.txt # upload
tigris cp t3://my-bucket/file.txt ./local-copy.txt # download
tigris cp t3://my-bucket/src/ t3://my-bucket/dest/ -r # remote-to-remote
tigris cp ./images/ t3://my-bucket/images/ -r # recursive upload
| Flag | Alias | Description |
|---|---|---|
--recursive | -r | Copy directories recursively |
--format | -f | Output format (json, table; default: table) |
--json | Output as JSON |
tigris mv <src> <dest> (alias: move)
Move (rename) objects within Tigris. Both source and destination must be remote paths. Quote wildcard patterns to prevent shell expansion.
tigris mv t3://my-bucket/old.txt t3://my-bucket/new.txt -f
tigris mv t3://my-bucket/old-dir/ t3://my-bucket/new-dir/ -rf
tigris mv my-bucket/a.txt my-bucket/b.txt -f
| Flag | Alias | Description |
|---|---|---|
--recursive | -r | Move directories recursively |
--force | -f | Skip confirmation prompt |
--format | Output format (json, table; default: table) | |
--json | Output as JSON |
tigris rm <path> (alias: remove)
Remove a bucket, folder, or object from Tigris. A bare bucket name deletes the bucket itself. Quote wildcard patterns to prevent shell expansion.
tigris rm t3://my-bucket/file.txt -f
tigris rm t3://my-bucket/folder/ -rf
tigris rm t3://my-bucket -f # deletes the bucket
tigris rm "t3://my-bucket/logs/*.tmp" -f # wildcard delete
| Flag | Alias | Description |
|---|---|---|
--recursive | -r | Remove directories recursively |
--force | -f | Skip confirmation prompt |
--format | Output format (json, table; default: table) | |
--json | Output as JSON |
tigris touch <path>
Create an empty (zero-byte) object at the given bucket/key path.
tigris touch my-bucket/placeholder.txt
tigris touch t3://my-bucket/logs/
| Flag | Alias | Description |
|---|---|---|
--format | -f | Output format (json, table; default: table) |
--json | Output as JSON |
tigris stat [path]
Show storage stats (no args), bucket info, or object metadata.
tigris stat # overall storage stats
tigris stat t3://my-bucket # bucket info
tigris stat t3://my-bucket/my-object.json # object metadata
| Flag | Alias | Description | Default |
|---|---|---|---|
--snapshot-version | --snapshot | Read from a specific bucket snapshot | |
--format | -f | Output format (json, table, xml) | table |
--json | Output as JSON |
Presigned URLs
tigris presign <path>
Generate a presigned URL for temporary access to an object without credentials.
tigris presign my-bucket/file.txt
tigris presign t3://my-bucket/report.pdf --method put --expires-in 7200
tigris presign my-bucket/image.png --format json
tigris presign my-bucket/data.csv --access-key tid_AaBb
| Flag | Alias | Description | Default |
|---|---|---|---|
--method | -m | HTTP method (get, put) | get |
--expires-in | -e | URL expiry time in seconds | 3600 |
--access-key | Access key ID for signing (resolved from credentials if not provided) | ||
--format | -f | Output format (url, json) | url |
--json | Output as JSON |
Use cases:
- Temporary sharing of private objects (GET)
- Client-side uploads without exposing credentials (PUT)
Low-Level objects Subcommand
For programmatic and granular control over individual objects.
tigris objects list <bucket> (alias: l)
List objects in a bucket, optionally filtered by a key prefix.
tigris objects list my-bucket
tigris objects list my-bucket --prefix images/
tigris objects list my-bucket --json
| Flag | Alias | Description |
|---|---|---|
--prefix | -p | Filter objects by key prefix |
--snapshot-version | --snapshot | Read from a specific bucket snapshot |
--format | -f | Output format (json, table, xml; default: table) |
--json | Output as JSON |
tigris objects get <bucket> <key> (alias: g)
Download an object by key. Prints to stdout by default, or saves to a file with --output.
tigris objects get my-bucket config.json
tigris objects get my-bucket archive.zip --output ./archive.zip --mode stream
| Flag | Alias | Description |
|---|---|---|
--output | -o | Output file path (prints to stdout if not specified) |
--mode | -m | Response mode: string (loads into memory) or stream (writes in chunks) |
--snapshot-version | --snapshot | Read from a specific bucket snapshot |
--format | -f | Output format (json, table; default: table) |
--json | Output as JSON |
tigris objects put <bucket> <key> <file> (alias: p)
Upload a local file as an object. Content-type is auto-detected from extension unless overridden.
tigris objects put my-bucket report.pdf ./report.pdf
tigris objects put my-bucket logo.png ./logo.png --access public --content-type image/png
| Flag | Alias | Description | Default |
|---|---|---|---|
--access | -a | Access level (public, private) | private |
--content-type | -t | Content type (auto-detected if omitted) | |
--format | -f | Output format (json, table, xml) | table |
--json | Output as JSON |
tigris objects delete <bucket> <key> (alias: d)
Delete one or more objects by key. Accepts comma-separated keys.
tigris objects delete my-bucket old-file.txt --force
tigris objects delete my-bucket file-a.txt,file-b.txt --force
| Flag | Description |
|---|---|
--force | Skip confirmation prompt |
--format / -f | Output format (json, table; default: table) |
--json | Output as JSON |
tigris objects set <bucket> <key> (alias: s)
Update settings on an existing object such as access level or key name.
tigris objects set my-bucket my-file.txt --access public
tigris objects set my-bucket my-file.txt --access private
| Flag | Alias | Description |
|---|---|---|
--access | -a | Access level (public, private) — required |
--new-key | -n | Rename the object to a new key |
--format | -f | Output format (json, table; default: table) |
--json | Output as JSON |
Common Patterns
# Recursive upload
tigris cp ./dist/ t3://my-bucket/static/ -r
# Download an entire directory
tigris cp t3://my-bucket/backups/ ./local-backups/ -r
# Wildcard delete (quote the pattern!)
tigris rm "t3://my-bucket/logs/*.tmp" -rf
# Generate a presigned upload URL for client-side uploads
tigris presign my-bucket/user-uploads/photo.jpg --method put --expires-in 600
FAQ
What does the tigris-objects skill do?
Use when uploading, downloading, listing, moving, deleting, or presigning objects in Tigris Storage
How do I install tigris-objects?
Run npx skills add https://github.com/tigrisdata/tigris-agents-plugins --skill tigris-objects 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-objects/ (personal) or .claude/skills/tigris-objects/ (project).
Which AI agents can use tigris-objects?
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-objects 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-objects?
It is published by tigrisdata in tigrisdata/tigris-agents-plugins. It has 84 recorded installs.
More from tigrisdata/tigris-agents-plugins
tigris-buckets
tigrisdata/tigris-agents-plugins
Open the skill to read its SKILL.md instructions.
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.