Tigris Objects

Tigris Object Operations

Quick Reference

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/

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

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

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

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/

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

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

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

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

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

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

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

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