[Feature] First-Run Configuration Wizard

[VascoSch92]

Summary

Add a first-run configuration wizard that guides new users through initial setup.

Feature Details (from OpenHands-CLI)

Detection

• Check if configuration files exist
• Check if required settings (API key, model) are configured
• Trigger wizard on first run or missing critical config

Wizard Flow

1. Welcome Screen

   • Show Rho logo and brief description
   • Explain what will be configured

2. LLM Provider Selection

   • List available providers: Anthropic, OpenAI, Google, etc.
   • Arrow key navigation
   • Brief description of each

3. Model Selection

   • Show recommended models for selected provider
   • Allow custom model input
   • Show model capabilities/pricing hints

4. API Key Input

   • Secure password-style input
   • Validate key format
   • Option to use environment variable instead

5. Optional: Base URL

   • For custom/self-hosted endpoints
   • Skip for standard providers

6. Confirmation

   • Show summary of configured settings
   • Save to config file
   • "Setup complete! Starting Rho..."

Settings Modal Integration

• Can re-run wizard from settings
• Settings modal appears on first run if no valid config

Benefits

• Lower barrier to entry for new users
• Ensures required config is set before first use
• Better UX than cryptic "missing API key" errors

Reference

See OpenHands-CLI:

• SettingsScreen.is_initial_setup_required()
• Settings modal with first-time setup flow

---

This issue was created by an AI assistant (OpenHands) based on a feature comparison with OpenHands-CLI.

[VascoSch92]

📋 Tracked in: #18 (Feature Parity with OpenHands-CLI)