mcp-ticketer 0.4.2__py3-none-any.whl → 0.4.4__py3-none-any.whl

mcp_ticketer/cli/main.py

@@ -5,7 +5,6 @@ import json
 import os
 from enum import Enum
 from pathlib import Path
-from typing import Optional
 
 import typer
 from dotenv import load_dotenv
@@ -84,7 +83,7 @@ class AdapterType(str, Enum):
     GITHUB = "github"
 
 
-def load_config(project_dir: Optional[Path] = None) -> dict:
+def load_config(project_dir: Path | None = None) -> dict:
     """Load configuration from project-local config file ONLY.
 
     SECURITY: This method ONLY reads from the current project directory
@@ -146,7 +145,7 @@ def load_config(project_dir: Optional[Path] = None) -> dict:
     return {"adapter": "aitrackdown", "config": {"base_path": ".aitrackdown"}}
 
 
-def _discover_from_env_files() -> Optional[str]:
+def _discover_from_env_files() -> str | None:
     """Discover adapter configuration from .env or .env.local files.
 
     Returns:
@@ -270,7 +269,7 @@ def merge_config(updates: dict) -> dict:
 
 
 def get_adapter(
-    override_adapter: Optional[str] = None, override_config: Optional[dict] = None
+    override_adapter: str | None = None, override_config: dict | None = None
 ):
     """Get configured adapter instance.
 
@@ -387,13 +386,13 @@ def _prompt_for_adapter_selection(console: Console) -> str:
 
 @app.command()
 def setup(
-    adapter: Optional[str] = typer.Option(
+    adapter: str | None = typer.Option(
         None,
         "--adapter",
         "-a",
         help="Adapter type to use (interactive prompt if not specified)",
     ),
-    project_path: Optional[str] = typer.Option(
+    project_path: str | None = typer.Option(
         None, "--path", help="Project path (default: current directory)"
     ),
     global_config: bool = typer.Option(
@@ -402,36 +401,36 @@ def setup(
         "-g",
         help="Save to global config instead of project-specific",
     ),
-    base_path: Optional[str] = typer.Option(
+    base_path: str | None = typer.Option(
         None,
         "--base-path",
         "-p",
         help="Base path for ticket storage (AITrackdown only)",
     ),
-    api_key: Optional[str] = typer.Option(
+    api_key: str | None = typer.Option(
         None, "--api-key", help="API key for Linear or API token for JIRA"
     ),
-    team_id: Optional[str] = typer.Option(
+    team_id: str | None = typer.Option(
         None, "--team-id", help="Linear team ID (required for Linear adapter)"
     ),
-    jira_server: Optional[str] = typer.Option(
+    jira_server: str | None = typer.Option(
         None,
         "--jira-server",
         help="JIRA server URL (e.g., https://company.atlassian.net)",
     ),
-    jira_email: Optional[str] = typer.Option(
+    jira_email: str | None = typer.Option(
         None, "--jira-email", help="JIRA user email for authentication"
     ),
-    jira_project: Optional[str] = typer.Option(
+    jira_project: str | None = typer.Option(
         None, "--jira-project", help="Default JIRA project key"
     ),
-    github_owner: Optional[str] = typer.Option(
+    github_owner: str | None = typer.Option(
         None, "--github-owner", help="GitHub repository owner"
     ),
-    github_repo: Optional[str] = typer.Option(
+    github_repo: str | None = typer.Option(
         None, "--github-repo", help="GitHub repository name"
     ),
-    github_token: Optional[str] = typer.Option(
+    github_token: str | None = typer.Option(
         None, "--github-token", help="GitHub Personal Access Token"
     ),
 ) -> None:
@@ -471,13 +470,13 @@ def setup(
 
 @app.command()
 def init(
-    adapter: Optional[str] = typer.Option(
+    adapter: str | None = typer.Option(
         None,
         "--adapter",
         "-a",
         help="Adapter type to use (interactive prompt if not specified)",
     ),
-    project_path: Optional[str] = typer.Option(
+    project_path: str | None = typer.Option(
         None, "--path", help="Project path (default: current directory)"
     ),
     global_config: bool = typer.Option(
@@ -486,40 +485,40 @@ def init(
         "-g",
         help="Save to global config instead of project-specific",
     ),
-    base_path: Optional[str] = typer.Option(
+    base_path: str | None = typer.Option(
         None,
         "--base-path",
         "-p",
         help="Base path for ticket storage (AITrackdown only)",
     ),
-    api_key: Optional[str] = typer.Option(
+    api_key: str | None = typer.Option(
         None, "--api-key", help="API key for Linear or API token for JIRA"
     ),
-    team_id: Optional[str] = typer.Option(
+    team_id: str | None = typer.Option(
         None, "--team-id", help="Linear team ID (required for Linear adapter)"
     ),
-    jira_server: Optional[str] = typer.Option(
+    jira_server: str | None = typer.Option(
         None,
         "--jira-server",
         help="JIRA server URL (e.g., https://company.atlassian.net)",
     ),
-    jira_email: Optional[str] = typer.Option(
+    jira_email: str | None = typer.Option(
         None, "--jira-email", help="JIRA user email for authentication"
     ),
-    jira_project: Optional[str] = typer.Option(
+    jira_project: str | None = typer.Option(
         None, "--jira-project", help="Default JIRA project key"
     ),
-    github_owner: Optional[str] = typer.Option(
+    github_owner: str | None = typer.Option(
         None, "--github-owner", help="GitHub repository owner"
     ),
-    github_repo: Optional[str] = typer.Option(
+    github_repo: str | None = typer.Option(
         None, "--github-repo", help="GitHub repository name"
     ),
-    github_token: Optional[str] = typer.Option(
+    github_token: str | None = typer.Option(
         None, "--github-token", help="GitHub Personal Access Token"
     ),
 ) -> None:
-    """Initialize mcp-ticketer for the current project.
+    """Initialize mcp-ticketer for the current project (synonymous with 'install' and 'setup').
 
     This command sets up MCP Ticketer configuration with interactive prompts
     to guide you through the process. It auto-detects adapter configuration
@@ -528,11 +527,13 @@ def init(
     Creates .mcp-ticketer/config.json in the current directory with
     auto-detected or specified adapter configuration.
 
-    Note: 'setup' and 'install' are synonyms for this command.
+    Note: 'init', 'install', and 'setup' are all synonyms - use whichever feels natural.
 
     Examples:
-        # Interactive setup (same as 'setup' and 'install')
+        # Interactive setup (all three commands are identical)
         mcp-ticketer init
+        mcp-ticketer install
+        mcp-ticketer setup
 
         # Force specific adapter
         mcp-ticketer init --adapter linear
@@ -669,20 +670,31 @@ def init(
             if linear_api_key:
                 linear_config["api_key"] = linear_api_key
 
-            # Team ID
+            # Team ID or Team Key
+            # Try environment variables first
+            linear_team_key = os.getenv("LINEAR_TEAM_KEY")
             linear_team_id = team_id or os.getenv("LINEAR_TEAM_ID")
-            if not linear_team_id and not discovered:
-                console.print("\nYou need your Linear team ID.")
-                console.print("[dim]Find it in Linear settings or team URL[/dim]\n")
 
-                linear_team_id = typer.prompt("Enter your Linear team ID")
+            if not linear_team_key and not linear_team_id and not discovered:
+                console.print("\n[bold]Linear Team Configuration[/bold]")
+                console.print("Enter your team key (e.g., 'ENG', 'DESIGN', 'PRODUCT')")
+                console.print(
+                    "[dim]Find it in: Linear Settings → Teams → Your Team → Key field[/dim]\n"
+                )
+
+                linear_team_key = typer.prompt("Team key")
 
+            # Save whichever was provided
+            if linear_team_key:
+                linear_config["team_key"] = linear_team_key
             if linear_team_id:
                 linear_config["team_id"] = linear_team_id
 
-            if not linear_config.get("api_key") or not linear_config.get("team_id"):
+            if not linear_config.get("api_key") or (
+                not linear_config.get("team_id") and not linear_config.get("team_key")
+            ):
                 console.print(
-                    "[red]Error:[/red] Linear requires both API key and team ID"
+                    "[red]Error:[/red] Linear requires both API key and team ID/key"
                 )
                 console.print(
                     "Run 'mcp-ticketer init --adapter linear' with proper credentials"
@@ -882,107 +894,30 @@ def _show_next_steps(
         console.print("\n3. [cyan]Check local ticket storage:[/cyan]")
         console.print("   ls .aitrackdown/")
 
-    console.print("\n4. [cyan]Configure MCP clients (optional):[/cyan]")
-    console.print("   mcp-ticketer mcp claude    # For Claude Code")
-    console.print("   mcp-ticketer mcp auggie    # For Auggie")
-    console.print("   mcp-ticketer mcp gemini    # For Gemini CLI")
+    console.print("\n4. [cyan]Install MCP for AI clients (optional):[/cyan]")
+    console.print("   mcp-ticketer install claude-code     # For Claude Code")
+    console.print("   mcp-ticketer install claude-desktop  # For Claude Desktop")
+    console.print("   mcp-ticketer install auggie          # For Auggie")
+    console.print("   mcp-ticketer install gemini          # For Gemini CLI")
 
     console.print(f"\n[dim]Configuration saved to: {config_file_path}[/dim]")
     console.print("[dim]Run 'mcp-ticketer --help' for more commands[/dim]")
 
 
-# Keep the old install command as deprecated alias to init
-@app.command(deprecated=True, hidden=True)
-def install(
-    adapter: Optional[str] = typer.Option(
-        None,
-        "--adapter",
-        "-a",
-        help="Adapter type to use (auto-detected from .env if not specified)",
-    ),
-    project_path: Optional[str] = typer.Option(
-        None, "--path", help="Project path (default: current directory)"
-    ),
-    global_config: bool = typer.Option(
-        False,
-        "--global",
-        "-g",
-        help="Save to global config instead of project-specific",
-    ),
-    base_path: Optional[str] = typer.Option(
-        None,
-        "--base-path",
-        "-p",
-        help="Base path for ticket storage (AITrackdown only)",
-    ),
-    api_key: Optional[str] = typer.Option(
-        None, "--api-key", help="API key for Linear or API token for JIRA"
-    ),
-    team_id: Optional[str] = typer.Option(
-        None, "--team-id", help="Linear team ID (required for Linear adapter)"
-    ),
-    jira_server: Optional[str] = typer.Option(
-        None,
-        "--jira-server",
-        help="JIRA server URL (e.g., https://company.atlassian.net)",
-    ),
-    jira_email: Optional[str] = typer.Option(
-        None, "--jira-email", help="JIRA user email for authentication"
-    ),
-    jira_project: Optional[str] = typer.Option(
-        None, "--jira-project", help="Default JIRA project key"
-    ),
-    github_owner: Optional[str] = typer.Option(
-        None, "--github-owner", help="GitHub repository owner"
-    ),
-    github_repo: Optional[str] = typer.Option(
-        None, "--github-repo", help="GitHub repository name"
-    ),
-    github_token: Optional[str] = typer.Option(
-        None, "--github-token", help="GitHub Personal Access Token"
-    ),
-) -> None:
-    """DEPRECATED: Use 'mcp-ticketer init' instead.
-
-    This command is deprecated. Use 'mcp-ticketer init' for project initialization.
-
-    """
-    console.print(
-        "[yellow]⚠️  'install' is deprecated. Use 'mcp-ticketer init' instead.[/yellow]\n"
-    )
-    # Call init with all parameters
-    init(
-        adapter=adapter,
-        project_path=project_path,
-        global_config=global_config,
-        base_path=base_path,
-        api_key=api_key,
-        team_id=team_id,
-        jira_server=jira_server,
-        jira_email=jira_email,
-        jira_project=jira_project,
-        github_owner=github_owner,
-        github_repo=github_repo,
-        github_token=github_token,
-    )
-
-
 @app.command("set")
 def set_config(
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", "-a", help="Set default adapter"
     ),
-    team_key: Optional[str] = typer.Option(
+    team_key: str | None = typer.Option(
         None, "--team-key", help="Linear team key (e.g., BTA)"
     ),
-    team_id: Optional[str] = typer.Option(None, "--team-id", help="Linear team ID"),
-    owner: Optional[str] = typer.Option(
-        None, "--owner", help="GitHub repository owner"
-    ),
-    repo: Optional[str] = typer.Option(None, "--repo", help="GitHub repository name"),
-    server: Optional[str] = typer.Option(None, "--server", help="JIRA server URL"),
-    project: Optional[str] = typer.Option(None, "--project", help="JIRA project key"),
-    base_path: Optional[str] = typer.Option(
+    team_id: str | None = typer.Option(None, "--team-id", help="Linear team ID"),
+    owner: str | None = typer.Option(None, "--owner", help="GitHub repository owner"),
+    repo: str | None = typer.Option(None, "--repo", help="GitHub repository name"),
+    server: str | None = typer.Option(None, "--server", help="JIRA server URL"),
+    project: str | None = typer.Option(None, "--project", help="JIRA project key"),
+    base_path: str | None = typer.Option(
         None, "--base-path", help="AITrackdown base path"
     ),
 ) -> None:
@@ -1072,16 +1007,12 @@ def set_config(
 @app.command("configure")
 def configure_command(
     show: bool = typer.Option(False, "--show", help="Show current configuration"),
-    adapter: Optional[str] = typer.Option(
+    adapter: str | None = typer.Option(
         None, "--adapter", help="Set default adapter type"
     ),
-    api_key: Optional[str] = typer.Option(None, "--api-key", help="Set API key/token"),
-    project_id: Optional[str] = typer.Option(
-        None, "--project-id", help="Set project ID"
-    ),
-    team_id: Optional[str] = typer.Option(
-        None, "--team-id", help="Set team ID (Linear)"
-    ),
+    api_key: str | None = typer.Option(None, "--api-key", help="Set API key/token"),
+    project_id: str | None = typer.Option(None, "--project-id", help="Set project ID"),
+    team_id: str | None = typer.Option(None, "--team-id", help="Set team ID (Linear)"),
     global_scope: bool = typer.Option(
         False,
         "--global",
@@ -1257,29 +1188,29 @@ def old_queue_health_command(
 @app.command(deprecated=True, hidden=True)
 def create(
     title: str = typer.Argument(..., help="Ticket title"),
-    description: Optional[str] = typer.Option(
+    description: str | None = typer.Option(
         None, "--description", "-d", help="Ticket description"
     ),
     priority: Priority = typer.Option(
         Priority.MEDIUM, "--priority", "-p", help="Priority level"
     ),
-    tags: Optional[list[str]] = typer.Option(
+    tags: list[str] | None = typer.Option(
         None, "--tag", "-t", help="Tags (can be specified multiple times)"
     ),
-    assignee: Optional[str] = typer.Option(
+    assignee: str | None = typer.Option(
         None, "--assignee", "-a", help="Assignee username"
     ),
-    project: Optional[str] = typer.Option(
+    project: str | None = typer.Option(
         None,
         "--project",
         help="Parent project/epic ID (synonym for --epic)",
     ),
-    epic: Optional[str] = typer.Option(
+    epic: str | None = typer.Option(
         None,
         "--epic",
         help="Parent epic/project ID (synonym for --project)",
     ),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1488,14 +1419,14 @@ def create(
 
 @app.command("list", deprecated=True, hidden=True)
 def list_tickets(
-    state: Optional[TicketState] = typer.Option(
+    state: TicketState | None = typer.Option(
         None, "--state", "-s", help="Filter by state"
     ),
-    priority: Optional[Priority] = typer.Option(
+    priority: Priority | None = typer.Option(
         None, "--priority", "-p", help="Filter by priority"
     ),
     limit: int = typer.Option(10, "--limit", "-l", help="Maximum number of tickets"),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1551,7 +1482,7 @@ def list_tickets(
 def show(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     comments: bool = typer.Option(False, "--comments", "-c", help="Show comments"),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1607,7 +1538,7 @@ def show(
 def comment(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
     content: str = typer.Argument(..., help="Comment content"),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1648,17 +1579,15 @@ def comment(
 @app.command(deprecated=True, hidden=True)
 def update(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
-    title: Optional[str] = typer.Option(None, "--title", help="New title"),
-    description: Optional[str] = typer.Option(
+    title: str | None = typer.Option(None, "--title", help="New title"),
+    description: str | None = typer.Option(
         None, "--description", "-d", help="New description"
     ),
-    priority: Optional[Priority] = typer.Option(
+    priority: Priority | None = typer.Option(
         None, "--priority", "-p", help="New priority"
     ),
-    assignee: Optional[str] = typer.Option(
-        None, "--assignee", "-a", help="New assignee"
-    ),
-    adapter: Optional[AdapterType] = typer.Option(
+    assignee: str | None = typer.Option(None, "--assignee", "-a", help="New assignee"),
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1718,13 +1647,13 @@ def update(
 @app.command(deprecated=True, hidden=True)
 def transition(
     ticket_id: str = typer.Argument(..., help="Ticket ID"),
-    state_positional: Optional[TicketState] = typer.Argument(
+    state_positional: TicketState | None = typer.Argument(
         None, help="Target state (positional - deprecated, use --state instead)"
     ),
-    state: Optional[TicketState] = typer.Option(
+    state: TicketState | None = typer.Option(
         None, "--state", "-s", help="Target state (recommended)"
     ),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1789,12 +1718,12 @@ def transition(
 
 @app.command(deprecated=True, hidden=True)
 def search(
-    query: Optional[str] = typer.Argument(None, help="Search query"),
-    state: Optional[TicketState] = typer.Option(None, "--state", "-s"),
-    priority: Optional[Priority] = typer.Option(None, "--priority", "-p"),
-    assignee: Optional[str] = typer.Option(None, "--assignee", "-a"),
+    query: str | None = typer.Argument(None, help="Search query"),
+    state: TicketState | None = typer.Option(None, "--state", "-s"),
+    priority: Priority | None = typer.Option(None, "--priority", "-p"),
+    assignee: str | None = typer.Option(None, "--assignee", "-a"),
     limit: int = typer.Option(10, "--limit", "-l"),
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", help="Override default adapter"
     ),
 ) -> None:
@@ -1852,7 +1781,7 @@ app.add_typer(discover_app, name="discover")
 # Add diagnostics command
 @app.command("diagnose")
 def diagnose_command(
-    output_file: Optional[str] = typer.Option(
+    output_file: str | None = typer.Option(
         None, "--output", "-o", help="Save full report to file"
     ),
     json_output: bool = typer.Option(
@@ -1899,7 +1828,7 @@ def diagnose_command(
 
 @app.command("doctor")
 def doctor_alias(
-    output_file: Optional[str] = typer.Option(
+    output_file: str | None = typer.Option(
         None, "--output", "-o", help="Save full report to file"
     ),
     json_output: bool = typer.Option(
@@ -1944,111 +1873,154 @@ mcp_app = typer.Typer(
 
 @app.command()
 def install(
-    platform: Optional[str] = typer.Argument(
+    platform: str | None = typer.Argument(
         None,
-        help="Platform to install (claude-code, claude-desktop, auggie, gemini, codex)",
+        help="Platform to install (claude-code, claude-desktop, gemini, codex, auggie)",
+    ),
+    adapter: str | None = typer.Option(
+        None,
+        "--adapter",
+        "-a",
+        help="Adapter type to use (interactive prompt if not specified)",
+    ),
+    project_path: str | None = typer.Option(
+        None, "--path", help="Project path (default: current directory)"
+    ),
+    global_config: bool = typer.Option(
+        False,
+        "--global",
+        "-g",
+        help="Save to global config instead of project-specific",
+    ),
+    base_path: str | None = typer.Option(
+        None,
+        "--base-path",
+        "-p",
+        help="Base path for ticket storage (AITrackdown only)",
+    ),
+    api_key: str | None = typer.Option(
+        None, "--api-key", help="API key for Linear or API token for JIRA"
+    ),
+    team_id: str | None = typer.Option(
+        None, "--team-id", help="Linear team ID (required for Linear adapter)"
+    ),
+    jira_server: str | None = typer.Option(
+        None,
+        "--jira-server",
+        help="JIRA server URL (e.g., https://company.atlassian.net)",
+    ),
+    jira_email: str | None = typer.Option(
+        None, "--jira-email", help="JIRA user email for authentication"
+    ),
+    jira_project: str | None = typer.Option(
+        None, "--jira-project", help="Default JIRA project key"
+    ),
+    github_owner: str | None = typer.Option(
+        None, "--github-owner", help="GitHub repository owner"
+    ),
+    github_repo: str | None = typer.Option(
+        None, "--github-repo", help="GitHub repository name"
+    ),
+    github_token: str | None = typer.Option(
+        None, "--github-token", help="GitHub Personal Access Token"
     ),
     dry_run: bool = typer.Option(
-        False, "--dry-run", help="Show what would be done without making changes"
+        False,
+        "--dry-run",
+        help="Show what would be done without making changes (for platform installation)",
     ),
 ) -> None:
-    """Install mcp-ticketer for AI platforms.
-
-    Without arguments, shows installation status and available platforms.
-    With a platform argument, installs MCP configuration for that platform.
+    """Install MCP for AI platforms OR initialize adapter setup.
 
-    Each platform gets the right configuration automatically:
-      - claude-code: Project-level MCP server
-      - claude-desktop: Global MCP server
-      - auggie: Project-level MCP server
-      - gemini: Project-level MCP server
-      - codex: Project-level MCP server
+    With platform argument (new syntax): Install MCP configuration for AI platforms
+    Without platform argument (legacy): Run adapter setup wizard (same as 'init' and 'setup')
 
-    Examples:
-        # Show status and available platforms
-        mcp-ticketer install
+    New Command Structure:
+        # Install MCP for AI platforms
+        mcp-ticketer install claude-code     # Claude Code (project-level)
+        mcp-ticketer install claude-desktop  # Claude Desktop (global)
+        mcp-ticketer install gemini          # Gemini CLI
+        mcp-ticketer install codex           # Codex
+        mcp-ticketer install auggie          # Auggie
 
-        # Install for Claude Code (project-level)
-        mcp-ticketer install claude-code
-
-        # Install for Claude Desktop (global)
-        mcp-ticketer install claude-desktop
-
-        # Install for Auggie
-        mcp-ticketer install auggie
-
-        # Dry run to preview changes
-        mcp-ticketer install claude-code --dry-run
+    Legacy Adapter Setup (still supported):
+        mcp-ticketer install                 # Interactive setup wizard
+        mcp-ticketer install --adapter linear
 
     """
