merge init and quickstart

Author: jtcorbett

docs/cli-reference.mdx

@@ -45,46 +45,54 @@ mcp-agent init [OPTIONS]
 
 | Option | Description | Default |
 | :----- | :---------- | :------ |
-| `--name <name>` | Project name | Current directory name |
-| `--template <type>` | Project template | `basic` |
-| `--path <dir>` | Target directory | Current directory |
-| `--force` | Overwrite existing files | `false` |
+| `--dir`, `-d` | Target directory | Current directory (`.`) |
+| `--template`, `-t` | Project template (scaffolding or example) | `basic` |
+| `--quickstart` | Quickstart mode: copy example only without config files | - |
+| `--force`, `-f` | Overwrite existing files | `false` |
+| `--no-gitignore` | Skip creating .gitignore | `false` |
+| `--list`, `-l` | List all available templates | - |
+
+**Templates:**
+
+Two types of templates are available:
+1. **Scaffolding templates** - Create minimal project structure with config files
+   - `basic` - Simple agent with filesystem and fetch
+   - `server` - MCP server with workflow and parallel agents
+   - `token` - Token counting example
+   - `factory` - Agent factory with router-based selection
+   - `minimal` - Config files only
+
+2. **Example templates** - Copy complete example projects
+   - `workflow` - All workflow pattern examples
+   - `researcher` - MCP researcher use case
+   - `elicitation` - MCP elicitation patterns
+   - `state-transfer` - Workflow router example
+   - `data-analysis` - Financial analyzer use case
+   - `mcp-basic-agent` - Basic MCP agent example
+   - `token-counter` - Token counting example
+   - `agent-factory` - Agent factory pattern
+   - `basic-agent-server` - Basic agent server (asyncio)
+   - `reference-agent-server` - Reference agent server implementation
+   - `sampling` - Sampling server example
+   - `notifications` - Notifications server example
 
 **Examples:**
 ```bash
-# Interactive initialization
-mcp-agent init
+# List all available templates
+mcp-agent init --list
 
-# With specific template
-mcp-agent init --template temporal --name research-agent
-```
-
-### mcp-agent quickstart
-
-Create example projects with pre-built patterns.
-
-```bash
-mcp-agent quickstart <TYPE> [OPTIONS]
-```
+# Create scaffolding project with config files
+mcp-agent init --template basic
 
-**Available types:**
-- `workflow` - All workflow pattern examples
-- `researcher` - MCP researcher use case
-- `elicitations` - MCP elicitation patterns
-- `state-transfer` - Workflow router example
-- `data-analysis` - Financial analyzer use case
-- `mcp-basic-agent` - Basic MCP agent example
-- `token-counter` - Token counting example
-- `agent-factory` - Agent factory pattern
-- `basic-agent-server` - Basic agent server (asyncio)
+# Copy complete example with config files
+mcp-agent init --template workflow --dir ./my-project
 
-**Examples:**
-```bash
-# Create workflow examples
-mcp-agent quickstart workflow
+# Quickstart mode: copy example only (backward compatible with old 'mcp-agent quickstart')
+mcp-agent init --quickstart workflow
+# Creates ./workflow/ subdirectory without config files
 
-# Create researcher example with force overwrite
-mcp-agent quickstart researcher --force
+# Force overwrite
+mcp-agent init --quickstart researcher --force
 ```
 
 ### mcp-agent go
@@ -444,7 +452,7 @@ mcp-agent check
 mcp-agent go --model gpt-4o
 
 # Create examples
-mcp-agent quickstart workflow
+mcp-agent init --quickstart workflow
 ```
 
 ### Cloud Deployment

src/mcp_agent/cli/commands/__init__.py

@@ -11,7 +11,6 @@
     invoke,
     serve,
     init,
-    quickstart,
     config,
     keys,
     models,
@@ -31,7 +30,6 @@
     "invoke",
     "serve",
     "init",
-    "quickstart",
     "config",
     "keys",
     "models",