Commands Reference

Main Commands

persona

Launch interactive TUI mode.

persona ls

List all configured providers.

persona ls

persona use <id>

Switch to a provider by ID.

persona use abc12345

persona add

Add a new provider interactively or with flags.

# Interactive mode
persona add

# With flags
persona add --template openai --name "My OpenAI" --api-key sk-xxx

Options:

• --template<name> - Use a provider template
• --name <name> - Provider name
• --base-url <url> - API base URL
• --default-model <model> - Default model
• --haiku-model <model> - Haiku model
• --opus-model <model> - Opus model
• --sonnet-model <model> - Sonnet model

persona edit <id>

Edit an existing provider.

persona edit abc12345

persona rm <id>

Delete a provider.

persona rm abc12345

persona ping [id]

Test provider API connection.

persona ping abc12345

persona status

Show current active provider and configuration.

persona status

Template & Theme Commands

persona templates

List available provider templates.

persona templates

persona theme

Manage themes.

persona theme              # Show current theme
persona theme list        # List available themes
persona theme <name>      # Switch to a theme

persona sync

Sync templates and themes from GitHub.

persona sync                    # Sync all
persona sync --templates       # Sync only templates
persona sync --themes         # Sync only themes
persona sync --force          # Force overwrite

Config Commands

persona env

Manage environment variable overrides.

persona env              # Show current config
persona env edit        # Edit config

Help

persona help

Show help information.

persona help
persona help use