-    # If no platform specified, show help message
-    if platform is None:
-        console.print("[green]✓[/green] mcp-ticketer CLI is already installed.\n")
-        console.print(
-            "[bold]To configure MCP for a specific platform, use:[/bold]\n"
-            "  mcp-ticketer install <platform>\n"
-        )
-        console.print("[bold]Available platforms:[/bold]")
-        console.print("  • claude-code     - Claude Code (project-level)")
-        console.print("  • claude-desktop  - Claude Desktop (global)")
-        console.print("  • auggie          - Auggie (project-level)")
-        console.print("  • gemini          - Gemini CLI (project-level)")
-        console.print("  • codex           - Codex (project-level)")
-        return
+    # If platform argument is provided, handle MCP platform installation (NEW SYNTAX)
+    if platform is not None:
+        # Import configuration functions
+        from .auggie_configure import configure_auggie_mcp
+        from .codex_configure import configure_codex_mcp
+        from .gemini_configure import configure_gemini_mcp
+        from .mcp_configure import configure_claude_mcp
+
+        # Map platform names to configuration functions
+        platform_mapping = {
+            "claude-code": {
+                "func": lambda: configure_claude_mcp(global_config=False, force=True),
+                "name": "Claude Code",
+            },
+            "claude-desktop": {
+                "func": lambda: configure_claude_mcp(global_config=True, force=True),
+                "name": "Claude Desktop",
+            },
+            "auggie": {
+                "func": lambda: configure_auggie_mcp(force=True),
+                "name": "Auggie",
+            },
+            "gemini": {
+                "func": lambda: configure_gemini_mcp(scope="project", force=True),
+                "name": "Gemini CLI",
+            },
+            "codex": {
+                "func": lambda: configure_codex_mcp(force=True),
+                "name": "Codex",
+            },
+        }
 
