Echo/Docs

CLI command

personas

List audience personas, optionally restricted to one Echo content product.

Invocation#

Shell
echo-cli personas [product_id]

Inputs and output#

product_id is optional. When supplied, it is used as an exact product_id filter. There are no named options.

The command writes an indented JSON array to stdout containing at most 200 personas, oldest created_at first. Each object contains exactly id, product_id, name, age_range, gender, interests, pain_points, goals, platforms, description, created_by, and created_at.

State effect#

The command performs one bounded SELECT from personas. It does not create, update, or delete personas or products.

Refusals#

  • Without NEXT_PUBLIC_SUPABASE_URL it prints exactly "NEXT_PUBLIC_SUPABASE_URL is not configured" to stderr and exits 1.
  • After the URL is present, without SUPABASE_SERVICE_ROLE_KEY it prints exactly "SUPABASE_SERVICE_ROLE_KEY is not configured" to stderr and exits 1.
  • If Supabase refuses the SELECT, the CLI prints the returned database error message to stderr and exits 1.