CLI Recipes

Inspect Input

./snout csv-info metrics.csv
./snout jsonl-info events.jsonl
./snout log-info access.log
./snout info dataset.snout

Profile Data

./snout sniff -f metrics.csv
./snout sniff -f events.jsonl --top 5 --suggestions 3
./snout sniff -f access.log --format json

Group and Aggregate

./snout -f metrics.csv group=region -- count=rows
./snout -f metrics.csv group=region -- avg=latency_ms p95=latency_ms
./snout -f metrics.csv group=region,status -- count=rows

Filter, Sort, and Limit

./snout -f metrics.csv group=region -- \
  avg=latency_ms count=rows \
  --where status ge 500 \
  --sort avg=latency_ms desc \
  --limit 10

Supported filter operators include eq, ne, lt, le, gt, ge, is-null, and not-null.

Choose Output Format

./snout -f metrics.csv group=region -- count=rows --format table
./snout -f metrics.csv group=region -- count=rows --format csv
./snout -f metrics.csv group=region -- count=rows --format json
./snout -f metrics.csv group=region -- count=rows --format jsonl

Import Raw Data

./snout csv-import metrics.csv metrics.snout
./snout jsonl-import events.jsonl events.snout
./snout log-import access.log access.snout

Combine and Reshape

./snout append base.snout extra.snout combined.snout
./snout consolidate day1.snout day2.snout all.snout
./snout compact all.snout compacted.snout
./snout transform input.snout output.snout rename=endpoint:path

Read from Standard Input

cat metrics.csv | ./snout sniff -f -
cat metrics.csv | ./snout -f - group=region -- count=rows