-    # Import configuration functions
-    from .auggie_configure import configure_auggie_mcp
-    from .codex_configure import configure_codex_mcp
-    from .gemini_configure import configure_gemini_mcp
-    from .mcp_configure import configure_claude_mcp
+        if platform not in platform_mapping:
+            console.print(f"[red]Unknown platform: {platform}[/red]")
+            console.print("\n[bold]Available platforms:[/bold]")
+            for p in platform_mapping.keys():
+                console.print(f"  • {p}")
+            raise typer.Exit(1)
 
-    # Map platform names to configuration functions
-    platform_mapping = {
-        "claude-code": {
-            "func": lambda: configure_claude_mcp(global_config=False, force=True),
-            "name": "Claude Code",
-        },
-        "claude-desktop": {
-            "func": lambda: configure_claude_mcp(global_config=True, force=True),
-            "name": "Claude Desktop",
-        },
-        "auggie": {
-            "func": lambda: configure_auggie_mcp(force=True),
-            "name": "Auggie",
-        },
-        "gemini": {
-            "func": lambda: configure_gemini_mcp(scope="project", force=True),
-            "name": "Gemini CLI",
-        },
-        "codex": {
-            "func": lambda: configure_codex_mcp(force=True),
-            "name": "Codex",
-        },
-    }
+        config = platform_mapping[platform]
 
