Package Exports

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (@originalvoices/cli) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

OriginalVoices CLI

Command-line interface for the OriginalVoices API — ask questions to Digital Twins, manage audiences, and explore projects from your terminal.

Installation

npm install -g @originalvoices/cli

Or run directly with npx:

npx @originalvoices/cli ask "What matters most when buying coffee?" --audience "coffee drinkers aged 20-40"

Requires Node.js 18+.

Authentication

# Interactive login
ov auth login

# Or pass your key directly
ov auth login --key ov_live_abc123

# Use an environment variable (for CI/scripting)
export OV_API_KEY=ov_live_abc123

# Check auth status
ov auth status

# Remove stored key
ov auth logout

Your API key is stored at ~/.ov/config.json. The OV_API_KEY environment variable takes priority over the config file.

Usage

Ask questions

Ask open-ended questions to an audience:

ov ask "What factors influence your decision to try a new skincare product?" \
  --audience "women aged 25-45 in the US"

Ask multiple questions at once:

ov ask "What do you look for in a coffee brand?" "How often do you try new brands?" \
  --audience "coffee drinkers aged 20-40"

Ask a saved audience by ID:

ov ask "What would make you switch banks?" --audience-id 550e8400-e29b-41d4-a716-446655440000

Ask a multiple choice question:

ov ask "Which social media platform do you use most?" \
  --audience "Gen Z men 18-25" \
  --type choices \
  --choices "Instagram,TikTok,YouTube,X,Facebook"

Ask a project's panel with a filter:

ov ask "What frustrates you about navigation apps?" \
  --project 550e8400-e29b-41d4-a716-446655440000 \
  --filter "people who use navigation apps daily"

Control sample size:

ov ask "How do you discover new music?" \
  --audience "millennials in urban areas" \
  --sample-size high

Available sample sizes: low, medium (default), high, very_high.

Manage audiences

# List saved audiences
ov audiences list

# Create a new audience
ov audiences create --title "Health-conscious millennials" --prompt "Health-conscious adults aged 25-40"

# Update an audience title
ov audiences update <id> --title "New title"

# Delete an audience
ov audiences delete <id>

List projects

ov projects list

JSON output

Use the --json flag to get raw JSON output, useful for scripting and piping:

ov ask "What do you think about electric cars?" --audience "car owners 30-50" --json

ov audiences list --json | jq '.data.audiences[].title'

Configuration

Source	Priority
`--api-key` flag	Highest
`OV_API_KEY` env var	Medium
`~/.ov/config.json`	Lowest

Set a custom API base URL:

ov auth login --base-url https://your-api-url.com

Or via environment variable:

export OV_BASE_URL=https://your-api-url.com