mcp-ticketer 0.1.23__py3-none-any.whl → 0.1.24__py3-none-any.whl

mcp_ticketer/__init__.py

@@ -1,16 +1,16 @@
 """MCP Ticketer - Universal ticket management interface."""
 
 from .__version__ import (
-    __author__,
-    __author_email__,
-    __copyright__,
-    __description__,
-    __license__,
-    __title__,
-    __version__,
-    __version_info__,
-    get_user_agent,
-    get_version,
+                          __author__,
+                          __author_email__,
+                          __copyright__,
+                          __description__,
+                          __license__,
+                          __title__,
+                          __version__,
+                          __version_info__,
+                          get_user_agent,
+                          get_version,
 )
 
 __all__ = [

mcp_ticketer/__version__.py

@@ -1,6 +1,6 @@
 """Version information for mcp-ticketer package."""
 
-__version__ = "0.1.23"
+__version__ = "0.1.24"
 __version_info__ = tuple(int(part) for part in __version__.split("."))
 
 # Package metadata

mcp_ticketer/adapters/jira.py

@@ -806,7 +806,9 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
             "custom_fields": custom_fields,
         }
 
-    async def execute_jql(self, jql: str, limit: int = 50) -> builtins.list[Union[Epic, Task]]:
+    async def execute_jql(
+        self, jql: str, limit: int = 50
+    ) -> builtins.list[Union[Epic, Task]]:
         """Execute a raw JQL query.
 
         Args:
@@ -831,7 +833,9 @@ class JiraAdapter(BaseAdapter[Union[Epic, Task]]):
         issues = data.get("issues", [])
         return [self._issue_to_ticket(issue) for issue in issues]
 
-    async def get_sprints(self, board_id: Optional[int] = None) -> builtins.list[dict[str, Any]]:
+    async def get_sprints(
+        self, board_id: Optional[int] = None
+    ) -> builtins.list[dict[str, Any]]:
         """Get active sprints for a board (requires JIRA Software).
 
         Args:

mcp_ticketer/adapters/linear.py

@@ -1547,7 +1547,9 @@ class LinearAdapter(BaseAdapter[Task]):
 
         return result["projectCreate"]["project"]["id"]
 
-    async def get_cycles(self, active_only: bool = True) -> builtins.list[dict[str, Any]]:
+    async def get_cycles(
+        self, active_only: bool = True
+    ) -> builtins.list[dict[str, Any]]:
         """Get Linear cycles (sprints) for the team."""
         team_id = await self._ensure_team_id()
 
@@ -1858,7 +1860,7 @@ class LinearAdapter(BaseAdapter[Task]):
                     search_query, variable_values={"identifier": identifier}
                 )
             return result.get("issue")
-        except:
+        except Exception:
             return None
 
     # Epic/Issue/Task Hierarchy Methods (Linear: Project = Epic, Issue = Issue, Sub-issue = Task)

mcp_ticketer/cli/auggie_configure.py

