CLI

Ask Digital Twins, and manage saved audiences and studies, from your terminal with ov.

npm install -g @originalvoices/cli   # Node.js 20+
ov auth login                         # paste your API key

Get a key under Developers → API Keys in the platform. It's stored in ~/.ov/config.json. You can also set OV_API_KEY, which takes priority.

Ask

ov ask "What frustrates you about project management tools?" \
  --audience "US, 25-45, tech professionals"

Pass several questions at once by listing them one after another:

ov ask "What do you look for in a running shoe?" "How much do you usually spend?" \
  --audience "UK, 18-30, fitness enthusiasts"

Choice questions: every question gets the same options. Add --multiple-choice to allow several picks.

ov ask "Which feature matters most?" \
  --audience "US, 25-45, tech professionals" \
  --type choices --choices "Price,Ease of use,Integrations,Support"

Ask a study's participants, optionally narrowed with a filter:

ov studies list
ov ask "What would make you order more often?" \
  --study <id> --filter "said price was the main barrier"

Options:

Flag	Does
--audience <text>	Who to ask, in plain words
--audience-id <id>	Ask a saved audience
--study <id>	Ask a study's participants
--filter <text>	With --study: narrow participants in plain words
--type open|choices	Question type (default open)
--choices <a,b,c>	Comma-separated options for --type choices
--multiple-choice	Allow several picks
--sample-size <n>	How many Twins answer: a number, or low (10), medium (25), high (50), very_high (100)
--json	Raw JSON output, for scripts and jq

Pass exactly one of --audience, --audience-id or --study.

Saved audiences

ov audiences create --title "US remote tech" --prompt "US, 25-45, tech professionals working remotely"
ov audiences list
ov ask "What's your biggest productivity blocker?" --audience-id <id>
ov audiences update <id> --title "US remote tech workers"
ov audiences delete <id>

All commands

Command	Does
ov auth login / status / logout	Manage your API key
ov ask <questions...>	Ask questions
ov audiences list / create / update / delete	Manage saved audiences
ov studies list	List studies to ask with --study

npm · GitHub