tigris-objects
Use when uploading, downloading, listing, moving, deleting, or presigning objects in Tigris Storage
How do I install this agent skill?
npx skills add https://github.com/tigrisdata/tigris-agents-plugins --skill tigris-objectsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
The skill provides a set of instructions for managing cloud storage objects using the Tigris CLI. It enables the agent to perform standard file operations such as uploading, downloading, listing, and deleting objects in Tigris buckets, as well as generating presigned URLs for temporary access. The functionality is consistent with standard storage management tools.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
What does this agent skill do?
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
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/tigrisdata/tigris-agents-plugins/tigris-objects">View tigris-objects on skillZs</a>