@@ -0,0 +1,237 @@
+"""Auggie CLI configuration for mcp-ticketer integration.
+
+IMPORTANT: Auggie CLI ONLY supports global configuration at ~/.augment/settings.json.
+There is no project-level configuration support.
+"""
+
+import json
+from pathlib import Path
+from typing import Any
+
+from rich.console import Console
+
+from .mcp_configure import find_mcp_ticketer_binary, load_project_config
+
+console = Console()
+
+
+def find_auggie_config() -> Path:
+    """Find or create Auggie CLI configuration file.
+
+    Auggie CLI only supports global user-level configuration.
+
+    Returns:
+        Path to Auggie settings file at ~/.augment/settings.json
+
+    """
+    # Global user-level configuration (ONLY option for Auggie)
+    config_path = Path.home() / ".augment" / "settings.json"
+    return config_path
+
+
+def load_auggie_config(config_path: Path) -> dict[str, Any]:
+    """Load existing Auggie configuration or return empty structure.
+
+    Args:
+        config_path: Path to Auggie settings file
+
+    Returns:
+        Auggie configuration dict
+
+    """
+    if config_path.exists():
+        try:
+            with open(config_path) as f:
+                config: dict[str, Any] = json.load(f)
+                return config
+        except json.JSONDecodeError as e:
+            console.print(
+                f"[yellow]⚠ Warning: Could not parse existing config: {e}[/yellow]"
+            )
+            console.print("[yellow]Creating new configuration...[/yellow]")
+
+    # Return empty structure with mcpServers section
+    return {"mcpServers": {}}
+
+
+def save_auggie_config(config_path: Path, config: dict[str, Any]) -> None:
+    """Save Auggie configuration to file.
+
+    Args:
+        config_path: Path to Auggie settings file
+        config: Configuration to save
+
+    """
+    # Ensure directory exists
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write with 2-space indentation (JSON standard)
+    with open(config_path, "w") as f:
+        json.dump(config, f, indent=2)
+
+
+def create_auggie_server_config(
+    binary_path: str, project_config: dict[str, Any]
+) -> dict[str, Any]:
+    """Create Auggie MCP server configuration for mcp-ticketer.
+
+    Args:
+        binary_path: Path to mcp-ticketer binary
+        project_config: Project configuration from .mcp-ticketer/config.json
+
+    Returns:
+        Auggie MCP server configuration dict
+
+    """
+    # Get adapter configuration
+    adapter = project_config.get("default_adapter", "aitrackdown")
+    adapters_config = project_config.get("adapters", {})
+    adapter_config = adapters_config.get(adapter, {})
+
+    # Build environment variables
+    env_vars = {}
+
+    # Add adapter type
+    env_vars["MCP_TICKETER_ADAPTER"] = adapter
+
+    # Add adapter-specific environment variables
+    if adapter == "aitrackdown":
+        # Set base path for local adapter
+        base_path = adapter_config.get("base_path", ".aitrackdown")
+        # Use absolute path to home directory for global config
+        # Since Auggie is global, we can't rely on project-specific paths
+        env_vars["MCP_TICKETER_BASE_PATH"] = str(
+            Path.home() / ".mcp-ticketer" / base_path
+        )
+
+    elif adapter == "linear":
+        if "api_key" in adapter_config:
+            env_vars["LINEAR_API_KEY"] = adapter_config["api_key"]
+        if "team_id" in adapter_config:
+            env_vars["LINEAR_TEAM_ID"] = adapter_config["team_id"]
+
+    elif adapter == "github":
+        if "token" in adapter_config:
+            env_vars["GITHUB_TOKEN"] = adapter_config["token"]
+        if "owner" in adapter_config:
+            env_vars["GITHUB_OWNER"] = adapter_config["owner"]
+        if "repo" in adapter_config:
+            env_vars["GITHUB_REPO"] = adapter_config["repo"]
+
+    elif adapter == "jira":
+        if "api_token" in adapter_config:
+            env_vars["JIRA_API_TOKEN"] = adapter_config["api_token"]
+        if "email" in adapter_config:
+            env_vars["JIRA_EMAIL"] = adapter_config["email"]
+        if "server" in adapter_config:
+            env_vars["JIRA_SERVER"] = adapter_config["server"]
+        if "project_key" in adapter_config:
+            env_vars["JIRA_PROJECT_KEY"] = adapter_config["project_key"]
+
+    # Create server configuration (simpler than Gemini - no timeout/trust)
+    config = {
+        "command": binary_path,
+        "args": ["serve"],
+        "env": env_vars,
+    }
+
+    return config
+
+
+def configure_auggie_mcp(force: bool = False) -> None:
+    """Configure Auggie CLI to use mcp-ticketer.
+
+    IMPORTANT: Auggie CLI ONLY supports global configuration.
+    This will configure ~/.augment/settings.json for all projects.
+
+    Args:
+        force: Overwrite existing configuration
+
+    Raises:
+        FileNotFoundError: If binary or project config not found
+        ValueError: If configuration is invalid
+
+    """
+    # Step 1: Find mcp-ticketer binary
+    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/cyan]")
+    try:
+        binary_path = find_mcp_ticketer_binary()
+        console.print(f"[green]✓[/green] Found: {binary_path}")
+    except FileNotFoundError as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 2: Load project configuration
+    console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
+    try:
+        project_config = load_project_config()
+        adapter = project_config.get("default_adapter", "aitrackdown")
+        console.print(f"[green]✓[/green] Adapter: {adapter}")
+    except (FileNotFoundError, ValueError) as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 3: Find Auggie config location
+    console.print("\n[cyan]🔧 Configuring global Auggie CLI...[/cyan]")
+    console.print(
+        "[yellow]⚠ NOTE: Auggie only supports global configuration (affects all projects)[/yellow]"
+    )
+
+    auggie_config_path = find_auggie_config()
+    console.print(f"[dim]Config location: {auggie_config_path}[/dim]")
+
+    # Step 4: Load existing Auggie configuration
+    auggie_config = load_auggie_config(auggie_config_path)
+
+    # Step 5: Check if mcp-ticketer already configured
+    if "mcp-ticketer" in auggie_config.get("mcpServers", {}):
+        if not force:
+            console.print("[yellow]⚠ mcp-ticketer is already configured[/yellow]")
+            console.print("[dim]Use --force to overwrite existing configuration[/dim]")
+            return
+        else:
+            console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
+
+    # Step 6: Create mcp-ticketer server config
+    server_config = create_auggie_server_config(
+        binary_path=binary_path, project_config=project_config
+    )
+
+    # Step 7: Update Auggie configuration
+    if "mcpServers" not in auggie_config:
+        auggie_config["mcpServers"] = {}
+
+    auggie_config["mcpServers"]["mcp-ticketer"] = server_config
+
+    # Step 8: Save configuration
+    try:
+        save_auggie_config(auggie_config_path, auggie_config)
+        console.print("\n[green]✓ Successfully configured mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration saved to: {auggie_config_path}[/dim]")
+
+        # Print configuration details
+        console.print("\n[bold]Configuration Details:[/bold]")
+        console.print("  Server name: mcp-ticketer")
+        console.print(f"  Adapter: {adapter}")
+        console.print(f"  Binary: {binary_path}")
+        console.print("  Scope: Global (affects all projects)")
+        if "env" in server_config:
+            console.print(
+                f"  Environment variables: {list(server_config['env'].keys())}"
+            )
+
+        # Next steps
+        console.print("\n[bold cyan]Next Steps:[/bold cyan]")
+        console.print("1. Restart Auggie CLI for changes to take effect")
+        console.print("2. Run 'auggie' command in any directory")
+        console.print("3. mcp-ticketer tools will be available via MCP")
+        console.print(
+            "\n[yellow]⚠ Warning: This is a global configuration affecting all projects[/yellow]"
+        )
+        console.print(
+            "[dim]If you need project-specific configuration, use Claude or Gemini instead[/dim]"
+        )
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to save configuration:[/red] {e}")
+        raise

mcp_ticketer/cli/codex_configure.py

