Skip to content

Interactive init: Add guided wizard mode alongside quick setup #487

@lbedner

Description

@lbedner

Summary

Redesign aegis init interactive mode to offer two paths:

  1. Quick setup ("Ron Swanson mode") - Current direct approach, cleaned up
  2. Guided wizard - Explanatory flow for newcomers

Problem

The current interactive flow jumps straight into asking questions without context. It assumes users already understand:

  • What components vs services are
  • What each option does
  • How things combine together

This works for power users but creates friction for first-timers.

Proposed Solution

Opening Choice

How would you like to set up your project?

  > Quick setup     I know what I want
    Guided tour     Show me the options

Wizard Mode Features

Context panels - Rich terminal UI explaining each choice:

┌─────────────────────────────────────────────────┐
│  DATABASE                                       │
│                                                 │
│  PostgreSQL with SQLModel ORM, migrations via   │
│  Alembic, and connection pooling.               │
│                                                 │
│  Pairs well with: Auth, AI, Scheduler           │
└─────────────────────────────────────────────────┘
         [ Add ]    [ Skip ]    [ Learn more ]

Combination hints - Surface the emergent power:

  • "You picked AI - most users also add Database for conversation history"
  • "Auth + Database enables user-specific data and sessions"

Progressive disclosure - Basics first, details on demand

Quick Setup Mode

  • Clean up current flow
  • Minimal prompts, fast path
  • For repeat users or those who've read docs

Technical Considerations

  • Could use Textual or rich panels for the UI
  • Wizard explanations could pull from component/service metadata
  • Consider showing a "build preview" as selections are made

Value

  • Lower barrier to entry for new users
  • Better showcases what Aegis can do
  • Power users unaffected (quick path remains)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions