Skip to main content
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

​
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. 
sift-cli export run --name "my-run" \
  --output ./run.parquet \
  --format parquet \
  --channel voltage \
  --channel current
SelectorFlag
Name--name / -n
Run ID--run-id / -r
Client key--client-key / -k
To include Calculated Channels, add them with the calculated-channel selectors: 
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. 
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.*"