@@ -0,0 +1,257 @@
+"""Codex CLI configuration for mcp-ticketer integration.
+
+Codex CLI only supports global configuration at ~/.codex/config.toml.
+Unlike Claude Code and Gemini CLI, there is no project-level configuration support.
+"""
+
+import sys
+from pathlib import Path
+from typing import Any, Dict, Optional
+
+if sys.version_info >= (3, 11):
+    import tomllib
+else:
+    import tomli as tomllib
+
+import tomli_w
+from rich.console import Console
+
+from .mcp_configure import find_mcp_ticketer_binary, load_project_config
+
+console = Console()
+
+
+def find_codex_config() -> Path:
+    """Find Codex CLI configuration file location.
+
+    Codex CLI ONLY supports global configuration at ~/.codex/config.toml.
+    No project-level or user-scoped configuration is available.
+
+    Returns:
+        Path to Codex global config file at ~/.codex/config.toml
+
+    """
+    # Codex only supports global config (no project-level support)
+    config_path = Path.home() / ".codex" / "config.toml"
+    return config_path
+
+
+def load_codex_config(config_path: Path) -> Dict[str, Any]:
+    """Load existing Codex configuration or return empty structure.
+
+    Args:
+        config_path: Path to Codex config.toml file
+
+    Returns:
+        Codex configuration dict with mcp_servers section
+
+    """
+    if config_path.exists():
+        try:
+            with open(config_path, "rb") as f:
+                return tomllib.load(f)
+        except Exception as e:
+            console.print(
+                f"[yellow]⚠ Warning: Could not parse existing config: {e}[/yellow]"
+            )
+            console.print("[yellow]Creating new configuration...[/yellow]")
+
+    # Return empty structure with mcp_servers section
+    # NOTE: Use underscore mcp_servers, not camelCase mcpServers
+    return {"mcp_servers": {}}
+
+
+def save_codex_config(config_path: Path, config: Dict[str, Any]) -> None:
+    """Save Codex configuration to TOML file.
+
+    Args:
+        config_path: Path to Codex config.toml file
+        config: Configuration to save
+
+    """
+    # Ensure directory exists
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write TOML with proper formatting
+    with open(config_path, "wb") as f:
+        tomli_w.dump(config, f)
+
+
+def create_codex_server_config(
+    binary_path: str, project_config: dict, cwd: Optional[str] = None
+) -> Dict[str, Any]:
+    """Create Codex MCP server configuration for mcp-ticketer.
+
+    Args:
+        binary_path: Path to mcp-ticketer binary
+        project_config: Project configuration from .mcp-ticketer/config.json
+        cwd: Working directory for server (optional, not used for global config)
+
+    Returns:
+        Codex MCP server configuration dict
+
+    """
+    # Get adapter configuration
+    adapter = project_config.get("default_adapter", "aitrackdown")
+    adapters_config = project_config.get("adapters", {})
+    adapter_config = adapters_config.get(adapter, {})
+
+    # Build environment variables
+    env_vars: Dict[str, str] = {}
+
+    # Add PYTHONPATH if running from development environment
+    if cwd:
+        env_vars["PYTHONPATH"] = str(Path(cwd) / "src")
+
+    # Add adapter type
+    env_vars["MCP_TICKETER_ADAPTER"] = adapter
+
+    # Add adapter-specific environment variables
+    if adapter == "aitrackdown":
+        # Set base path for local adapter
+        base_path = adapter_config.get("base_path", ".aitrackdown")
+        if cwd:
+            # Use absolute path if cwd is provided
+            env_vars["MCP_TICKETER_BASE_PATH"] = str(Path(cwd) / base_path)
+        else:
+            env_vars["MCP_TICKETER_BASE_PATH"] = base_path
+
+    elif adapter == "linear":
+        if "api_key" in adapter_config:
+            env_vars["LINEAR_API_KEY"] = adapter_config["api_key"]
+        if "team_id" in adapter_config:
+            env_vars["LINEAR_TEAM_ID"] = adapter_config["team_id"]
+
+    elif adapter == "github":
+        if "token" in adapter_config:
+            env_vars["GITHUB_TOKEN"] = adapter_config["token"]
+        if "owner" in adapter_config:
+            env_vars["GITHUB_OWNER"] = adapter_config["owner"]
+        if "repo" in adapter_config:
+            env_vars["GITHUB_REPO"] = adapter_config["repo"]
+
+    elif adapter == "jira":
+        if "api_token" in adapter_config:
+            env_vars["JIRA_API_TOKEN"] = adapter_config["api_token"]
+        if "email" in adapter_config:
+            env_vars["JIRA_EMAIL"] = adapter_config["email"]
+        if "server" in adapter_config:
+            env_vars["JIRA_SERVER"] = adapter_config["server"]
+        if "project_key" in adapter_config:
+            env_vars["JIRA_PROJECT_KEY"] = adapter_config["project_key"]
+
+    # Create server configuration with Codex-specific structure
+    # NOTE: Codex uses nested dict structure for env vars
+    config: Dict[str, Any] = {
+        "command": binary_path,
+        "args": ["serve"],
+        "env": env_vars,
+    }
+
+    return config
+
+
+def configure_codex_mcp(force: bool = False) -> None:
+    """Configure Codex CLI to use mcp-ticketer.
+
+    IMPORTANT: Codex CLI ONLY supports global configuration at ~/.codex/config.toml.
+    There is no project-level or user-scoped configuration available.
+
+    After configuration, you must restart Codex CLI for changes to take effect.
+
+    Args:
+        force: Overwrite existing configuration
+
+    Raises:
+        FileNotFoundError: If binary or project config not found
+        ValueError: If configuration is invalid
+
+    """
+    # Step 1: Find mcp-ticketer binary
+    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/cyan]")
+    try:
+        binary_path = find_mcp_ticketer_binary()
+        console.print(f"[green]✓[/green] Found: {binary_path}")
+    except FileNotFoundError as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 2: Load project configuration
+    console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
+    try:
+        project_config = load_project_config()
+        adapter = project_config.get("default_adapter", "aitrackdown")
+        console.print(f"[green]✓[/green] Adapter: {adapter}")
+    except (FileNotFoundError, ValueError) as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 3: Find Codex config location (always global)
+    console.print("\n[cyan]🔧 Configuring Codex CLI (global-only)...[/cyan]")
+    console.print(
+        "[yellow]⚠ Note: Codex CLI only supports global configuration[/yellow]"
+    )
+
+    codex_config_path = find_codex_config()
+    console.print(f"[dim]Config location: {codex_config_path}[/dim]")
+
+    # Step 4: Load existing Codex configuration
+    codex_config = load_codex_config(codex_config_path)
+
+    # Step 5: Check if mcp-ticketer already configured
+    # NOTE: Use underscore mcp_servers, not camelCase
+    mcp_servers = codex_config.get("mcp_servers", {})
+    if "mcp-ticketer" in mcp_servers:
+        if not force:
+            console.print("[yellow]⚠ mcp-ticketer is already configured[/yellow]")
+            console.print("[dim]Use --force to overwrite existing configuration[/dim]")
+            return
+        else:
+            console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
+
+    # Step 6: Create mcp-ticketer server config
+    # For global config, include current working directory for context
+    cwd = str(Path.cwd())
+    server_config = create_codex_server_config(
+        binary_path=binary_path, project_config=project_config, cwd=cwd
+    )
+
+    # Step 7: Update Codex configuration
+    if "mcp_servers" not in codex_config:
+        codex_config["mcp_servers"] = {}
+
+    codex_config["mcp_servers"]["mcp-ticketer"] = server_config
+
+    # Step 8: Save configuration
+    try:
+        save_codex_config(codex_config_path, codex_config)
+        console.print("\n[green]✓ Successfully configured mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration saved to: {codex_config_path}[/dim]")
+
+        # Print configuration details
+        console.print("\n[bold]Configuration Details:[/bold]")
+        console.print("  Server name: mcp-ticketer")
+        console.print(f"  Adapter: {adapter}")
+        console.print(f"  Binary: {binary_path}")
+        console.print("  Scope: global (Codex only supports global config)")
+        console.print(f"  Working directory: {cwd}")
+        if "env" in server_config:
+            console.print(
+                f"  Environment variables: {list(server_config['env'].keys())}"
+            )
+
+        # Next steps
+        console.print("\n[bold cyan]Next Steps:[/bold cyan]")
+        console.print("1. [bold]Restart Codex CLI[/bold] (required for changes)")
+        console.print("2. Run 'codex' command from any directory")
+        console.print("3. mcp-ticketer tools will be available via MCP")
+        console.print(
+            "\n[yellow]⚠ Warning: This is a global configuration that affects all Codex sessions[/yellow]"
+        )
+        console.print(
+            "[yellow]   The configuration includes paths from your current project directory[/yellow]"
+        )
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to save configuration:[/red] {e}")
+        raise

