On this page

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

**Alias:** `list`

## Usage

```bash
tigris ls [path]
t3 list [path]
```

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) |

## Examples

```bash
# 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
```