code-puppy 0.0.333__py3-none-any.whl → 0.0.334__py3-none-any.whl

code_puppy/cli_runner.py

@@ -364,6 +364,7 @@ async def interactive_mode(message_renderer, initial_command: str = None) -> Non
     emit_system_message(
         "Use /diff to configure diff highlighting colors for file changes."
     )
+    emit_system_message("To re-run the tutorial, use /tutorial.")
     try:
         from code_puppy.command_line.motd import print_motd
 

code_puppy/command_line/config_commands.py

@@ -46,7 +46,7 @@ def handle_show_command(command: str) -> bool:
         get_use_dbos,
         get_yolo_mode,
     )
-    from code_puppy.keymap import get_cancel_agent_key, get_cancel_agent_display_name
+    from code_puppy.keymap import get_cancel_agent_display_name
     from code_puppy.messaging import emit_info
 
     puppy_name = get_puppy_name()

code_puppy/command_line/core_commands.py

@@ -115,6 +115,57 @@ def handle_motd_command(command: str) -> bool:
     return True
 
 
+@register_command(
+    name="tutorial",
+    description="Run the interactive tutorial wizard",
+    usage="/tutorial",
+    category="core",
+)
+def handle_tutorial_command(command: str) -> bool:
+    """Run the interactive tutorial wizard.
+
+    Usage:
+        /tutorial  - Run the tutorial (can be run anytime)
+    """
+    import asyncio
+    import concurrent.futures
+
+    from code_puppy.command_line.onboarding_wizard import (
+        reset_onboarding,
+        run_onboarding_wizard,
+    )
+    from code_puppy.config import set_model_name
+
+    # Always reset so user can re-run the tutorial anytime
+    reset_onboarding()
+
+    # Run the async wizard in a thread pool (same pattern as agent picker)
+    with concurrent.futures.ThreadPoolExecutor() as executor:
+        future = executor.submit(lambda: asyncio.run(run_onboarding_wizard()))
+        result = future.result(timeout=300)  # 5 min timeout
+
+    if result == "chatgpt":
+        emit_info("🔐 Starting ChatGPT OAuth flow...")
+        from code_puppy.plugins.chatgpt_oauth.oauth_flow import run_oauth_flow
+
+        run_oauth_flow()
+        set_model_name("chatgpt-gpt-5.2-codex")
+    elif result == "claude":
+        emit_info("🔐 Starting Claude Code OAuth flow...")
+        from code_puppy.plugins.claude_code_oauth.register_callbacks import (
+            _perform_authentication,
+        )
+
+        _perform_authentication()
+        set_model_name("claude-code-claude-opus-4-5-20251101")
+    elif result == "completed":
+        emit_info("🎉 Tutorial complete! Happy coding!")
+    elif result == "skipped":
+        emit_info("⏭️ Tutorial skipped. Run /tutorial anytime!")
+
+    return True
+
+
 @register_command(
     name="exit",
     description="Exit interactive mode",

code_puppy/command_line/onboarding_slides.py

@@ -0,0 +1,416 @@
+"""Slide content for the onboarding wizard.
+
+🐶 Contains all slide definitions and content generators for the onboarding
+wizard. Separated from the main wizard logic for maintainability.
+"""
+
+from typing import List, Tuple
+
+# ============================================================================
+# Slide Data Constants
+# ============================================================================
+
+# Model subscription options for slide 1
+MODEL_OPTIONS: List[Tuple[str, str, str]] = [
+    ("chatgpt", "ChatGPT Plus (Pro/Max)", "OAuth login with your ChatGPT subscription"),
+    ("claude", "Claude Code Pro/Max", "OAuth login with your Claude subscription"),
+    ("api_keys", "API Keys (OpenAI, Anthropic, etc.)", "Use your own API keys"),
+    ("openrouter", "OpenRouter", "Single API key for multiple providers"),
+    ("free", "Free tiers / Other providers", "Explore free and community models"),
+    ("skip", "Skip this", "Configure later with /set or /add_model"),
+]
+
+# Common API keys users might want to configure
+API_KEYS_INFO: List[Tuple[str, str]] = [
+    ("OPENAI_API_KEY", "OpenAI (GPT-5.2, GPT-5.2-codex)"),
+    ("ANTHROPIC_API_KEY", "Anthropic (Opus/Sonnet/Haiku 4.5)"),
+    ("GOOGLE_API_KEY", "Google (Gemini 3 Pro)"),
+    ("XAI_API_KEY", "xAI (Grok 4)"),
+    ("MINIMAX_API_KEY", "MiniMax (MiniMax M2.1)"),
+    ("OPENROUTER_API_KEY", "OpenRouter (100+ models)"),
+]
+
+# Key agents to highlight
+KEY_AGENTS: List[Tuple[str, str, str]] = [
+    ("planning-agent", "📋 Planning Agent", "Breaks down complex tasks"),
+    ("qa-kitten", "🐱 QA Kitten", "Browser automation with Playwright"),
+    ("security-auditor", "🛡️ Security Auditor", "Risk-based security review"),
+    ("code-reviewer", "🔍 Code Reviewer", "Holistic code review"),
+    ("python-programmer", "🐍 Python Programmer", "Modern Python specialist"),
+]
+
+
+# ============================================================================
+# Gradient Banner Generator
+# ============================================================================
+
+
+def get_gradient_banner() -> str:
+    """Generate the gradient CODE PUPPY banner.
+
+    Returns:
+        Rich markup string with gradient-colored pyfiglet banner.
+    """
+    try:
+        import pyfiglet
+
+        intro_lines = pyfiglet.figlet_format("CODE PUPPY", font="ansi_shadow").split(
+            "\n"
+        )
+
+        # Blue to cyan to green gradient (top to bottom)
+        gradient_colors = ["bright_blue", "bright_cyan", "bright_green"]
+
+        result_lines = []
+        for line_num, line in enumerate(intro_lines):
+            if line.strip():
+                color_idx = min(line_num // 2, len(gradient_colors) - 1)
+                color = gradient_colors[color_idx]
+                result_lines.append(f"[{color}]{line}[/{color}]")
+            else:
+                result_lines.append("")
+
+        return "\n".join(result_lines)
+    except ImportError:
+        # Fallback if pyfiglet not available
+        return (
+            "[bold bright_cyan]╔═══════════════════════════════╗\n"
+            "║        CODE PUPPY 🐶          ║\n"
+            "╚═══════════════════════════════╝[/bold bright_cyan]"
+        )
+
+
+# ============================================================================
+# Slide Content Generators
+# ============================================================================
+
+
+def slide_welcome() -> str:
+    """Slide 0: Welcome with gradient banner.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = get_gradient_banner()
+    content += "\n\n"
+    content += "[bold white]Welcome to Code Puppy! 🐶[/bold white]\n\n"
+    content += "[dim]Let's get you set up for coding success![/dim]\n\n"
+    content += "[cyan]This wizard will help you configure:[/cyan]\n"
+    content += "  • Model subscriptions & API keys\n"
+    content += "  • MCP server integrations\n"
+    content += "  • Appearance customization\n"
+    content += "  • Agent system overview\n\n"
+    content += "[bold yellow]🎯 Navigation:[/bold yellow]\n"
+    content += "[green]→[/green] or [green]l[/green]  Next slide\n"
+    content += "[green]←[/green] or [green]h[/green]  Previous slide\n"
+    content += "[green]↓[/green] or [green]j[/green]  Next option\n"
+    content += "[green]↑[/green] or [green]k[/green]  Previous option\n"
+    content += "[green]Enter[/green]    Select/proceed\n"
+    content += "[green]ESC[/green]      Skip wizard\n\n"
+    content += "[dim]You can always run[/dim]\n"
+    content += "[cyan]/onboarding[/cyan] [dim]later![/dim]"
+
+    return content
+
+
+def slide_model_subscription(
+    selected_option: int, options: List[Tuple[str, str]]
+) -> str:
+    """Slide 1: Model subscription selection.
+
+    Args:
+        selected_option: Index of the currently selected option.
+        options: List of (id, label) tuples for display.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]📦 Model Subscription[/bold cyan]\n\n"
+    content += "[white]Do you have a model subscription?[/white]\n\n"
+
+    for i, (_, label) in enumerate(options):
+        if i == selected_option:
+            content += f"[bold green]▶ {label}[/bold green]\n"
+        else:
+            content += f"[dim]  {label}[/dim]\n"
+
+    content += "\n\n"
+
+    # Dynamic content based on selection
+    selected_opt = options[selected_option][0] if options else None
+    if selected_opt == "chatgpt":
+        content += "[bold yellow]💡 ChatGPT Plus/Pro/Max[/bold yellow]\n\n"
+        content += "[green]OAuth login gives you access to:[/green]\n"
+        content += "  • GPT-5.2\n"
+        content += "  • GPT-5.2-codex\n"
+        content += "  • No API key needed!\n"
+    elif selected_opt == "claude":
+        content += "[bold yellow]💡 Claude Code Pro/Max[/bold yellow]\n\n"
+        content += "[green]OAuth login gives you access to:[/green]\n"
+        content += "  • Claude Opus 4.5\n"
+        content += "  • Claude Sonnet 4.5\n"
+        content += "  • Claude Haiku 4.5\n"
+        content += "  • No API key needed!\n"
+    elif selected_opt == "api_keys":
+        content += "[bold yellow]💡 API Keys[/bold yellow]\n\n"
+        content += "[green]Use your own API keys for:[/green]\n"
+        content += "  • OpenAI (GPT-5.2, GPT-5.2-codex)\n"
+        content += "  • Anthropic (Opus/Sonnet/Haiku 4.5)\n"
+        content += "  • Google (Gemini)\n"
+        content += "  • And many more!\n"
+    elif selected_opt == "openrouter":
+        content += "[bold yellow]💡 OpenRouter[/bold yellow]\n\n"
+        content += "[green]Single API key for 100+ models:[/green]\n"
+        content += "  • All major providers\n"
+        content += "  • Pay-per-use pricing\n"
+        content += "  • Great for exploration!\n"
+    elif selected_opt == "free":
+        content += "[bold yellow]💡 Free Tiers[/bold yellow]\n\n"
+        content += "[green]Explore free options:[/green]\n"
+        content += "  • Google Gemini (free tier)\n"
+        content += "  • Groq (fast inference)\n"
+        content += "  • Local with Ollama\n"
+    else:
+        content += "[dim][Configure later using /set or /add_model][/dim]\n"
+
+    content += "\n\n[dim]Press → to continue[/dim]"
+    return content
+
+
+def slide_api_keys(model_choice: str | None) -> str:
+    """Slide 2: API key setup information.
+
+    Args:
+        model_choice: User's model subscription selection from slide 1.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]🔑 API Key Configuration[/bold cyan]\n\n"
+
+    if model_choice in ("chatgpt", "claude"):
+        content += "[green]✓ You selected OAuth login![/green]\n\n"
+        content += "[dim]After this wizard, we'll guide you\n"
+        content += "through the OAuth authentication flow.[/dim]\n\n"
+        content += "You can also add API keys for\n"
+        content += "additional providers:\n\n"
+    else:
+        content += "[white]Common API keys to configure:[/white]\n\n"
+
+    for key_name, description in API_KEYS_INFO:
+        content += f"[cyan]{key_name}[/cyan]\n"
+        content += f"  [dim]{description}[/dim]\n"
+
+    content += "\n\n"
+    content += "[bold yellow]⚙️ Configuration[/bold yellow]\n\n"
+    content += "[green]Set API keys with:[/green]\n\n"
+    content += "[cyan]/set OPENAI_API_KEY=sk-...[/cyan]\n\n"
+    content += "[dim]Keys are stored securely in[/dim]\n"
+    content += "[dim]~/.config/code_puppy/puppy.cfg[/dim]\n\n"
+    content += "[green]Browse 1500+ models:[/green]\n"
+    content += "[cyan]/add_model[/cyan]\n"
+    content += "[dim]65+ providers available![/dim]"
+
+    return content
+
+
+def slide_mcp_servers() -> str:
+    """Slide 3: MCP server information.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]🔌 MCP Servers[/bold cyan]\n\n"
+    content += "[white]Extend Code Puppy with MCP![/white]\n\n"
+    content += "Model Context Protocol (MCP) lets you\n"
+    content += "add external tools and integrations.\n\n"
+    content += "[green]Commands:[/green]\n"
+    content += "  [cyan]/mcp install[/cyan] - Browse curated catalog\n"
+    content += "  [cyan]/mcp add[/cyan]     - Add custom server\n"
+    content += "  [cyan]/mcp list[/cyan]    - View configured servers\n"
+    content += "  [cyan]/mcp status[/cyan]  - Check server health\n\n"
+    content += "[bold yellow]🌟 Popular MCP Servers[/bold yellow]\n\n"
+    content += "[green]@anthropic/mcp-server-github[/green]\n"
+    content += "  GitHub integration\n\n"
+
+    content += "[green]@anthropic/mcp-server-postgres[/green]\n"
+    content += "  Database access\n\n"
+    content += "[dim]Custom JSON configuration also supported[/dim]"
+
+    return content
+
+
+def slide_appearance() -> str:
+    """Slide 4: Appearance customization.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]🎨 Appearance[/bold cyan]\n\n"
+    content += "[white]Customize your Code Puppy experience![/white]\n\n"
+    content += "[green]Banner Colors:[/green]\n"
+    content += "  [cyan]/colors[/cyan] - Customize tool banners\n"
+    content += "  Change colors for THINKING, SHELL,\n"
+    content += "  READ FILE, EDIT FILE, etc.\n\n"
+    content += "[green]Diff Highlighting:[/green]\n"
+    content += "  [cyan]/diff[/cyan] - Syntax highlighting themes\n"
+    content += "  Configure addition/deletion colors\n"
+    content += "  with live preview!\n\n"
+    content += "[bold yellow]🖼️ Preview[/bold yellow]\n\n"
+    content += "[on blue] THINKING [/on blue] ⚡\n"
+    content += "[on dark_cyan] SHELL COMMAND [/on dark_cyan] 🚀\n"
+    content += "[on green] EDIT FILE [/on green] ✏️\n"
+    content += "[on purple] READ FILE [/on purple] 📂\n"
+    content += "[dim]All colors customizable![/dim]"
+
+    return content
+
+
+def slide_agent_system() -> str:
+    """Slide 5: Agent system overview.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]🤖 Agent System[/bold cyan]\n\n"
+    content += "[white]Code Puppy has specialized sub-agents![/white]\n\n"
+    content += "[green]Switch agents:[/green]\n"
+    content += "  [cyan]/agent[/cyan] or [cyan]/a[/cyan]\n\n"
+    content += "[green]Key Agents:[/green]\n"
+    for _, name, desc in KEY_AGENTS:
+        content += f"  {name}\n"
+        content += f"    [dim]{desc}[/dim]\n"
+    content += "\n\n"
+    content += "[bold yellow]🔧 Agent Tips[/bold yellow]\n\n"
+    content += "[green]Create custom agents:[/green]\n"
+    content += "[cyan]/agent agent-creator[/cyan]\n"
+    content += "[dim]Agents are defined with JSON[/dim]\n"
+    content += "[dim]in ~/.code_puppy/agents/[/dim]\n\n"
+    content += "[green]Each agent has:[/green]\n"
+    content += "  • Custom system prompt\n"
+    content += "  • Selected tools\n"
+    content += "  • Optional pinned model\n"
+
+    return content
+
+
+def slide_model_pinning() -> str:
+    """Slide 6: Model pinning feature.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]📌 Model Pinning[/bold cyan]\n\n"
+    content += "[white]Pin specific models to agents![/white]\n\n"
+    content += "[green]Command:[/green]\n"
+    content += "  [cyan]/pin_model[/cyan]\n\n"
+    content += "[green]Example Multi-LLM Workflow:[/green]\n"
+    content += "  [yellow]Planning:[/yellow]    Kimi k2 (thinking)\n"
+    content += "  [yellow]Implement:[/yellow]  Claude Opus 4\n"
+    content += "  [yellow]Testing:[/yellow]    GLM 4.7\n"
+    content += "  [yellow]Review:[/yellow]     GPT-5.2-codex\n\n"
+    content += "[bold yellow]🎯 Why Pin Models?[/bold yellow]\n\n"
+    content += "Different models excel at\n"
+    content += "different tasks:\n\n"
+    content += "[green]Planning:[/green]\n"
+    content += "  Deep reasoning models\n\n"
+    content += "[green]Coding:[/green]\n"
+    content += "  Code-specialized models\n\n"
+    content += "[green]Review:[/green]\n"
+    content += "  Critical analysis models\n\n"
+    content += "[dim]Mix and match for best results![/dim]"
+
+    return content
+
+
+def slide_planning_agent() -> str:
+    """Slide 7: Planning agent power.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]🚀 The Planning Agent[/bold cyan]\n\n"
+    content += "[bold yellow]Your Secret Weapon![/bold yellow]\n\n"
+    content += "The Planning Agent can:\n\n"
+    content += "  ✓ Break down complex tasks\n"
+    content += "  ✓ Create actionable roadmaps\n"
+    content += "  ✓ Orchestrate sub-agents\n"
+    content += "  ✓ Manage multi-step workflows\n\n"
+    content += "[green]Try it:[/green]\n"
+    content += "  [cyan]/agent planning-agent[/cyan]\n"
+    content += "[dim]Then describe your project![/dim]\n\n"
+    content += "[bold yellow]💡 Example Prompt[/bold yellow]\n\n"
+    content += "[cyan]'Plan a REST API for a\n"
+    content += "todo app with auth,\n"
+    content += "database, and tests'[/cyan]\n\n"
+    content += "The Planning Agent will:\n\n"
+    content += "1. Analyze requirements\n"
+    content += "2. Break into phases\n"
+    content += "3. Create file structure\n"
+    content += "4. Delegate to specialists\n"
+    content += "5. Track progress\n"
+
+    return content
+
+
+def slide_model_settings() -> str:
+    """Slide 8: Model settings.
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold cyan]⚙️ Model Settings[/bold cyan]\n\n"
+    content += "[white]Fine-tune model behavior![/white]\n\n"
+    content += "[green]Command:[/green]\n"
+    content += "  [cyan]/model_settings[/cyan] or [cyan]/ms[/cyan]\n\n"
+    content += "[green]Configurable Parameters:[/green]\n"
+    content += "  [yellow]temperature[/yellow]    - Creativity (0.0-2.0)\n"
+    content += "  [yellow]max_tokens[/yellow]     - Response length\n"
+    content += "  [yellow]top_p[/yellow]          - Nucleus sampling\n"
+    content += "  [yellow]presence_penalty[/yellow] - Topic diversity\n\n"
+    content += "[bold yellow]🎛️ Common Settings[/bold yellow]\n\n"
+    content += "[green]Precise code:[/green]\n"
+    content += "  temperature: 0.0-0.3\n\n"
+    content += "[green]Creative writing:[/green]\n"
+    content += "  temperature: 0.7-1.0\n\n"
+    content += "[green]Long outputs:[/green]\n"
+    content += "  max_tokens: 4096+\n\n"
+    content += "[dim]Settings persist per-session[/dim]"
+
+    return content
+
+
+def slide_complete(trigger_oauth: str | None) -> str:
+    """Slide 9: Completion.
+
+    Args:
+        trigger_oauth: OAuth provider that was selected ("chatgpt"/"claude"/None).
+
+    Returns:
+        Rich markup string for the slide content.
+    """
+    content = "[bold green]🎉 You're All Set![/bold green]\n\n"
+    content += "[white]Code Puppy is ready to help![/white]\n\n"
+    content += "[bold cyan]Quick Reference:[/bold cyan]\n\n"
+    content += "  [cyan]/model[/cyan]     - Switch models\n"
+    content += "  [cyan]/agent[/cyan]     - Switch agents\n"
+    content += "  [cyan]/set[/cyan]       - Configure settings\n"
+    content += "  [cyan]/add_model[/cyan] - Browse 1500+ models\n"
+    content += "  [cyan]/mcp[/cyan]       - MCP server management\n"
+    content += "  [cyan]/help[/cyan]      - Full command list\n\n"
+    content += "[bold yellow]Press Enter to start coding! 🐶[/bold yellow]\n"
+    content += "\n"
+    content += "[bold yellow]🐾 Happy Coding![/bold yellow]\n\n"
+    content += "[dim]Remember:[/dim]\n"
+    content += "• Be specific in prompts\n"
+    content += "• Let agents read files first\n"
+    content += "• Use planning for complex tasks\n"
+    content += "• Check diffs before applying\n\n"
+    content += "[green]Community:[/green]\n"
+    content += "  GitHub: code-puppy\n"
+    content += "  Discord: code-puppy\n"
+
+    if trigger_oauth:
+        content += f"\n[bold cyan]Next: {trigger_oauth.title()} OAuth[/bold cyan]"
+
+    return content

code_puppy/command_line/onboarding_wizard.py

@@ -0,0 +1,426 @@
+"""Interactive TUI onboarding wizard for first-time Code Puppy users.
+
+🐶 Welcome to Code Puppy! This wizard guides new users through initial setup,
+model configuration, and feature discovery. Uses the same TUI patterns as
+colors_menu.py and diff_menu.py for a consistent experience.
+
+Usage:
+    from code_puppy.command_line.onboarding_wizard import (
+        should_show_onboarding,
+        run_onboarding_wizard,
+    )
+
+    if should_show_onboarding():
+        result = await run_onboarding_wizard()
+        # result: "chatgpt", "claude", "completed", "skipped", or None
+"""
+
+import io
+import os
+import sys
+import time
+from typing import List, Optional, Tuple
+
+from prompt_toolkit import Application
+from prompt_toolkit.formatted_text import ANSI, FormattedText
+from prompt_toolkit.key_binding import KeyBindings
+from prompt_toolkit.layout import Layout, Window
+from prompt_toolkit.layout.controls import FormattedTextControl
+from prompt_toolkit.widgets import Frame
+from rich.console import Console
+
+from code_puppy.config import CONFIG_DIR
+
+from .onboarding_slides import (
+    MODEL_OPTIONS,
+    slide_agent_system,
+    slide_api_keys,
+    slide_appearance,
+    slide_complete,
+    slide_mcp_servers,
+    slide_model_pinning,
+    slide_model_settings,
+    slide_model_subscription,
+    slide_planning_agent,
+    slide_welcome,
+)
+
+# ============================================================================
+# State Tracking (like motd.py pattern)
+# ============================================================================
+
+ONBOARDING_COMPLETE_FILE = os.path.join(CONFIG_DIR, "onboarding_complete")
+
+
+def has_completed_onboarding() -> bool:
+    """Check if the user has already completed onboarding.
+
+    Returns:
+        True if onboarding has been completed, False otherwise.
+    """
+    return os.path.exists(ONBOARDING_COMPLETE_FILE)
+
+
+def mark_onboarding_complete() -> None:
+    """Mark onboarding as complete by creating the tracking file."""
+    os.makedirs(os.path.dirname(ONBOARDING_COMPLETE_FILE), exist_ok=True)
+    with open(ONBOARDING_COMPLETE_FILE, "w") as f:
+        f.write("completed\n")
+
+
+def should_show_onboarding() -> bool:
+    """Determine if the onboarding wizard should be shown.
+
+    Returns:
+        True if onboarding should be shown, False otherwise.
+    """
+    return not has_completed_onboarding()
+
+
+def reset_onboarding() -> None:
+    """Reset onboarding state (useful for testing or re-running wizard)."""
+    if os.path.exists(ONBOARDING_COMPLETE_FILE):
+        os.remove(ONBOARDING_COMPLETE_FILE)
+
+
+# ============================================================================
+# Onboarding Wizard Class
+# ============================================================================
+
+
+class OnboardingWizard:
+    """Interactive onboarding wizard with slide-based navigation.
+
+    Attributes:
+        current_slide: Index of the currently displayed slide (0-9)
+        selected_option: Index of selected option within current slide
+        trigger_oauth: OAuth provider to trigger after wizard ("chatgpt"/"claude")
+        model_choice: User's model subscription selection
+    """
+
+    TOTAL_SLIDES = 10
+
+    def __init__(self):
+        """Initialize the onboarding wizard state."""
+        self.current_slide = 0
+        self.selected_option = 0
+        self.trigger_oauth: Optional[str] = None
+        self.model_choice: Optional[str] = None
+        self.result: Optional[str] = None
+        self._should_exit = False
+
+    def get_progress_indicator(self) -> str:
+        """Generate progress dots showing current slide position.
+
+        Returns:
+            String like "● ○ ○ ○ ○ ○ ○ ○ ○ ○" for slide 0.
+        """
+        dots = []
+        for i in range(self.TOTAL_SLIDES):
+            if i == self.current_slide:
+                dots.append("●")
+            else:
+                dots.append("○")
+        return " ".join(dots)
+
+    def get_slide_content(self) -> str:
+        """Get combined content for the current slide.
+
+        Returns:
+            Rich markup string for the slide content.
+        """
+        if self.current_slide == 0:
+            return slide_welcome()
+        elif self.current_slide == 1:
+            options = self.get_options_for_slide()
+            return slide_model_subscription(self.selected_option, options)
+        elif self.current_slide == 2:
+            return slide_api_keys(self.model_choice)
+        elif self.current_slide == 3:
+            return slide_mcp_servers()
+        elif self.current_slide == 4:
+            return slide_appearance()
+        elif self.current_slide == 5:
+            return slide_agent_system()
+        elif self.current_slide == 6:
+            return slide_model_pinning()
+        elif self.current_slide == 7:
+            return slide_planning_agent()
+        elif self.current_slide == 8:
+            return slide_model_settings()
+        else:  # slide 9
+            return slide_complete(self.trigger_oauth)
+
+    def get_options_for_slide(self) -> List[Tuple[str, str]]:
+        """Get selectable options for the current slide.
+
+        Returns:
+            List of (id, label) tuples for options, or empty list if no options.
+        """
+        if self.current_slide == 1:  # Model subscription slide
+            return [(opt[0], opt[1]) for opt in MODEL_OPTIONS]
+        return []
+
+    def handle_option_select(self) -> None:
+        """Handle selection of the current option."""
+        if self.current_slide == 1:  # Model subscription
+            options = self.get_options_for_slide()
+            if 0 <= self.selected_option < len(options):
+                choice_id = options[self.selected_option][0]
+                self.model_choice = choice_id
+
+                # Set OAuth trigger for ChatGPT/Claude
+                if choice_id == "chatgpt":
+                    self.trigger_oauth = "chatgpt"
+                elif choice_id == "claude":
+                    self.trigger_oauth = "claude"
+
+    def next_slide(self) -> bool:
+        """Move to the next slide.
+
+        Returns:
+            True if moved to next slide, False if at last slide.
+        """
+        if self.current_slide < self.TOTAL_SLIDES - 1:
+            self.current_slide += 1
+            self.selected_option = 0
+            return True
+        return False
+
+    def prev_slide(self) -> bool:
+        """Move to the previous slide.
+
+        Returns:
+            True if moved to previous slide, False if at first slide.
+        """
+        if self.current_slide > 0:
+            self.current_slide -= 1
+            self.selected_option = 0
+            return True
+        return False
+
+    def next_option(self) -> None:
+        """Move to the next option within the current slide."""
+        options = self.get_options_for_slide()
+        if options:
+            self.selected_option = (self.selected_option + 1) % len(options)
+
+    def prev_option(self) -> None:
+        """Move to the previous option within the current slide."""
+        options = self.get_options_for_slide()
+        if options:
+            self.selected_option = (self.selected_option - 1) % len(options)
+
+
+# ============================================================================
+# TUI Rendering Functions
+# ============================================================================
+
+
+def _get_slide_panel_content(wizard: OnboardingWizard) -> ANSI:
+    """Generate the centered slide content.
+
+    Args:
+        wizard: The OnboardingWizard instance.
+
+    Returns:
+        ANSI object with formatted slide content.
+    """
+    buffer = io.StringIO()
+    console = Console(
+        file=buffer,
+        force_terminal=True,
+        width=80,
+        legacy_windows=False,
+        color_system="truecolor",
+        no_color=False,
+        force_interactive=True,
+    )
+
+    # Progress indicator
+    progress = wizard.get_progress_indicator()
+    console.print(f"[dim]{progress}[/dim]\n")
+
+    # Slide number
+    console.print(
+        f"[dim]Slide {wizard.current_slide + 1} of {wizard.TOTAL_SLIDES}[/dim]\n\n"
+    )
+
+    # Combined slide content
+    slide_content = wizard.get_slide_content()
+    console.print(slide_content)
+
+    return ANSI(buffer.getvalue())
+
+
+def _get_navigation_hints(wizard: OnboardingWizard) -> FormattedText:
+    """Generate navigation hints for the bottom of the screen.
+
+    Args:
+        wizard: The OnboardingWizard instance.
+
+    Returns:
+        FormattedText with navigation hints.
+    """
+    hints = []
+
+    if wizard.current_slide > 0:
+        hints.append(("fg:ansicyan", "← Back  "))
+
+    if wizard.current_slide < wizard.TOTAL_SLIDES - 1:
+        hints.append(("fg:ansicyan", "→ Next  "))
+    else:
+        hints.append(("fg:ansigreen bold", "Enter: Finish  "))
+
+    options = wizard.get_options_for_slide()
+    if options:
+        hints.append(("fg:ansicyan", "↑↓ Options  "))
+
+    hints.append(("fg:ansiyellow", "ESC: Skip"))
+
+    return FormattedText(hints)
+
+
+# ============================================================================
+# Main Entry Point
+# ============================================================================
+
+
+async def run_onboarding_wizard() -> Optional[str]:
+    """Run the interactive onboarding wizard.
+
+    Returns:
+        - "chatgpt" if user wants ChatGPT OAuth
+        - "claude" if user wants Claude OAuth
+        - "completed" if finished normally
+        - "skipped" if user pressed ESC
+        - None on error
+    """
+    from code_puppy.tools.command_runner import set_awaiting_user_input
+
+    wizard = OnboardingWizard()
+
+    set_awaiting_user_input(True)
+
+    # Enter alternate screen buffer
+    sys.stdout.write("\033[?1049h")  # Enter alternate buffer
+    sys.stdout.write("\033[2J\033[H")  # Clear and home
+    sys.stdout.flush()
+    time.sleep(0.1)  # Minimal delay for state sync
+
+    try:
+        # Set up key bindings
+        kb = KeyBindings()
+
+        @kb.add("right")
+        @kb.add("l")
+        def next_slide(event):
+            if wizard.current_slide == wizard.TOTAL_SLIDES - 1:
+                # On last slide, right arrow finishes
+                wizard.result = "completed"
+                wizard._should_exit = True
+                event.app.exit()
+            else:
+                wizard.next_slide()
+            event.app.invalidate()
+
+        @kb.add("left")
+        @kb.add("h")
+        def prev_slide(event):
+            wizard.prev_slide()
+            event.app.invalidate()
+
+        @kb.add("down")
+        @kb.add("j")
+        def next_option(event):
+            wizard.next_option()
+            event.app.invalidate()
+
+        @kb.add("up")
+        @kb.add("k")
+        def prev_option(event):
+            wizard.prev_option()
+            event.app.invalidate()
+
+        @kb.add("enter")
+        def select_or_next(event):
+            # Handle option selection on slides with options
+            options = wizard.get_options_for_slide()
+            if options:
+                wizard.handle_option_select()
+
+            # Move to next slide or finish
+            if wizard.current_slide == wizard.TOTAL_SLIDES - 1:
+                wizard.result = "completed"
+                wizard._should_exit = True
+                event.app.exit()
+            else:
+                wizard.next_slide()
+            event.app.invalidate()
+
+        @kb.add("escape")
+        def skip_wizard(event):
+            wizard.result = "skipped"
+            wizard._should_exit = True
+            event.app.exit()
+
+        @kb.add("c-c")
+        def cancel_wizard(event):
+            wizard.result = "skipped"
+            wizard._should_exit = True
+            event.app.exit()
+
+        # Create layout with single centered panel
+        slide_panel = Window(
+            content=FormattedTextControl(lambda: _get_slide_panel_content(wizard))
+        )
+
+        root_container = Frame(slide_panel, title="🐶 Welcome to Code Puppy!")
+
+        layout = Layout(root_container)
+
+        app = Application(
+            layout=layout,
+            key_bindings=kb,
+            full_screen=False,
+            mouse_support=False,
+            color_depth="DEPTH_24_BIT",
+        )
+
+        # Clear screen before running
+        sys.stdout.write("\033[2J\033[H")
+        sys.stdout.flush()
+
+        # Run the application
+        await app.run_async()
+
+    except KeyboardInterrupt:
+        wizard.result = "skipped"
+    except Exception:
+        wizard.result = None
+    finally:
+        set_awaiting_user_input(False)
+        # Exit alternate screen buffer
+        sys.stdout.write("\033[?1049l")
+        sys.stdout.flush()
+
+    # Mark onboarding as complete (even if skipped - they saw it)
+    if wizard.result in ("completed", "skipped"):
+        mark_onboarding_complete()
+
+    # Return OAuth trigger if selected, otherwise the result
+    if wizard.trigger_oauth:
+        return wizard.trigger_oauth
+
+    return wizard.result
+
+
+async def run_onboarding_if_needed() -> Optional[str]:
+    """Run onboarding wizard if user hasn't completed it yet.
+
+    Returns:
+        Result from run_onboarding_wizard() or None if not needed.
+    """
+    if should_show_onboarding():
+        return await run_onboarding_wizard()
+    return None

code_puppy/config.py

@@ -1051,11 +1051,11 @@ def set_enable_dbos(enabled: bool) -> None:
     set_config_value("enable_dbos", "true" if enabled else "false")
 
 
-def get_message_limit(default: int = 100) -> int:
+def get_message_limit(default: int = 1000) -> int:
     """
     Returns the user-configured message/request limit for the agent.
     This controls how many steps/requests the agent can take.
