code-puppy 0.0.333__tar.gz → 0.0.335__tar.gz

{code_puppy-0.0.333 → code_puppy-0.0.335}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: code-puppy
-Version: 0.0.333
+Version: 0.0.335
 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 → code_puppy-0.0.335}/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
 
@@ -456,6 +457,45 @@ async def interactive_mode(message_renderer, initial_command: str = None) -> Non
 
     # Autosave loading is now manual - use /autosave_load command
 
+    # Auto-run tutorial on first startup
+    try:
+        from code_puppy.command_line.onboarding_wizard import should_show_onboarding
+
+        if should_show_onboarding():
+            import asyncio
+            import concurrent.futures
+
+            from code_puppy.command_line.onboarding_wizard import run_onboarding_wizard
+            from code_puppy.config import set_model_name
+            from code_puppy.messaging import emit_info
+
+            with concurrent.futures.ThreadPoolExecutor() as executor:
+                future = executor.submit(lambda: asyncio.run(run_onboarding_wizard()))
+                result = future.result(timeout=300)
+
+            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!")
+    except Exception as e:
+        from code_puppy.messaging import emit_warning
+
+        emit_warning(f"Tutorial auto-start failed: {e}")
+
     # Track the current agent task for cancellation on quit
     current_agent_task = None
 

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/add_model_menu.py

@@ -995,6 +995,10 @@ class AddModelMenu:
             # Reset awaiting input flag
             set_awaiting_user_input(False)
 
+        # Clear exit message (unless we're about to prompt for more input)
+        if self.result not in ("pending_credentials", "pending_custom_model"):
+            emit_info("✓ Exited model browser")
+
         # Handle unsupported provider
         if self.result == "unsupported" and self.current_provider:
             reason = UNSUPPORTED_PROVIDERS.get(

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/autosave_menu.py

@@ -603,4 +603,9 @@ async def interactive_autosave_picker() -> Optional[str]:
         # Reset awaiting input flag
         set_awaiting_user_input(False)
 
+    # Clear exit message
+    from code_puppy.messaging import emit_info
+
+    emit_info("✓ Exited session browser")
+
     return result[0]

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/colors_menu.py

@@ -230,6 +230,11 @@ async def interactive_colors_picker() -> Optional[dict]:
         sys.stdout.write("\033[?1049l")  # Exit alternate buffer
         sys.stdout.flush()
 
+    # Clear exit message
+    from code_puppy.messaging import emit_info
+
+    emit_info("✓ Exited banner color configuration")
+
     # Return changes if any
     if config.has_changes():
         return config.current_colors

{code_puppy-0.0.333 → code_puppy-0.0.335}/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-0.0.333 → code_puppy-0.0.335}/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-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/diff_menu.py

@@ -456,6 +456,11 @@ async def interactive_diff_picker() -> Optional[dict]:
         sys.stdout.write("\033[?1049l")  # Exit alternate buffer
         sys.stdout.flush()
 