mcp_ticketer/cli/gemini_configure.py

@@ -0,0 +1,261 @@
+"""Gemini CLI configuration for mcp-ticketer integration."""
+
+import json
+from pathlib import Path
+from typing import Literal, Optional
+
+from rich.console import Console
+
+from .mcp_configure import find_mcp_ticketer_binary, load_project_config
+
+console = Console()
+
+
+def find_gemini_config(scope: Literal["project", "user"] = "project") -> Path:
+    """Find or create Gemini CLI configuration file.
+
+    Args:
+        scope: Configuration scope - "project" for .gemini/settings.json
+               or "user" for ~/.gemini/settings.json
+
+    Returns:
+        Path to Gemini settings file
+
+    """
+    if scope == "user":
+        # User-level configuration
+        config_path = Path.home() / ".gemini" / "settings.json"
+    else:
+        # Project-level configuration
+        config_path = Path.cwd() / ".gemini" / "settings.json"
+
+    return config_path
+
+
+def load_gemini_config(config_path: Path) -> dict:
+    """Load existing Gemini configuration or return empty structure.
+
+    Args:
+        config_path: Path to Gemini settings file
+
+    Returns:
+        Gemini configuration dict
+
+    """
+    if config_path.exists():
+        try:
+            with open(config_path) as f:
+                return json.load(f)
+        except json.JSONDecodeError as e:
+            console.print(
+                f"[yellow]⚠ Warning: Could not parse existing config: {e}[/yellow]"
+            )
+            console.print("[yellow]Creating new configuration...[/yellow]")
+
+    # Return empty structure with mcpServers section
+    return {"mcpServers": {}}
+
+
+def save_gemini_config(config_path: Path, config: dict) -> None:
+    """Save Gemini configuration to file.
+
+    Args:
+        config_path: Path to Gemini settings file
+        config: Configuration to save
+
+    """
+    # Ensure directory exists
+    config_path.parent.mkdir(parents=True, exist_ok=True)
+
+    # Write with 2-space indentation (Gemini CLI standard)
+    with open(config_path, "w") as f:
+        json.dump(config, f, indent=2)
+
+
+def create_gemini_server_config(
+    binary_path: str, project_config: dict, cwd: Optional[str] = None
+) -> dict:
+    """Create Gemini MCP server configuration for mcp-ticketer.
+
+    Args:
+        binary_path: Path to mcp-ticketer binary
+        project_config: Project configuration from .mcp-ticketer/config.json
+        cwd: Working directory for server (optional)
+
+    Returns:
+        Gemini MCP server configuration dict
+
+    """
+    # Get adapter configuration
+    adapter = project_config.get("default_adapter", "aitrackdown")
+    adapters_config = project_config.get("adapters", {})
+    adapter_config = adapters_config.get(adapter, {})
+
+    # Build environment variables
+    env_vars = {}
+
+    # Add PYTHONPATH if running from development environment
+    if cwd:
+        env_vars["PYTHONPATH"] = str(Path(cwd) / "src")
+
+    # Add adapter type
+    env_vars["MCP_TICKETER_ADAPTER"] = adapter
+
+    # Add adapter-specific environment variables
+    if adapter == "aitrackdown":
+        # Set base path for local adapter
+        base_path = adapter_config.get("base_path", ".aitrackdown")
+        if cwd:
+            # Use absolute path if cwd is provided
+            env_vars["MCP_TICKETER_BASE_PATH"] = str(Path(cwd) / base_path)
+        else:
+            env_vars["MCP_TICKETER_BASE_PATH"] = base_path
+
+    elif adapter == "linear":
+        if "api_key" in adapter_config:
+            env_vars["LINEAR_API_KEY"] = adapter_config["api_key"]
+        if "team_id" in adapter_config:
+            env_vars["LINEAR_TEAM_ID"] = adapter_config["team_id"]
+
+    elif adapter == "github":
+        if "token" in adapter_config:
+            env_vars["GITHUB_TOKEN"] = adapter_config["token"]
+        if "owner" in adapter_config:
+            env_vars["GITHUB_OWNER"] = adapter_config["owner"]
+        if "repo" in adapter_config:
+            env_vars["GITHUB_REPO"] = adapter_config["repo"]
+
+    elif adapter == "jira":
+        if "api_token" in adapter_config:
+            env_vars["JIRA_API_TOKEN"] = adapter_config["api_token"]
+        if "email" in adapter_config:
+            env_vars["JIRA_EMAIL"] = adapter_config["email"]
+        if "server" in adapter_config:
+            env_vars["JIRA_SERVER"] = adapter_config["server"]
+        if "project_key" in adapter_config:
+            env_vars["JIRA_PROJECT_KEY"] = adapter_config["project_key"]
+
+    # Create server configuration with Gemini-specific options
+    config = {
+        "command": binary_path,
+        "args": ["serve"],
+        "env": env_vars,
+        "timeout": 15000,  # 15 seconds timeout
+        "trust": False,  # Don't trust by default (security)
+    }
+
+    return config
+
+
+def configure_gemini_mcp(
+    scope: Literal["project", "user"] = "project", force: bool = False
+) -> None:
+    """Configure Gemini CLI to use mcp-ticketer.
+
+    Args:
+        scope: Configuration scope - "project" or "user"
+        force: Overwrite existing configuration
+
+    Raises:
+        FileNotFoundError: If binary or project config not found
+        ValueError: If configuration is invalid
+
+    """
+    # Step 1: Find mcp-ticketer binary
+    console.print("[cyan]🔍 Finding mcp-ticketer binary...[/cyan]")
+    try:
+        binary_path = find_mcp_ticketer_binary()
+        console.print(f"[green]✓[/green] Found: {binary_path}")
+    except FileNotFoundError as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 2: Load project configuration
+    console.print("\n[cyan]📖 Reading project configuration...[/cyan]")
+    try:
+        project_config = load_project_config()
+        adapter = project_config.get("default_adapter", "aitrackdown")
+        console.print(f"[green]✓[/green] Adapter: {adapter}")
+    except (FileNotFoundError, ValueError) as e:
+        console.print(f"[red]✗[/red] {e}")
+        raise
+
+    # Step 3: Find Gemini config location
+    config_type = "user-level" if scope == "user" else "project-level"
+    console.print(f"\n[cyan]🔧 Configuring {config_type} Gemini CLI...[/cyan]")
+
+    gemini_config_path = find_gemini_config(scope)
+    console.print(f"[dim]Config location: {gemini_config_path}[/dim]")
+
+    # Step 4: Load existing Gemini configuration
+    gemini_config = load_gemini_config(gemini_config_path)
+
+    # Step 5: Check if mcp-ticketer already configured
+    if "mcp-ticketer" in gemini_config.get("mcpServers", {}):
+        if not force:
+            console.print("[yellow]⚠ mcp-ticketer is already configured[/yellow]")
+            console.print("[dim]Use --force to overwrite existing configuration[/dim]")
+            return
+        else:
+            console.print("[yellow]⚠ Overwriting existing configuration[/yellow]")
+
+    # Step 6: Create mcp-ticketer server config
+    cwd = str(Path.cwd()) if scope == "project" else None
+    server_config = create_gemini_server_config(
+        binary_path=binary_path, project_config=project_config, cwd=cwd
+    )
+
+    # Step 7: Update Gemini configuration
+    if "mcpServers" not in gemini_config:
+        gemini_config["mcpServers"] = {}
+
+    gemini_config["mcpServers"]["mcp-ticketer"] = server_config
+
+    # Step 8: Save configuration
+    try:
+        save_gemini_config(gemini_config_path, gemini_config)
+        console.print("\n[green]✓ Successfully configured mcp-ticketer[/green]")
+        console.print(f"[dim]Configuration saved to: {gemini_config_path}[/dim]")
+
+        # Print configuration details
+        console.print("\n[bold]Configuration Details:[/bold]")
+        console.print("  Server name: mcp-ticketer")
+        console.print(f"  Adapter: {adapter}")
+        console.print(f"  Binary: {binary_path}")
+        console.print(f"  Timeout: {server_config['timeout']}ms")
+        console.print(f"  Trust: {server_config['trust']}")
+        if cwd:
+            console.print(f"  Working directory: {cwd}")
+        if "env" in server_config:
+            console.print(
+                f"  Environment variables: {list(server_config['env'].keys())}"
+            )
+
+        # Next steps
+        console.print("\n[bold cyan]Next Steps:[/bold cyan]")
+        if scope == "user":
+            console.print("1. Gemini CLI will use this configuration globally")
+            console.print("2. Run 'gemini' command in any directory")
+        else:
+            console.print("1. Run 'gemini' command in this project directory")
+            console.print("2. Gemini CLI will detect project-level configuration")
+        console.print("3. mcp-ticketer tools will be available via MCP")
+
+        # Add .gemini to .gitignore for project-level config
+        if scope == "project":
+            gitignore_path = Path.cwd() / ".gitignore"
+            if gitignore_path.exists():
+                gitignore_content = gitignore_path.read_text()
+                if ".gemini" not in gitignore_content:
+                    with open(gitignore_path, "a") as f:
+                        f.write("\n# Gemini CLI\n.gemini/\n")
+                    console.print("\n[dim]✓ Added .gemini/ to .gitignore[/dim]")
+            else:
+                # Create .gitignore if it doesn't exist
+                with open(gitignore_path, "w") as f:
+                    f.write("# Gemini CLI\n.gemini/\n")
+                console.print("\n[dim]✓ Created .gitignore with .gemini/[/dim]")
+
+    except Exception as e:
+        console.print(f"\n[red]✗ Failed to save configuration:[/red] {e}")
+        raise

