tigris ls

List all buckets (no arguments) or objects under a bucket/prefix path. Accepts bare names or t3:// URIs.

Alias: list

Usage

tigris ls [path] [flags]
t3 list [path] [flags]

Paths support the optional t3:// (or tigris://) prefix (e.g. t3://my-bucket/path or just my-bucket/path).

Flags

Name	Required	Default	Description
--source	No	—	List objects from a specific storage source on buckets with shadow migration enabled. Accepted values: tigris (objects already in Tigris), shadow (objects still on the shadow source)
--snapshot-version, -snapshot	No	—	Read from a specific bucket snapshot. Accepts a snapshot version string or any UNIX nanosecond-precision timestamp (e.g. 1765889000501544464)
--limit	No	—	Maximum number of items to return per page
--page-token, -pt	No	—	Pagination token from a previous request to fetch the next page

Examples

# List all buckets
tigris ls

# List objects in a bucket
tigris ls my-bucket

# List objects under a prefix
tigris ls my-bucket/images/

# Using t3:// prefix
tigris ls t3://my-bucket/prefix/

# On a shadow-migrated bucket, list only objects still on the source
tigris ls my-bucket --source shadow

# Or only objects already migrated into Tigris
tigris ls my-bucket --source tigris

# List a bucket as it was in a snapshot
tigris ls my-bucket --snapshot-version 1765889000501544464

# Page through a large listing
tigris ls my-bucket --limit 100
tigris ls my-bucket --limit 100 --page-token <token-from-previous-page>