-    Defaults to 100 if unset or misconfigured.
+    Defaults to 1000 if unset or misconfigured.
     Configurable by 'message_limit' key.
     """
     val = get_value("message_limit")

code_puppy/plugins/chatgpt_oauth/register_callbacks.py

@@ -6,6 +6,7 @@ import os
 from typing import List, Optional, Tuple
 
 from code_puppy.callbacks import register_callback
+from code_puppy.config import set_model_name
 from code_puppy.messaging import emit_info, emit_success, emit_warning
 
 from .config import CHATGPT_OAUTH_CONFIG, get_token_storage_path
@@ -75,6 +76,7 @@ def _handle_custom_command(command: str, name: str) -> Optional[bool]:
 
     if name == "chatgpt-auth":
         run_oauth_flow()
+        set_model_name("chatgpt-gpt-5.2-codex")
         return True
 
     if name == "chatgpt-status":

code_puppy/plugins/claude_code_oauth/register_callbacks.py

@@ -12,6 +12,7 @@ from typing import Any, Dict, List, Optional, Tuple
 from urllib.parse import parse_qs, urlparse
 
 from code_puppy.callbacks import register_callback
+from code_puppy.config import set_model_name
 from code_puppy.messaging import emit_error, emit_info, emit_success, emit_warning
 
 from ..oauth_puppy_html import oauth_failure_html, oauth_success_html
@@ -260,6 +261,7 @@ def _handle_custom_command(command: str, name: str) -> Optional[bool]:
                 "Existing Claude Code tokens found. Continuing will overwrite them."
             )
         _perform_authentication()
+        set_model_name("claude-code-claude-opus-4-5-20251101")
         return True
 
     if name == "claude-code-status":

{code_puppy-0.0.333.dist-info → code_puppy-0.0.334.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.333
+Version: 0.0.334
 Summary: Code generation agent
 Project-URL: repository, https://github.com/mpfaffenberger/code_puppy
 Project-URL: HomePage, https://github.com/mpfaffenberger/code_puppy

{code_puppy-0.0.333.dist-info → code_puppy-0.0.334.dist-info}/RECORD

@@ -3,8 +3,8 @@ code_puppy/__main__.py,sha256=pDVssJOWP8A83iFkxMLY9YteHYat0EyWDQqMkKHpWp4,203
 code_puppy/callbacks.py,sha256=hqTV--dNxG5vwWWm3MrEjmb8MZuHFFdmHePl23NXPHk,8621
 code_puppy/chatgpt_codex_client.py,sha256=Om0ANB_kpHubhCwNzF9ENf8RvKBqs0IYzBLl_SNw0Vk,9833
 code_puppy/claude_cache_client.py,sha256=hZr_YtXZSQvBoJFtRbbecKucYqJgoMopqUmm0IxFYGY,6071
-code_puppy/cli_runner.py,sha256=VkDaANmywBNoj6wCzaLlI1Z2yFC98U4BqHmSIcV4HCw,32150
-code_puppy/config.py,sha256=qqeJrQP7gqADqeYqVzfksP7NYGROLrBQCuYic5PuQfY,52295
+code_puppy/cli_runner.py,sha256=_nbaVSsX5FfXEf0jSiVQ7cPUZ96JUFYV71bD668YfR4,32216
+code_puppy/config.py,sha256=25HJ6ppNIPUWg5uHMIBrF2wY-lyqqaDVSpBfghFik3g,52297
 code_puppy/error_logging.py,sha256=a80OILCUtJhexI6a9GM-r5LqIdjvSRzggfgPp2jv1X0,3297
 code_puppy/gemini_code_assist.py,sha256=KGS7sO5OLc83nDF3xxS-QiU6vxW9vcm6hmzilu79Ef8,13867
 code_puppy/http_utils.py,sha256=w5mWYIGIWJZJvgvMahXs9BmdidoJvGn4CASDRY88a8o,13414
@@ -50,8 +50,8 @@ code_puppy/command_line/autosave_menu.py,sha256=7w2SXfEfR-SGFZcHxM-QZfT0p42KxJjX
 code_puppy/command_line/colors_menu.py,sha256=F_OYuApwXWGP2w9o0CMEbIHtqwdKUh5eDhi7qtDP9h0,17144
 code_puppy/command_line/command_handler.py,sha256=CY9F27eovZJK_kpU1YmbroYLWGTCuouCOQ-TXfDp-nw,10916
 code_puppy/command_line/command_registry.py,sha256=qFySsw1g8dol3kgi0p6cXrIDlP11_OhOoaQ5nAadWXg,4416
-code_puppy/command_line/config_commands.py,sha256=5RG8oBaG52vBbZ2Nd5BnHszh_uwPit23AYmEckJRyTc,25764
-code_puppy/command_line/core_commands.py,sha256=qxIZ5tCAPkNDfDYjcG86h0tsi7RUQ4ueQ5C2BZ2H214,24809
+code_puppy/command_line/config_commands.py,sha256=qS9Cm758DPz2QGvHLhAV4Tp_Xfgo3PyoCoLDusbnmCw,25742
+code_puppy/command_line/core_commands.py,sha256=MhnyqcTIMheT8W1cqmfZTGLWo8iGM-fAAo8E3dNORro,26468
 code_puppy/command_line/diff_menu.py,sha256=6qolM8ECpXTAo2q0Yvqw8Oohsj3MLPxQI8PJvYuKGS4,24014
 code_puppy/command_line/file_path_completion.py,sha256=gw8NpIxa6GOpczUJRyh7VNZwoXKKn-yvCqit7h2y6Gg,2931
 code_puppy/command_line/load_context_completion.py,sha256=a3JvLDeLLSYxVgTjAdqWzS4spjv6ccCrK2LKZgVJ1IM,2202
@@ -59,6 +59,8 @@ code_puppy/command_line/mcp_completion.py,sha256=eKzW2O7gun7HoHekOW0XVXhNS5J2xCt
 code_puppy/command_line/model_picker_completion.py,sha256=nDnlf0qFCG2zAm_mWW2eMYwVC7eROVQrFe92hZqOKa8,6810
 code_puppy/command_line/model_settings_menu.py,sha256=O5nPp_OyShFcXzpSmsCeYsnnVNrSwcTBFY9bzcayvj0,32263
 code_puppy/command_line/motd.py,sha256=OoNxwewsckexSgJ5H5y40IawP-TzqlqY-rqFUdRbIhs,2186
+code_puppy/command_line/onboarding_slides.py,sha256=EdssKWx_hT3mneeMEL4QXTLiUxdm-ZXfb6QJOSFtBbE,17066
+code_puppy/command_line/onboarding_wizard.py,sha256=hoMvSb3zvHGSScaCqPMaXSjSAvfX_OMUz7Hu68wP2qE,13134
 code_puppy/command_line/pin_command_completion.py,sha256=juSvdqRpk7AdfkPy1DJx5NzfEUU5KYGlChvP0hisM18,11667
 code_puppy/command_line/prompt_toolkit_completion.py,sha256=x4Of32g8oH9ckhx-P6BigV7HUUhhjL8xkvK03uq9HRw,27308
 code_puppy/command_line/session_commands.py,sha256=Jh8GGfhlfBAEVfucKLbcZjNaXYd0twImiOwq2ZnGdQQ,9902
@@ -122,14 +124,14 @@ code_puppy/plugins/oauth_puppy_html.py,sha256=Wpa-V_NlRiBAvo_OXHuR7wvOH_jSt8L9HS
 code_puppy/plugins/chatgpt_oauth/__init__.py,sha256=Kjc6Hsz1sWvMD2OdAlWZvJRiKJSj4fx22boa-aVFKjA,189
 code_puppy/plugins/chatgpt_oauth/config.py,sha256=H_wAH9Duyn8WH2Kq8oe72uda-_4qu1uXLPun_SDdtsk,2023
 code_puppy/plugins/chatgpt_oauth/oauth_flow.py,sha256=i-CP2gpzEBT3ogUt-oTMexiP2on41N6PbRGIy2lZF30,11028
-code_puppy/plugins/chatgpt_oauth/register_callbacks.py,sha256=-JB1isODQ7v2Kn2alnSIg3mPjqnC-wTfsMO_G12V7iU,2872
+code_puppy/plugins/chatgpt_oauth/register_callbacks.py,sha256=oPfAOdh5hp3Jg3tK5ylk1sy0ydxBebK9a9w1EL1dw9I,2965
 code_puppy/plugins/chatgpt_oauth/test_plugin.py,sha256=oHX7Eb_Hb4rgRpOWdhtFp8Jj6_FDuvXQITRPiNy4tRo,9622
 code_puppy/plugins/chatgpt_oauth/utils.py,sha256=fzpsCQOv0kqPWmG5vNEV_GLSUrMQh8cF7tdIjSOt1Dc,16504
 code_puppy/plugins/claude_code_oauth/README.md,sha256=76nHhMlhk61DZa5g0Q2fc0AtpplLmpbwuWFZt7PHH5g,5458
 code_puppy/plugins/claude_code_oauth/SETUP.md,sha256=lnGzofPLogBy3oPPFLv5_cZ7vjg_GYrIyYnF-EoTJKg,3278
 code_puppy/plugins/claude_code_oauth/__init__.py,sha256=mCcOU-wM7LNCDjr-w-WLPzom8nTF1UNt4nqxGE6Rt0k,187
 code_puppy/plugins/claude_code_oauth/config.py,sha256=DjGySCkvjSGZds6DYErLMAi3TItt8iSLGvyJN98nSEM,2013
-code_puppy/plugins/claude_code_oauth/register_callbacks.py,sha256=0NeX1hhkYIlVfPmjZ1xmcf1yueDAJh_FMUmvJlxSO-E,10057
+code_puppy/plugins/claude_code_oauth/register_callbacks.py,sha256=g8sl-i7jIOF6OFALeaLqTF3mS4tD8GR_FCzvPjVw2js,10165
 code_puppy/plugins/claude_code_oauth/test_plugin.py,sha256=yQy4EeZl4bjrcog1d8BjknoDTRK75mRXXvkSQJYSSEM,9286
 code_puppy/plugins/claude_code_oauth/utils.py,sha256=wDaOU21zB3y6PWkuMXwE4mFjQuffyDae-vXysPTS-w8,13438
 code_puppy/plugins/customizable_commands/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
@@ -160,10 +162,10 @@ code_puppy/tools/browser/browser_scripts.py,sha256=sNb8eLEyzhasy5hV4B9OjM8yIVMLV
 code_puppy/tools/browser/browser_workflows.py,sha256=nitW42vCf0ieTX1gLabozTugNQ8phtoFzZbiAhw1V90,6491
 code_puppy/tools/browser/camoufox_manager.py,sha256=RZjGOEftE5sI_tsercUyXFSZI2wpStXf-q0PdYh2G3I,8680
 code_puppy/tools/browser/vqa_agent.py,sha256=DBn9HKloILqJSTSdNZzH_PYWT0B2h9VwmY6akFQI_uU,2913
-code_puppy-0.0.333.data/data/code_puppy/models.json,sha256=IPABdOrDw2OZJxa0XGBWSWmBRerV6_pIEmKVLRtUbAk,3105
-code_puppy-0.0.333.data/data/code_puppy/models_dev_api.json,sha256=wHjkj-IM_fx1oHki6-GqtOoCrRMR0ScK0f-Iz0UEcy8,548187
-code_puppy-0.0.333.dist-info/METADATA,sha256=VP7p42x7DQGz8JDM0nIF7MXuY41YkD0wIxBINx4334w,28854
-code_puppy-0.0.333.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
-code_puppy-0.0.333.dist-info/entry_points.txt,sha256=Tp4eQC99WY3HOKd3sdvb22vZODRq0XkZVNpXOag_KdI,91
-code_puppy-0.0.333.dist-info/licenses/LICENSE,sha256=31u8x0SPgdOq3izJX41kgFazWsM43zPEF9eskzqbJMY,1075
-code_puppy-0.0.333.dist-info/RECORD,,
+code_puppy-0.0.334.data/data/code_puppy/models.json,sha256=IPABdOrDw2OZJxa0XGBWSWmBRerV6_pIEmKVLRtUbAk,3105
+code_puppy-0.0.334.data/data/code_puppy/models_dev_api.json,sha256=wHjkj-IM_fx1oHki6-GqtOoCrRMR0ScK0f-Iz0UEcy8,548187
+code_puppy-0.0.334.dist-info/METADATA,sha256=DhyliNW_DINXn1BNLHXz80YoI7JrvOltgzhFP4LA77I,28854
+code_puppy-0.0.334.dist-info/WHEEL,sha256=WLgqFyCfm_KASv4WHyYy0P3pM_m7J5L9k2skdKLirC8,87
+code_puppy-0.0.334.dist-info/entry_points.txt,sha256=Tp4eQC99WY3HOKd3sdvb22vZODRq0XkZVNpXOag_KdI,91
+code_puppy-0.0.334.dist-info/licenses/LICENSE,sha256=31u8x0SPgdOq3izJX41kgFazWsM43zPEF9eskzqbJMY,1075
+code_puppy-0.0.334.dist-info/RECORD,,