> ## Documentation Index
> Fetch the complete documentation index at: https://docs.siftstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Export data with the Sift CLI

> Export Run and Asset telemetry from Sift to a file from the command line.

The Sift CLI exports telemetry from a Run or an Asset. Use it to pull data out of Sift for downstream analysis, sharing, or archiving without leaving the command line.

## Before you begin

* Install and configure the CLI. See [Sift CLI setup](/documentation/cli/sift-cli).
* For every command, flag, and supported value, see the [Sift CLI reference](/documentation/reference/cli-reference).

## Import commands overview

Both export commands share these flags:

* `--output` / `-o`: the file to generate. Required.
* `--format` / `-f`: the output format. Required. Accepts `csv`, `parquet`, or `sun` (WinPlot).
* `--channel` / `-c`: a Channel name to include. Repeat the flag to add more.
* `--channel-id`: a Channel ID to include. Repeat the flag to add more.
* `--channel-regex` / `-x`: a regular expression that selects Channels by name.
* `--calculated-channel`, `--calculated-channel-id`, `--calculated-channel-regex`: the same selectors for Calculated Channels.

## Export a Run

Identify the Run by name, ID, or client key. These three selectors are mutually exclusive.

```bash theme={null}
sift-cli export run --name "my-run" \
  --output ./run.parquet \
  --format parquet \
  --channel voltage \
  --channel current
```

| Selector   | Flag                  |
| ---------- | --------------------- |
| Name       | `--name` / `-n`       |
| Run ID     | `--run-id` / `-r`     |
| Client key | `--client-key` / `-k` |

To include Calculated Channels, add them with the calculated-channel selectors:

```bash theme={null}
sift-cli export run --run-id <run-id> \
  --output ./run.csv \
  --format csv \
  --calculated-channel-regex "power.*"
```

## Export an Asset

Pass the Asset name as a positional argument. Asset exports require a time range set with `--start` and `--stop` in RFC 3339 format.

```bash theme={null}
sift-cli export asset my-asset \
  --output ./asset.csv \
  --format csv \
  --start 2026-01-01T00:00:00Z \
  --stop 2026-01-02T00:00:00Z \
  --channel-regex "temp.*"
```