# Download an object by key

Prints to stdout by default, or saves to a file with `--output`.

**Alias:** `g`

## Usage

```bash
tigris objects get <bucket> <key> [flags]
t3 o g <bucket> <key> [flags]
```

## Flags

| Name                          | Required | Default | Description                                                                                       |
| ----------------------------- | -------- | ------- | ------------------------------------------------------------------------------------------------- |
| `--output`, `-o`             | No       | —       | Output file path (if not specified, prints to stdout)                                           |
| `--mode`, `-m`               | No       | —       | Response mode: "string" loads into memory, "stream" writes in chunks (auto-detected from extension if not specified) |
| `--snapshot-version`, `-snapshot` | No       | —       | Read from a specific bucket snapshot                                                               |
| `--version-id`               | No       | —       | Download a specific object version (requires bucket versioning). Omit for latest                |

## Examples

```bash
# Print object to stdout
tigris objects get my-bucket config.json

# Save object to a file (streaming for large files)
tigris objects get my-bucket archive.zip --output ./archive.zip --mode stream
```