Personas - Coval Documentation

List Personas

coval personas list [OPTIONS]

Option	Type	Default	Description
`--filter`	string	—	Filter expression
`--page-size`	number	50	Results per page
`--order-by`	string	—	Sort order

Output columns: ID, NAME, VOICE, LANGUAGE, CREATED

coval personas list

Get Persona

coval personas get <persona_id>

Argument	Type	Required	Description
`persona_id`	string	Yes	The persona ID

coval personas get per_abc123

Create Persona

coval personas create [OPTIONS]

Option	Type	Required	Description
`--name`	string	Yes	Persona display name
`--voice`	string	Yes	Voice name (see available voices below)
`--language`	string	Yes	Language code (e.g., `en-US`)
`--prompt`	string	No	Persona system prompt / behavior instructions
`--background`	string	No	Background sound during simulation
`--wait-seconds`	number	No	Wait time between responses

# Create a basic persona
coval personas create \
  --name "Frustrated Customer" \
  --voice "Aria" \
  --language "en-US"

# Create with full configuration
coval personas create \
  --name "Impatient Caller" \
  --voice "Callum" \
  --language "en-US" \
  --prompt "You are an impatient customer who wants quick answers" \
  --background "office" \
  --wait-seconds 1.5

Available Voices

Alejandro, Amir, Angela, Aria, Ashwin, Autumn, Brynn, Callum, Caspian, Corwin, Darrow, Delphine, Dorian, Elara, Erika, Harry, Kieran, Layla, Lysander, Marina, Mark, Monika, Naveen, Noa, Orion, Raju, Rowan, Skye, Soren, Vera, Yossi

Update Persona

coval personas update <persona_id> [OPTIONS]

Argument	Type	Required	Description
`persona_id`	string	Yes	The persona ID to update

Option	Type	Description
`--name`	string	New display name
`--voice`	string	New voice name
`--language`	string	New language code
`--prompt`	string	New system prompt
`--background`	string	New background sound
`--wait-seconds`	number	New wait time

coval personas update per_abc123 --voice "Brynn" --wait-seconds 2.0

Delete Persona

coval personas delete <persona_id>

Argument	Type	Required	Description
`persona_id`	string	Yes	The persona ID to delete

⌘I