+    # Clear exit message
+    from code_puppy.messaging import emit_info
+
+    emit_info("✓ Exited diff color configuration")
+
     # Return changes if any
     if config.has_changes():
         return {

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/mcp/custom_server_form.py

@@ -604,6 +604,10 @@ class CustomServerForm:
             sys.stdout.flush()
             set_awaiting_user_input(False)
 
+        # Clear exit message if not installing
+        if self.result != "installed":
+            emit_info("✓ Exited custom server form")
+
         # Handle result
         if self.result == "installed":
             if self.edit_mode:

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/mcp/install_menu.py

@@ -16,7 +16,7 @@ from prompt_toolkit.layout import Dimension, Layout, VSplit, Window
 from prompt_toolkit.layout.controls import FormattedTextControl
 from prompt_toolkit.widgets import Frame
 
-from code_puppy.messaging import emit_error, emit_warning
+from code_puppy.messaging import emit_error, emit_info, emit_warning
 from code_puppy.tools.command_runner import set_awaiting_user_input
 
 from .catalog_server_installer import (
@@ -635,6 +635,10 @@ class MCPInstallMenu:
             sys.stdout.flush()
             set_awaiting_user_input(False)
 
+        # Clear exit message (unless we're about to prompt for more input)
+        if self.result not in ("pending_custom", "pending_install"):
+            emit_info("✓ Exited MCP server browser")
+
         # Handle custom server after TUI exits
         if self.result == "pending_custom":
             success = run_custom_server_form(self.manager)

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/model_settings_menu.py

@@ -835,6 +835,11 @@ class ModelSettingsMenu:
             sys.stdout.flush()
             set_awaiting_user_input(False)
 
+        # Clear exit message
+        from code_puppy.messaging import emit_info
+
+        emit_info("✓ Exited model settings")
+
         return self.result_changed
 
 

{code_puppy-0.0.333 → code_puppy-0.0.335}/code_puppy/command_line/motd.py

@@ -8,13 +8,19 @@ import os
 from code_puppy.config import CONFIG_DIR
 from code_puppy.messaging import emit_info
 
-MOTD_VERSION = "2025-11-27"
-MOTD_MESSAGE = """🐕‍🦺
-🐾```
-# 🐶🦃🐕 November 27th, 2025 - Happy Thanksgiving! 🦃🐶
-122k Downloads! 🎉
-Thank you for all the support!
--Mike
+MOTD_VERSION = "2026-01-01"
+MOTD_MESSAGE = """
+# 🐶 Happy New Year! January 1st, 2026 🎉
+Reminder that Code Puppy supports three different OAuth subscriptions:
+
+### Claude Code - `/claude-code-auth`
+- Opus / Haiku / Sonnet
+
+### ChatGPT Pro/Plus - `/chatgpt-auth`
+- gpt-5.2 and gpt-5.2 codex
+
+### Google Antigravity - `/antigravity-auth`
+- Gemini 3 Pro, Flash, and Anthropic models including Opus and Sonnet.
 """
 MOTD_TRACK_FILE = os.path.join(CONFIG_DIR, "motd.txt")
 

code_puppy-0.0.335/code_puppy/command_line/onboarding_slides.py

@@ -0,0 +1,180 @@
+"""Slide content for the onboarding wizard.
+
+🐶 Lean, mean, ADHD-friendly slides. 5 slides max!
+"""
+
+from typing import List, Tuple
+
+# ============================================================================
+# Slide Data Constants
+# ============================================================================
+
+# Model subscription options
+MODEL_OPTIONS: List[Tuple[str, str, str]] = [
+    ("chatgpt", "ChatGPT Plus/Pro/Max", "OAuth login - no API key needed"),
+    ("claude", "Claude Code Pro/Max", "OAuth login - no API key needed"),
+    ("api_keys", "API Keys", "OpenAI, Anthropic, Google, etc."),
+    ("openrouter", "OpenRouter", "Single key for 100+ models"),
+    ("skip", "Skip for now", "Configure later with /set or /add_model"),
+]
+
+
+# ============================================================================
+# Navigation Footer (shown on ALL slides)
+# ============================================================================
+
+
+def get_nav_footer() -> str:
+    """Navigation hints shown at bottom of every slide."""
+    return (
+        "\n[dim]─────────────────────────────────────[/dim]\n"
+        "[green]→/l[/green] Next  "
+        "[green]←/h[/green] Back  "
+        "[green]↑↓/jk[/green] Options  "
+        "[green]Enter[/green] Select  "
+        "[yellow]ESC[/yellow] Skip"
+    )
+
+
+# ============================================================================
+# Gradient Banner
+# ============================================================================
+
+
+def get_gradient_banner() -> str:
+    """Generate the gradient CODE PUPPY banner."""
+    try:
+        import pyfiglet
+
+        lines = pyfiglet.figlet_format("CODE PUPPY", font="ansi_shadow").split("\n")
+        colors = ["bright_blue", "bright_cyan", "bright_green"]
+        result = []
+        for i, line in enumerate(lines):
+            if line.strip():
+                color = colors[min(i // 2, len(colors) - 1)]
+                result.append(f"[{color}]{line}[/{color}]")
+        return "\n".join(result)
+    except ImportError:
+        return "[bold bright_cyan]═══ CODE PUPPY 🐶 ═══[/bold bright_cyan]"
+
+
+# ============================================================================
+# Slide Content (5 slides total)
+# ============================================================================
+
+
+def slide_welcome() -> str:
+    """Slide 1: Welcome - quick intro."""
+    content = get_gradient_banner()
+    content += "\n\n"
+    content += "[bold white]Welcome! 🐶[/bold white]\n\n"
+    content += "[cyan]Quick setup:[/cyan]\n"
+    content += "  1. Pick your model provider\n"
+    content += "  2. Optional: MCP servers\n"
+    content += "  3. Learn when to use which agent\n"
+    content += "  4. Start coding!\n\n"
+    content += "[dim]Takes ~1 minute. Let's go![/dim]"
+    content += get_nav_footer()
+    return content
+
+
+def slide_models(selected_option: int, options: List[Tuple[str, str]]) -> str:
+    """Slide 2: Model selection."""
+    content = "[bold cyan]📦 Pick Your Models[/bold cyan]\n\n"
+    content += "[white]How do you want to access LLMs?[/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"
+
+    # Context based on selection
+    opt = options[selected_option][0] if options else None
+    if opt == "chatgpt":
+        content += "[yellow]💡 ChatGPT OAuth[/yellow]\n"
+        content += "  Uses your existing subscription\n"
+        content += "  GPT-5.2, GPT-5.2-codex\n"
+    elif opt == "claude":
+        content += "[yellow]💡 Claude OAuth[/yellow]\n"
+        content += "  Uses your existing subscription\n"
+        content += "  Opus/Sonnet/Haiku 4.5\n"
+    elif opt == "api_keys":
+        content += "[yellow]💡 API Keys[/yellow]\n"
+        content += "  [cyan]/set OPENAI_API_KEY=sk-...[/cyan]\n"
+        content += "  [cyan]/add_model[/cyan] to browse 1500+ models\n"
+    elif opt == "openrouter":
+        content += "[yellow]💡 OpenRouter[/yellow]\n"
+        content += "  One API key, all providers\n"
+        content += "  [cyan]/set OPENROUTER_API_KEY=...[/cyan]\n"
+    else:
+        content += "[dim]No worries! Use /set or /add_model later[/dim]\n"
+
+    content += get_nav_footer()
+    return content
+
+
+def slide_mcp() -> str:
+    """Slide 3: MCP servers (optional power-ups)."""
+    content = "[bold cyan]🔌 MCP Servers (Optional)[/bold cyan]\n\n"
+    content += "[white]Supercharge with external tools![/white]\n\n"
+    content += "[green]Commands:[/green]\n"
+    content += "  [cyan]/mcp install[/cyan]  Browse catalog\n"
+    content += "  [cyan]/mcp add[/cyan]      Add custom server\n"
+    content += "  [cyan]/mcp list[/cyan]     See your servers\n\n"
+    content += "[yellow]🌟 Popular picks:[/yellow]\n"
+    content += "  • GitHub integration\n"
+    content += "  • Postgres/databases\n"
+    content += "  • Slack, Linear, etc.\n\n"
+    content += "[dim]Skip this if you just want to code![/dim]"
+    content += get_nav_footer()
+    return content
+
+
+def slide_use_cases() -> str:
+    """Slide 4: When to use which agent - THE IMPORTANT ONE."""
+    content = "[bold cyan]🎯 When to Use What[/bold cyan]\n\n"
+
+    content += "[bold yellow]🐶 Code Puppy (default)[/bold yellow]\n"
+    content += "  [green]USE FOR:[/green] Direct coding tasks\n"
+    content += "  • Fix this bug\n"
+    content += "  • Add a feature to this file\n"
+    content += "  • Refactor this function\n"
+    content += "  • Write tests for X\n\n"
+
+    content += "[bold yellow]📋 Planning Agent[/bold yellow]\n"
+    content += "  [green]USE FOR:[/green] Complex multi-step projects\n"
+    content += "  • Build me a REST API with auth\n"
+    content += "  • Create a CLI tool from scratch\n"
+    content += "  • Refactor entire codebase\n"
+    content += "  • Multi-file architectural changes\n\n"
+
+    content += "[cyan]Switch: /agent planning-agent[/cyan]\n"
+    content += "[dim]Planning breaks big tasks into steps,[/dim]\n"
+    content += "[dim]then delegates to specialists.[/dim]"
+    content += get_nav_footer()
+    return content
+
+
+def slide_done(trigger_oauth: str | None) -> str:
+    """Slide 5: You're ready!"""
+    content = "[bold green]🎉 Ready to Roll![/bold green]\n\n"
+    content += "[bold cyan]Essential commands:[/bold cyan]\n"
+    content += "  [cyan]/model[/cyan]   Switch models\n"
+    content += "  [cyan]/agent[/cyan]   Switch agents\n"
+    content += "  [cyan]/help[/cyan]    All commands\n\n"
+
+    content += "[bold yellow]Pro tips:[/bold yellow]\n"
+    content += "  • Be specific in prompts\n"
+    content += "  • Use Planning Agent for big tasks\n"
+    content += "  • @ for file path completion\n\n"
+
+    if trigger_oauth:
+        content += f"[bold cyan]→ {trigger_oauth.title()} OAuth next![/bold cyan]\n\n"
+
+    content += "[dim]Re-run anytime: [/dim][cyan]/tutorial[/cyan]\n"
+    content += "\n[bold yellow]Press Enter to start coding! 🐶[/bold yellow]"
+    content += get_nav_footer()
+    return content