WisentEcho
Echo/Docs

CLI command

characters

List safe metadata for Echo content characters.

Invocation#

Shell
echo-cli characters

Inputs and output#

This command takes no required input and defines no options. Extra positional arguments are ignored by the current dispatcher.

It writes an indented JSON array to stdout containing at most 200 characters ordered by name. Each object contains exactly id, name, handle, gender, niche, platforms, source, is_active, and created_at.

State effect#

The command performs one bounded SELECT from characters. It does not expose generation inputs and does not create, update, delete, or generate a character.

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.