update

Author: jtcorbett

docs/cli-reference.mdx

@@ -453,7 +453,7 @@ mcp-agent check
 mcp-agent go --model gpt-4o
 
 # Create examples
-mcp-agent init --template workflow
+mcp-agent init --quickstart workflow
 ```
 
 ### Cloud Deployment

src/mcp_agent/cli/commands/init.py

@@ -186,8 +186,8 @@ def init(
     if list_templates:
         console.print("\n[bold]Available Templates:[/bold]\n")
 
-        # Scaffolding templates table
-        console.print("[bold cyan]Scaffolding Templates:[/bold cyan]")
+        # Templates table
+        console.print("[bold cyan]Templates:[/bold cyan]")
         console.print("[dim]Creates minimal project structure with config files[/dim]\n")
         table1 = Table(show_header=True, header_style="cyan")
         table1.add_column("Template", style="green")
@@ -196,8 +196,8 @@ def init(
             table1.add_row(name, desc)
         console.print(table1)
 
-        # Example templates table
-        console.print("\n[bold cyan]Example Templates:[/bold cyan]")
+        # Quickstart templates table
+        console.print("\n[bold cyan]Quickstart Templates:[/bold cyan]")
         console.print("[dim]Copies complete example projects[/dim]\n")
         table2 = Table(show_header=True, header_style="cyan")
         table2.add_column("Template", style="green")
@@ -212,24 +212,19 @@ def init(
     if ctx.invoked_subcommand:
         return
 
-    # Handle quickstart mode (backward compatibility with old 'mcp-agent quickstart' command)
     if quickstart:
-        # Map quickstart names to example templates
         if quickstart not in example_templates:
             console.print(f"[red]Unknown quickstart example: {quickstart}[/red]")
             console.print(f"Available examples: {', '.join(example_templates.keys())}")
             console.print("[dim]Use --list to see all available templates[/dim]")
             raise typer.Exit(1)
 
-        # Quickstart mode: copy example to subdirectory, no config files
         example_map = {
-            # Repository examples
             "workflow": (EXAMPLE_ROOT / "workflows", "workflow"),
             "researcher": (EXAMPLE_ROOT / "usecases" / "mcp_researcher", "researcher"),
             "data-analysis": (EXAMPLE_ROOT / "usecases" / "mcp_financial_analyzer", "data-analysis"),
             "state-transfer": (EXAMPLE_ROOT / "workflows" / "workflow_router", "state-transfer"),
             "basic-agent-server": (EXAMPLE_ROOT / "mcp_agent_server" / "asyncio", "basic_agent_server"),
-            # Packaged examples (installed with package)
             "mcp-basic-agent": (None, "mcp_basic_agent", "basic/mcp_basic_agent"),
             "token-counter": (None, "token_counter", "basic/token_counter"),
             "agent-factory": (None, "agent_factory", "basic/agent_factory"),
@@ -244,23 +239,18 @@ def init(
             console.print(f"[red]Quickstart example '{quickstart}' not found[/red]")
             raise typer.Exit(1)
 
-        # Resolve target directory
         base_dir = dir.resolve()
         base_dir.mkdir(parents=True, exist_ok=True)
 
-        # Copy example to subdirectory
         if len(mapping) == 3:
-            # Packaged example (None, dst_name, pkg_rel)
             _, dst_name, pkg_rel = mapping
             dst = base_dir / dst_name
             copied = _copy_pkg_tree(pkg_rel, dst, force)
             if not copied:
-                # Fallback to repo if available
                 src = EXAMPLE_ROOT / pkg_rel.replace("/", "_")
                 if src.exists():
                     copied = _copy_tree(src, dst, force)
         else:
-            # Repository example (src, dst_name)
             src, dst_name = mapping
             dst = base_dir / dst_name
             copied = _copy_tree(src, dst, force)
@@ -273,7 +263,6 @@ def init(
 
         return
 
-    # Validate template for normal init mode
     if template not in templates:
         console.print(f"[red]Unknown template: {template}[/red]")
         console.print(f"Available templates: {', '.join(templates.keys())}")
@@ -315,13 +304,11 @@ def init(
         # Format: "name": (repo_path, dest_name) for repo examples
         #         "name": (None, dest_name, pkg_rel) for packaged examples
         example_map = {
-            # Repository examples
             "workflow": (EXAMPLE_ROOT / "workflows", "workflow"),
             "researcher": (EXAMPLE_ROOT / "usecases" / "mcp_researcher", "researcher"),
             "data-analysis": (EXAMPLE_ROOT / "usecases" / "mcp_financial_analyzer", "data-analysis"),
             "state-transfer": (EXAMPLE_ROOT / "workflows" / "workflow_router", "state-transfer"),
             "basic-agent-server": (EXAMPLE_ROOT / "mcp_agent_server" / "asyncio", "basic_agent_server"),
-            # Packaged examples (installed with package)
             "mcp-basic-agent": (None, "mcp_basic_agent", "basic/mcp_basic_agent"),
             "token-counter": (None, "token_counter", "basic/token_counter"),
             "agent-factory": (None, "agent_factory", "basic/agent_factory"),
@@ -336,19 +323,15 @@ def init(
             console.print(f"[red]Example template '{template}' not found[/red]")
             raise typer.Exit(1)
 
-        # Try packaged examples first (for templates with pkg_rel), then repo examples
         if len(mapping) == 3:
-            # Packaged example (None, dst_name, pkg_rel)
             _, dst_name, pkg_rel = mapping
             dst = dir / dst_name
             copied = _copy_pkg_tree(pkg_rel, dst, force)
             if not copied:
-                # Fallback to repo if available
                 src = EXAMPLE_ROOT / pkg_rel.replace("/", "_")
                 if src.exists():
                     copied = _copy_tree(src, dst, force)
         else:
-            # Repository example (src, dst_name)
             src, dst_name = mapping
             dst = dir / dst_name
             copied = _copy_tree(src, dst, force)
@@ -366,7 +349,6 @@ def init(
 
         return
 
-    # Create template-specific files for scaffolding templates
     if template == "basic":
         # Determine entry script name and handle existing files
         script_name = "main.py"