-    if platform not in platform_mapping:
-        console.print(f"[red]Unknown platform: {platform}[/red]")
-        console.print("\n[bold]Available platforms:[/bold]")
-        for p in platform_mapping.keys():
-            console.print(f"  • {p}")
-        raise typer.Exit(1)
-
-    config = platform_mapping[platform]
+        if dry_run:
+            console.print(f"[cyan]DRY RUN - Would install for {config['name']}[/cyan]")
+            return
 
-    if dry_run:
-        console.print(f"[cyan]DRY RUN - Would install for {config['name']}[/cyan]")
+        try:
+            config["func"]()
+        except Exception as e:
+            console.print(f"[red]Installation failed: {e}[/red]")
+            raise typer.Exit(1)
         return
 
-    try:
-        config["func"]()
-    except Exception as e:
-        console.print(f"[red]Installation failed: {e}[/red]")
-        raise typer.Exit(1)
+    # Otherwise, delegate to init for adapter initialization (LEGACY BEHAVIOR)
+    # This makes 'install' and 'init' synonymous when called without platform argument
+    init(
+        adapter=adapter,
+        project_path=project_path,
+        global_config=global_config,
+        base_path=base_path,
+        api_key=api_key,
+        team_id=team_id,
+        jira_server=jira_server,
+        jira_email=jira_email,
+        jira_project=jira_project,
+        github_owner=github_owner,
+        github_repo=github_repo,
+        github_token=github_token,
+    )
 
 
 @app.command()
 def remove(
-    platform: Optional[str] = typer.Argument(
+    platform: str | None = typer.Argument(
         None,
         help="Platform to remove (claude-code, claude-desktop, auggie, gemini, codex)",
     ),
@@ -2135,7 +2107,7 @@ def remove(
 
 @app.command()
 def uninstall(
-    platform: Optional[str] = typer.Argument(
+    platform: str | None = typer.Argument(
         None,
         help="Platform to uninstall (claude-code, claude-desktop, auggie, gemini, codex)",
     ),
@@ -2218,10 +2190,10 @@ def check(queue_id: str = typer.Argument(..., help="Queue ID to check")):
 
 @mcp_app.command(name="serve")
 def mcp_serve(
-    adapter: Optional[AdapterType] = typer.Option(
+    adapter: AdapterType | None = typer.Option(
         None, "--adapter", "-a", help="Override default adapter type"
     ),
-    base_path: Optional[str] = typer.Option(
+    base_path: str | None = typer.Option(
         None, "--base-path", help="Base path for AITrackdown adapter"
     ),
 ):
@@ -2453,6 +2425,125 @@ def mcp_auggie(
         raise typer.Exit(1)
 
 
+@mcp_app.command(name="status")
+def mcp_status():
+    """Check MCP server status.
+
+    Shows whether the MCP server is configured and running for various platforms.
+
+    Examples:
+        mcp-ticketer mcp status
+
+    """
+    import json
+    from pathlib import Path
+
+    console.print("[bold]MCP Server Status[/bold]\n")
+
+    # Check project-level configuration
+    project_config = Path.cwd() / ".mcp-ticketer" / "config.json"
+    if project_config.exists():
+        console.print(f"[green]✓[/green] Project config found: {project_config}")
+        try:
+            with open(project_config) as f:
+                config = json.load(f)
+                adapter = config.get("default_adapter", "aitrackdown")
+                console.print(f"  Default adapter: [cyan]{adapter}[/cyan]")
+        except Exception as e:
+            console.print(f"  [yellow]Warning: Could not read config: {e}[/yellow]")
+    else:
+        console.print("[yellow]○[/yellow] No project config found")
+
+    # Check Claude Code configuration
+    claude_code_config = Path.cwd() / ".mcp" / "config.json"
+    if claude_code_config.exists():
+        console.print(
+            f"\n[green]✓[/green] Claude Code configured: {claude_code_config}"
+        )
+    else:
+        console.print("\n[yellow]○[/yellow] Claude Code not configured")
+
+    # Check Claude Desktop configuration
+    claude_desktop_config = (
+        Path.home()
+        / "Library"
+        / "Application Support"
+        / "Claude"
+        / "claude_desktop_config.json"
+    )
+    if claude_desktop_config.exists():
+        try:
+            with open(claude_desktop_config) as f:
+                config = json.load(f)
+                if "mcpServers" in config and "mcp-ticketer" in config["mcpServers"]:
+                    console.print(
+                        f"[green]✓[/green] Claude Desktop configured: {claude_desktop_config}"
+                    )
+                else:
+                    console.print(
+                        "[yellow]○[/yellow] Claude Desktop config exists but mcp-ticketer not found"
+                    )
+        except Exception:
+            console.print(
+                "[yellow]○[/yellow] Claude Desktop config exists but could not be read"
+            )
+    else:
+        console.print("[yellow]○[/yellow] Claude Desktop not configured")
+
+    # Check Gemini configuration
+    gemini_project_config = Path.cwd() / ".gemini" / "settings.json"
+    gemini_user_config = Path.home() / ".gemini" / "settings.json"
+    if gemini_project_config.exists():
+        console.print(
+            f"\n[green]✓[/green] Gemini (project) configured: {gemini_project_config}"
+        )
+    elif gemini_user_config.exists():
+        console.print(
+            f"\n[green]✓[/green] Gemini (user) configured: {gemini_user_config}"
+        )
+    else:
+        console.print("\n[yellow]○[/yellow] Gemini not configured")
+
+    # Check Codex configuration
+    codex_config = Path.home() / ".codex" / "config.toml"
+    if codex_config.exists():
+        console.print(f"[green]✓[/green] Codex configured: {codex_config}")
+    else:
+        console.print("[yellow]○[/yellow] Codex not configured")
+
+    # Check Auggie configuration
+    auggie_config = Path.home() / ".augment" / "settings.json"
+    if auggie_config.exists():
+        console.print(f"[green]✓[/green] Auggie configured: {auggie_config}")
+    else:
+        console.print("[yellow]○[/yellow] Auggie not configured")
+
+    console.print(
+        "\n[dim]Run 'mcp-ticketer install <platform>' to configure a platform[/dim]"
+    )
+
+
+@mcp_app.command(name="stop")
+def mcp_stop():
+    """Stop MCP server (placeholder - MCP runs on-demand via stdio).
+
+    Note: The MCP server runs on-demand when AI clients connect via stdio.
+    It doesn't run as a persistent background service, so there's nothing to stop.
+    This command is provided for consistency but has no effect.
+
+    Examples:
+        mcp-ticketer mcp stop
+
+    """
+    console.print(
+        "[yellow]ℹ[/yellow]  MCP server runs on-demand via stdio (not as a background service)"
+    )
+    console.print("There is no persistent server process to stop.")
+    console.print(
+        "\n[dim]The server starts automatically when AI clients connect and stops when they disconnect.[/dim]"
+    )
+
+
 # Add command groups to main app (must be after all subcommands are defined)
 app.add_typer(mcp_app, name="mcp")