mcp_ticketer/cli/main.py

@@ -1118,6 +1118,13 @@ app.add_typer(queue_app, name="queue")
 # Add discover command to main app
 app.add_typer(discover_app, name="discover")
 
+# Create MCP configuration command group
+mcp_app = typer.Typer(
+    name="mcp",
+    help="Configure MCP integration for AI clients (Claude, Gemini, Codex, Auggie)",
+    add_completion=False,
+)
+
 
 @app.command()
 def check(queue_id: str = typer.Argument(..., help="Queue ID to check")):
@@ -1233,8 +1240,8 @@ def serve(
         sys.exit(1)
 
 
-@app.command()
-def mcp(
+@mcp_app.command(name="claude")
+def mcp_claude(
     global_config: bool = typer.Option(
         False,
         "--global",
@@ -1252,6 +1259,17 @@ def mcp(
 
     By default, configures project-level (.mcp/config.json).
     Use --global to configure Claude Desktop instead.
+
+    Examples:
+        # Configure for current project (default)
+        mcp-ticketer mcp claude
+
+        # Configure Claude Desktop globally
+        mcp-ticketer mcp claude --global
+
+        # Force overwrite existing configuration
+        mcp-ticketer mcp claude --force
+
     """
     from ..cli.mcp_configure import configure_claude_mcp
 
@@ -1262,6 +1280,121 @@ def mcp(
         raise typer.Exit(1)
 
 
+@mcp_app.command(name="gemini")
+def mcp_gemini(
+    scope: str = typer.Option(
+        "project",
+        "--scope",
+        "-s",
+        help="Configuration scope: 'project' (default) or 'user'",
+    ),
+    force: bool = typer.Option(
+        False, "--force", "-f", help="Overwrite existing configuration"
+    ),
+):
+    """Configure Gemini CLI to use mcp-ticketer MCP server.
+
+    Reads configuration from .mcp-ticketer/config.json and creates
+    Gemini CLI settings file with mcp-ticketer configuration.
+
+    By default, configures project-level (.gemini/settings.json).
+    Use --scope user to configure user-level (~/.gemini/settings.json).
+
+    Examples:
+        # Configure for current project (default)
+        mcp-ticketer mcp gemini
+
+        # Configure at user level
+        mcp-ticketer mcp gemini --scope user
+
+        # Force overwrite existing configuration
+        mcp-ticketer mcp gemini --force
+
+    """
+    from ..cli.gemini_configure import configure_gemini_mcp
+
+    # Validate scope parameter
+    if scope not in ["project", "user"]:
+        console.print(
+            f"[red]✗ Invalid scope:[/red] '{scope}'. Must be 'project' or 'user'"
+        )
+        raise typer.Exit(1)
+
+    try:
+        configure_gemini_mcp(scope=scope, force=force)  # type: ignore
+    except Exception as e:
+        console.print(f"[red]✗ Configuration failed:[/red] {e}")
+        raise typer.Exit(1)
+
+
+@mcp_app.command(name="codex")
+def mcp_codex(
+    force: bool = typer.Option(
+        False, "--force", "-f", help="Overwrite existing configuration"
+    ),
+):
+    """Configure Codex CLI to use mcp-ticketer MCP server.
+
+    Reads configuration from .mcp-ticketer/config.json and creates
+    Codex CLI config.toml with mcp-ticketer configuration.
+
+    IMPORTANT: Codex CLI ONLY supports global configuration at ~/.codex/config.toml.
+    There is no project-level configuration support. After configuration,
+    you must restart Codex CLI for changes to take effect.
+
+    Examples:
+        # Configure Codex CLI globally
+        mcp-ticketer mcp codex
+
+        # Force overwrite existing configuration
+        mcp-ticketer mcp codex --force
+
+    """
+    from ..cli.codex_configure import configure_codex_mcp
+
+    try:
+        configure_codex_mcp(force=force)
+    except Exception as e:
+        console.print(f"[red]✗ Configuration failed:[/red] {e}")
+        raise typer.Exit(1)
+
+
+@mcp_app.command(name="auggie")
+def mcp_auggie(
+    force: bool = typer.Option(
+        False, "--force", "-f", help="Overwrite existing configuration"
+    ),
+):
+    """Configure Auggie CLI to use mcp-ticketer MCP server.
+
+    Reads configuration from .mcp-ticketer/config.json and creates
+    Auggie CLI settings.json with mcp-ticketer configuration.
+
+    IMPORTANT: Auggie CLI ONLY supports global configuration at ~/.augment/settings.json.
+    There is no project-level configuration support. After configuration,
+    you must restart Auggie CLI for changes to take effect.
+
+    Examples:
+        # Configure Auggie CLI globally
+        mcp-ticketer mcp auggie
+
+        # Force overwrite existing configuration
+        mcp-ticketer mcp auggie --force
+
+    """
+    from ..cli.auggie_configure import configure_auggie_mcp
+
+    try:
+        configure_auggie_mcp(force=force)
+    except Exception as e:
+        console.print(f"[red]✗ Configuration failed:[/red] {e}")
+        raise typer.Exit(1)
+
+
+# Add MCP command group to main app (must be after all subcommands are defined)
+app.add_typer(mcp_app, name="mcp")
+
+
 def main():
     """Main entry point."""
     app()

mcp_ticketer/cli/migrate_config.py

@@ -8,11 +8,7 @@ from typing import Any
 from rich.console import Console
 from rich.prompt import Confirm
 
-from ..core.project_config import (
-    AdapterConfig,
-    ConfigResolver,
-    TicketerConfig,
-)
+from ..core.project_config import AdapterConfig, ConfigResolver, TicketerConfig
 
 console = Console()
 

mcp_ticketer/core/project_config.py

@@ -14,7 +14,10 @@ import os
 from dataclasses import asdict, dataclass, field
 from enum import Enum
 from pathlib import Path
-from typing import Any, Optional
+from typing import Any, Optional, TYPE_CHECKING
+
+if TYPE_CHECKING:
+    from .env_discovery import DiscoveryResult
 
 logger = logging.getLogger(__name__)
 

{mcp_ticketer-0.1.23.dist-info → mcp_ticketer-0.1.24.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mcp-ticketer
-Version: 0.1.23
+Version: 0.1.24
 Summary: Universal ticket management interface for AI agents with MCP support
 Author-email: MCP Ticketer Team <support@mcp-ticketer.io>
 Maintainer-email: MCP Ticketer Team <support@mcp-ticketer.io>
@@ -39,6 +39,8 @@ Requires-Dist: psutil>=5.9.0
 Requires-Dist: pydantic>=2.0
 Requires-Dist: python-dotenv>=1.0.0
 Requires-Dist: rich>=13.0.0
+Requires-Dist: tomli>=2.0.0; python_version < "3.11"
+Requires-Dist: tomli-w>=1.0.0
 Requires-Dist: typer>=0.9.0
 Requires-Dist: typing-extensions>=4.8.0
 Provides-Extra: all
@@ -129,6 +131,39 @@ pip install -e .
 - Python 3.9+
 - Virtual environment (recommended)
 
+## 🤖 Supported AI Clients
+
+MCP Ticketer integrates with multiple AI clients via the Model Context Protocol (MCP):
+
+| AI Client | Support | Config Type | Project-Level | Setup Command |
+|-----------|---------|-------------|---------------|---------------|
+| **Claude Code** | ✅ Native | JSON | ✅ Yes | `mcp-ticketer mcp claude` |
+| **Gemini CLI** | ✅ Full | JSON | ✅ Yes | `mcp-ticketer mcp gemini` |
+| **Codex CLI** | ✅ Full | TOML | ❌ Global only | `mcp-ticketer mcp codex` |
+| **Auggie** | ✅ Full | JSON | ❌ Global only | `mcp-ticketer mcp auggie` |
+
+### Quick MCP Setup
+
+```bash
+# Claude Code (recommended for project-specific workflows)
+mcp-ticketer init --adapter aitrackdown  # First, initialize an adapter
+mcp-ticketer mcp claude                   # Then configure MCP
+
+# Gemini CLI (Google's AI client)
+mcp-ticketer init --adapter aitrackdown
+mcp-ticketer mcp gemini --scope project
+
+# Codex CLI (global configuration, requires restart)
+mcp-ticketer init --adapter aitrackdown
+mcp-ticketer mcp codex
+
+# Auggie (simple global setup)
+mcp-ticketer init --adapter aitrackdown
+mcp-ticketer mcp auggie
+```
+
+**See [AI Client Integration Guide](docs/AI_CLIENT_INTEGRATION.md) for detailed setup instructions.**
+
 ## 🚀 Quick Start
 
 ### 1. Initialize Configuration
@@ -179,28 +214,43 @@ mcp-ticketer search "login bug" --state open
 
 ## 🤖 MCP Server Integration
 
-Run the MCP server for AI tool integration:
+MCP Ticketer provides seamless integration with AI clients through automatic configuration:
 
 ```bash
-mcp-ticketer-server
+# Run MCP server manually (for testing)
+mcp-ticketer serve
+
+# Or configure your AI client automatically (recommended)
+mcp-ticketer mcp claude  # For Claude Code
+mcp-ticketer mcp gemini  # For Gemini CLI
+mcp-ticketer mcp codex   # For Codex CLI
+mcp-ticketer mcp auggie  # For Auggie
 ```
 
-Configure your AI tool to use the MCP server:
+**Configuration is automatic** - the commands above will:
+1. Detect your mcp-ticketer installation
+2. Read your adapter configuration
+3. Generate the appropriate MCP server config
+4. Save it to the correct location for your AI client
+
+**Manual Configuration Example** (Claude Code):
 
 ```json
 {
   "mcpServers": {
-    "ticketer": {
-      "command": "mcp-ticketer-server",
-      "args": [],
+    "mcp-ticketer": {
+      "command": "/path/to/mcp-ticketer",
+      "args": ["serve"],
       "env": {
-        "MCP_TICKETER_ADAPTER": "jira"
+        "MCP_TICKETER_ADAPTER": "aitrackdown"
       }
     }
   }
 }
 ```
 
+**See [AI Client Integration Guide](docs/AI_CLIENT_INTEGRATION.md) for client-specific details.**
+
 ## 📚 Documentation
 
 Full documentation is available at [https://mcp-ticketerer.readthedocs.io](https://mcp-ticketerer.readthedocs.io)

{mcp_ticketer-0.1.23.dist-info → mcp_ticketer-0.1.24.dist-info}/RECORD

@@ -1,20 +1,23 @@
-mcp_ticketer/__init__.py,sha256=701DkKv4mtXRwbG6GjYhryb-aV8FVmq3RMF-qD_V3I8,497
-mcp_ticketer/__version__.py,sha256=L30Ek80zyhmFK6JeBpHlO8fe-4ZFzdJMtpN64wq35I4,1118
+mcp_ticketer/__init__.py,sha256=Xx4WaprO5PXhVPbYi1L6tBmwmJMkYS-lMyG4ieN6QP0,717
+mcp_ticketer/__version__.py,sha256=jSY7C2Ap-dss0EXCJjKddzTwqfO8125m1PW4jz1lXkU,1118
 mcp_ticketer/py.typed,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 mcp_ticketer/adapters/__init__.py,sha256=B5DFllWn23hkhmrLykNO5uMMSdcFuuPHXyLw_jyFzuE,358
 mcp_ticketer/adapters/aitrackdown.py,sha256=24h3UqMj5CltCl271kmqnDFOicCVp9w7yMTKK8s_dTA,16283
 mcp_ticketer/adapters/github.py,sha256=X0lEWBCfy-vztX2vauuVSYsOCa9_ezt9hGa5BsCQTu8,46663
 mcp_ticketer/adapters/hybrid.py,sha256=XFqHtWTLguE61ZGuZ156gxoz-wMr21AxLSADI1QVxcU,19025
-mcp_ticketer/adapters/jira.py,sha256=WcuqHtix2iHz0nMy2QhtQfHYhq4byb_ETfsusiCwocE,30574
-mcp_ticketer/adapters/linear.py,sha256=z39jQt74AVGmrV5HrJQdoRT-j58FoY21hbfAysrsdTc,71460
+mcp_ticketer/adapters/jira.py,sha256=W2pU-YxrSqgjm1gVt2eGc8We-G0MbRMSggQ2gWkThME,30602
+mcp_ticketer/adapters/linear.py,sha256=C6rHIxRaWvOBjX6ue2Nt-IPTcwFAwBkksstb7zV3YJw,71484
 mcp_ticketer/cache/__init__.py,sha256=Xcd-cKnt-Cx7jBzvfzUUUPaGkmyXFi5XUFWw3Z4b7d4,138
 mcp_ticketer/cache/memory.py,sha256=2yBqGi9i0SanlUhJoOC7nijWjoMa3_ntPe-V-AV-LfU,5042
 mcp_ticketer/cli/__init__.py,sha256=l9Q8iKmfGkTu0cssHBVqNZTsL4eAtFzOB25AED_0G6g,89
+mcp_ticketer/cli/auggie_configure.py,sha256=MXKzLtqe3K_UTQ2GacHAWbvf_B0779KL325smiAKE0Q,8212
+mcp_ticketer/cli/codex_configure.py,sha256=xDppHouT6_-cYXswyAggoPX5bSlRXMvCoM_x9PQ-42A,9086
 mcp_ticketer/cli/configure.py,sha256=BsA_pSHQMQS0t1bJO_wMM8LWsd5sWJDASjEPRHvwC18,16198
 mcp_ticketer/cli/discover.py,sha256=AF_qlQc1Oo0UkWayoF5pmRChS5J3fJjH6f2YZzd_k8w,13188
-mcp_ticketer/cli/main.py,sha256=njw45cl8FBtPpaQfmk4jn3D9Dc6UQo0qWxYfPPcmwZg,43115
+mcp_ticketer/cli/gemini_configure.py,sha256=ZNSA1lBW-itVToza-JxW95Po7daVXKiZAh7lp6pmXMU,9343
+mcp_ticketer/cli/main.py,sha256=AvWLtlKrAtgWv6cfXNRzESqJE7CRhHdKeDuNWOxj5GM,47111
 mcp_ticketer/cli/mcp_configure.py,sha256=RzV50UjXgOmvMp-9S0zS39psuvjffVByaMrqrUaAGAM,9594
-mcp_ticketer/cli/migrate_config.py,sha256=E-uD9_GTWQzfdiBweFYtCKyXOYtIaRHv7QuyVjV-rbI,5973
+mcp_ticketer/cli/migrate_config.py,sha256=MYsr_C5ZxsGg0P13etWTWNrJ_lc6ElRCkzfQADYr3DM,5956
 mcp_ticketer/cli/queue_commands.py,sha256=mm-3H6jmkUGJDyU_E46o9iRpek8tvFCm77F19OtHiZI,7884
 mcp_ticketer/cli/utils.py,sha256=2ptUrp2ELZsox0kSxAI5DFrHonOU999qh4MxbLv6VBQ,21155
 mcp_ticketer/core/__init__.py,sha256=eXovsaJymQRP2AwOBuOy6mFtI3I68D7gGenZ5V-IMqo,349
@@ -24,7 +27,7 @@ mcp_ticketer/core/env_discovery.py,sha256=wKp2Pi5vQMGOTrM1690IBv_eoABly-pD8ah7n1
 mcp_ticketer/core/http_client.py,sha256=s5ikMiwEJ8TJjNn73wu3gv3OdAtyBEpAqPnSroRMW2k,13971
 mcp_ticketer/core/mappers.py,sha256=1aG1jFsHTCwmGRVgOlXW-VOSTGzc86gv7qjDfiR1ups,17462
 mcp_ticketer/core/models.py,sha256=DRuJoYbjp9fcPV9GwQfhVcNUB0XmwQB3vuqW8hQWZ_k,6491
-mcp_ticketer/core/project_config.py,sha256=BeBkeCaQC0kZmpIhkdsqOL1zHBeDmkaRbcVUwAk8B0s,23265
+mcp_ticketer/core/project_config.py,sha256=yYxlgxjcEPeOwx-b-SXFpe0k9pW9xzBRAK72PsItG-o,23346
 mcp_ticketer/core/registry.py,sha256=ShYLDPE62KFJpB0kj_zFyQzRxSH3LkQEEuo1jaakb1k,3483
 mcp_ticketer/mcp/__init__.py,sha256=Y05eTzsPk0wH8yKNIM-ekpGjgSDO0bQr0EME-vOP4GE,123
 mcp_ticketer/mcp/server.py,sha256=U0bkHYe_DGa7wNPtuawsA8i_llHmpADgtq-OkYMjoBo,37041
@@ -34,9 +37,9 @@ mcp_ticketer/queue/manager.py,sha256=qqUqq_JtH8jfg-MDfc-UIgFaa7gYsA1eBaR2KsCw48c
 mcp_ticketer/queue/queue.py,sha256=zD7SRDP7zfGm4gokqzgL0CLuPUPxbBNmddsOqLMCbjQ,13162
 mcp_ticketer/queue/run_worker.py,sha256=_IBezjvhbJJ7gn0evTBIMbSPjvfFZwxEdT-1DLo_bRk,799
 mcp_ticketer/queue/worker.py,sha256=2wusez3Wxmun6qAmup3WsGjBD-vNgtLwxygYviXdECQ,14634
-mcp_ticketer-0.1.23.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
-mcp_ticketer-0.1.23.dist-info/METADATA,sha256=YrPCs8xszAbjFsMBB2CO_7vU6gVAMDUimqDiumqV3uk,11211
-mcp_ticketer-0.1.23.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-mcp_ticketer-0.1.23.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
-mcp_ticketer-0.1.23.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
-mcp_ticketer-0.1.23.dist-info/RECORD,,
+mcp_ticketer-0.1.24.dist-info/licenses/LICENSE,sha256=KOVrunjtILSzY-2N8Lqa3-Q8dMaZIG4LrlLTr9UqL08,1073
+mcp_ticketer-0.1.24.dist-info/METADATA,sha256=wpkFwzRgF21v3TfGDLmF0ZCJbFwCXYi1Ft6Ikh1-Bu8,13191
+mcp_ticketer-0.1.24.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+mcp_ticketer-0.1.24.dist-info/entry_points.txt,sha256=o1IxVhnHnBNG7FZzbFq-Whcs1Djbofs0qMjiUYBLx2s,60
+mcp_ticketer-0.1.24.dist-info/top_level.txt,sha256=WnAG4SOT1Vm9tIwl70AbGG_nA217YyV3aWFhxLH2rxw,13
+mcp_ticketer-0.1.24.dist-info/RECORD,,