Docs
⌘K

CLI: Analytics, remote config, experiments and tester builds

Read product analytics (active users, events, funnels, retention) and export events, manage remote config and feature flags as a file in git, run A/B experiments, and send test builds to testers with sov.

Updated Oct 26, 2026
sov config pull            # writes sovaria/config.json
sov config diff
sov config publish -m "Turn on new checkout for 10%"
sov config rollback 12

#sov analytics

Product analytics: active users, events, funnels, retention, export

sov analytics overview

DAU / WAU / MAU, events and top events, platforms, countries, usage.

sov analytics overview [OPTIONS]

Arguments and options

--daysint rangeoptionaldefault 30
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics events

Event names with counts.

sov analytics events [OPTIONS]

Arguments and options

--daysint rangeoptionaldefault 30
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics trend

One event per day: count and distinct users.

sov analytics trend [OPTIONS] NAME

Arguments and options

NAMEtextrequired
--daysint rangeoptionaldefault 30
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics funnel

Conversion through ordered steps.

sov analytics funnel [OPTIONS] STEPS

Arguments and options

STEPStextrequired
event names in order
--windowintegeroptionaldefault 24
hours from the first step
--daysint rangeoptionaldefault 30
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics retention

Retention cohorts (finished periods only).

sov analytics retention [OPTIONS]

Arguments and options

--starttextoptional
cohort event (default: first seen)
--returntextoptional
return event (default: any activity)
--periodtextoptionaldefault week
week | day
--periodsintegeroptionaldefault 8
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics users

Recently seen app users and their properties.

sov analytics users [OPTIONS]

Arguments and options

--qtextoptional
--limitint rangeoptionaldefault 50
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics user

One user's profile, consent and latest events.

sov analytics user [OPTIONS] USER_KEY

Arguments and options

USER_KEYtextrequired
--limitint rangeoptionaldefault 100
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics live

Newest events as they arrive (debug view).

sov analytics live [OPTIONS]

Arguments and options

--follow / -fflagoptional
keep printing new events
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics export

Raw events (analytics.export_sql).

sov analytics export [OPTIONS]

--to-db makes them SQL-queryable next to your app's tables.

Arguments and options

--sincetextoptional
ISO date (default: 7 days ago)
--untiltextoptional
--formattextoptionaldefault csv
csv | ndjson
--namestextoptional
comma-separated event names
--outpathoptional
file to write (default: stdout)
--to-dbflagoptional
copy into a table in the project's own Postgres
--tabletextoptionaldefault sovaria_analytics.events
--limitint rangeoptionaldefault 1000000
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics erase

Erase one user's analytics (events, properties) and stop collecting theirs.

sov analytics erase [OPTIONS] USER_KEY

Can't be undone.

Arguments and options

USER_KEYtextrequired
--yesflagoptional
confirm
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov analytics settings

Show (or set) whether only users who consented are recorded.

sov analytics settings [OPTIONS]

Arguments and options

--require-consent / --no-require-consentflagoptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

#sov config

Remote config and feature flags: pull/push, diff, publish, rollback

sov config pull

Write the config template to a file (commit it to git).

sov config pull [OPTIONS]

Arguments and options

--file / -fpathoptionaldefault sovaria/config.json
template file
--publishedflagoptional
the live version, not the draft
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config push

Replace the draft with the file.

sov config push [OPTIONS]

Nothing goes live until sov config publish.

Arguments and options

--file / -fpathoptionaldefault sovaria/config.json
template file
--prune / --no-pruneflagoptional
remove what the file doesn't have
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config diff

What publishing the draft (or a file) would change.

sov config diff [OPTIONS]

Arguments and options

--file / -fpathoptional
compare this file instead of the draft
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config preview

How many recently seen users would get different values if the draft were published.

sov config preview [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config publish

Publish the draft: live apps get the new values.

sov config publish [OPTIONS]

Arguments and options

--message / -mtextoptional
--attextoptional
publish later (ISO time)
--yesflagoptional
don't ask
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config versions

Published and scheduled versions.

sov config versions [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config rollback

Publish an older version again (as a new version).

sov config rollback [OPTIONS] VERSION

Arguments and options

VERSIONintegerrequired
--yesflagoptional
--message / -mtextoptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config set

Set a parameter's default in the draft (publish to make it live).

sov config set [OPTIONS] KEY VALUE

Arguments and options

KEYtextrequired
VALUEtextrequired
--typetextoptionaldefault string
bool | string | number | json
--descriptiontextoptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov config evaluate

The values one user/device would get.

sov config evaluate [OPTIONS]

Arguments and options

--usertextoptional
--platformtextoptional
--app-versiontextoptional
--countrytextoptional
--attrstextoptional
JSON object of user properties
--draftflagoptional
evaluate the draft instead of the published version
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

#sov experiments

A/B experiments on remote config parameters

sov experiments list

sov experiments list.

sov experiments list [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov experiments create

Create a draft experiment (start it with sov experiments start).

sov experiments create [OPTIONS] NAME

Arguments and options

NAMEtextrequired
--paramtextrequired
--varianttextrequired
--controltextoptional
default: the first variant
--goaltextoptional
analytics event that counts as success
--goal-sqltextoptional
SELECT user_id[, value] … on your tables
--metrictextoptionaldefault conversion
conversion | mean
--value-proptextoptional
--exposurenumberoptionaldefault 100
--conditiontextoptional
--min-sampleintegeroptionaldefault 100
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov experiments start

Start splitting live users (publishes a config version).

sov experiments start [OPTIONS] NAME

Arguments and options

NAMEtextrequired
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov experiments stop

sov experiments stop.

sov experiments stop [OPTIONS] NAME

Arguments and options

NAMEtextrequired
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov experiments results

Per-variant results: lift, 95% interval, p-value, sample-ratio check, winner.

sov experiments results [OPTIONS] NAME

Arguments and options

NAMEtextrequired
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov experiments rollout

Make a variant the parameter's default for everyone, end the experiment and publish.

sov experiments rollout [OPTIONS] NAME

Arguments and options

NAMEtextrequired
--varianttextoptional
default: the winner
--yesflagoptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

#sov distribute

Tester builds (APK, AAB, IPA): upload, groups, invites

sov distribute upload

Upload a build, read its metadata, share it with groups and email testers.

sov distribute upload [OPTIONS] FILE

Arguments and options

FILEfilerequired
--groupstextoptional
comma-separated tester groups to share with
--notestextoptional
release notes (or @file)
--git-reftextoptional
commit or PR the build came from
--apptextoptional
registered mobile app id
--notify / --no-notifyflagoptional
email the groups' testers
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov distribute releases

sov distribute releases.

sov distribute releases [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov distribute testers list

sov distribute testers list.

sov distribute testers list [OPTIONS]
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov distribute testers add

sov distribute testers add.

sov distribute testers add [OPTIONS] EMAILS

Arguments and options

EMAILStextrequired
--groupstextoptional
--invite / --no-inviteflagoptional
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov distribute testers remove

sov distribute testers remove.

sov distribute testers remove [OPTIONS] TESTER_ID

Arguments and options

TESTER_IDtextrequired
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

sov distribute testers invite

sov distribute testers invite.

sov distribute testers invite [OPTIONS] TESTER_ID

Arguments and options

TESTER_IDtextrequired
  • Also takes --profile, --org, --project and --env to act on another account, organization, project or environment.

Related

CLI referenceConnect your app