gobby 0.2.9__py3-none-any.whl → 0.2.11__py3-none-any.whl

gobby/cli/install.py

@@ -3,6 +3,7 @@ Installation commands for hooks.
 """
 
 import logging
+import os
 import shutil
 import sys
 from pathlib import Path
@@ -15,12 +16,18 @@ from .installers import (
     install_antigravity,
     install_claude,
     install_codex_notify,
+    install_copilot,
+    install_cursor,
     install_default_mcp_servers,
     install_gemini,
     install_git_hooks,
+    install_windsurf,
     uninstall_claude,
     uninstall_codex_notify,
+    uninstall_copilot,
+    uninstall_cursor,
     uninstall_gemini,
+    uninstall_windsurf,
 )
 from .utils import get_install_dir
 
@@ -75,6 +82,37 @@ def _is_codex_cli_installed() -> bool:
     return shutil.which("codex") is not None
 
 
+def _is_cursor_installed() -> bool:
+    """Check if Cursor is installed."""
+    # Cursor is an IDE, check for common install locations
+    if sys.platform == "darwin":
+        return Path("/Applications/Cursor.app").exists()
+    elif sys.platform == "win32":
+        return Path(os.environ.get("LOCALAPPDATA", ""), "Programs", "cursor").exists()
+    else:
+        # Linux - check common locations
+        return (Path.home() / ".local" / "share" / "cursor").exists() or shutil.which(
+            "cursor"
+        ) is not None
+
+
+def _is_windsurf_installed() -> bool:
+    """Check if Windsurf (Codeium) is installed."""
+    # Windsurf is an IDE
+    if sys.platform == "darwin":
+        return Path("/Applications/Windsurf.app").exists()
+    elif sys.platform == "win32":
+        return Path(os.environ.get("LOCALAPPDATA", ""), "Programs", "windsurf").exists()
+    else:
+        return shutil.which("windsurf") is not None
+
+
+def _is_copilot_cli_installed() -> bool:
+    """Check if GitHub Copilot CLI is installed."""
+    # Check for gh copilot extension or standalone CLI
+    return shutil.which("gh") is not None or shutil.which("github-copilot-cli") is not None
+
+
 @click.command("install")
 @click.option(
     "--claude",
@@ -94,6 +132,24 @@ def _is_codex_cli_installed() -> bool:
     is_flag=True,
     help="Configure Codex notify integration (interactive Codex)",
 )
+@click.option(
+    "--cursor",
+    "cursor_flag",
+    is_flag=True,
+    help="Install Cursor hooks",
+)
+@click.option(
+    "--windsurf",
+    "windsurf_flag",
+    is_flag=True,
+    help="Install Windsurf (Cascade) hooks",
+)
+@click.option(
+    "--copilot",
+    "copilot_flag",
+    is_flag=True,
+    help="Install GitHub Copilot CLI hooks",
+)
 @click.option(
     "--hooks",
     "--git-hooks",
@@ -118,6 +174,9 @@ def install(
     claude_flag: bool,
     gemini_flag: bool,
     codex_flag: bool,
+    cursor_flag: bool,
+    windsurf_flag: bool,
+    copilot_flag: bool,
     hooks_flag: bool,
     all_flag: bool,
     antigravity_flag: bool,
@@ -143,6 +202,9 @@ def install(
         not claude_flag
         and not gemini_flag
         and not codex_flag
+        and not cursor_flag
+        and not windsurf_flag
+        and not copilot_flag
         and not hooks_flag
         and not all_flag
         and not antigravity_flag
@@ -162,6 +224,12 @@ def install(
             clis_to_install.append("gemini")
         if codex_detected:
             clis_to_install.append("codex")
+        if _is_cursor_installed():
+            clis_to_install.append("cursor")
+        if _is_windsurf_installed():
+            clis_to_install.append("windsurf")
+        if _is_copilot_cli_installed():
+            clis_to_install.append("copilot")
 
         # Check for git
         if (project_path / ".git").exists():
@@ -174,8 +242,11 @@ def install(
             click.echo("  - Claude Code: npm install -g @anthropic-ai/claude-code")
             click.echo("  - Gemini CLI:  npm install -g @google/gemini-cli")
             click.echo("  - Codex CLI:   npm install -g @openai/codex")
+            click.echo("  - Cursor:      https://cursor.com")
+            click.echo("  - Windsurf:    https://codeium.com/windsurf")
+            click.echo("  - Copilot CLI: gh extension install github/gh-copilot")
             click.echo(
-                "\nYou can still install manually with --claude, --gemini, or --codex flags."
+                "\nYou can still install manually with --claude, --gemini, --codex, --cursor, --windsurf, or --copilot flags."
             )
             sys.exit(1)
     else:
@@ -185,6 +256,12 @@ def install(
             clis_to_install.append("gemini")
         if codex_flag:
             clis_to_install.append("codex")
+        if cursor_flag:
+            clis_to_install.append("cursor")
+        if windsurf_flag:
+            clis_to_install.append("windsurf")
+        if copilot_flag:
+            clis_to_install.append("copilot")
         if antigravity_flag:
             clis_to_install.append("antigravity")
 
@@ -346,6 +423,66 @@ def install(
                 click.echo(f"Failed: {result['error']}", err=True)
         click.echo("")
 
+    # Install Cursor hooks
+    if "cursor" in clis_to_install:
+        click.echo("-" * 40)
+        click.echo("Cursor")
+        click.echo("-" * 40)
+
+        result = install_cursor(project_path)
+        results["cursor"] = result
+
+        if result["success"]:
+            click.echo(f"Installed {len(result['hooks_installed'])} hooks")
+            for hook in result["hooks_installed"]:
+                click.echo(f"  - {hook}")
+            if result.get("workflows_installed"):
+                click.echo(f"Installed {len(result['workflows_installed'])} workflows")
+            click.echo(f"Configuration: {project_path / '.cursor' / 'hooks.json'}")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
+    # Install Windsurf hooks
+    if "windsurf" in clis_to_install:
+        click.echo("-" * 40)
+        click.echo("Windsurf (Cascade)")
+        click.echo("-" * 40)
+
+        result = install_windsurf(project_path)
+        results["windsurf"] = result
+
+        if result["success"]:
+            click.echo(f"Installed {len(result['hooks_installed'])} hooks")
+            for hook in result["hooks_installed"]:
+                click.echo(f"  - {hook}")
+            if result.get("workflows_installed"):
+                click.echo(f"Installed {len(result['workflows_installed'])} workflows")
+            click.echo(f"Configuration: {project_path / '.windsurf' / 'hooks.json'}")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
+    # Install Copilot CLI hooks
+    if "copilot" in clis_to_install:
+        click.echo("-" * 40)
+        click.echo("GitHub Copilot CLI")
+        click.echo("-" * 40)
+
+        result = install_copilot(project_path)
+        results["copilot"] = result
+
+        if result["success"]:
+            click.echo(f"Installed {len(result['hooks_installed'])} hooks")
+            for hook in result["hooks_installed"]:
+                click.echo(f"  - {hook}")
+            if result.get("workflows_installed"):
+                click.echo(f"Installed {len(result['workflows_installed'])} workflows")
+            click.echo(f"Configuration: {project_path / '.copilot' / 'hooks.json'}")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
     # Install Git Hooks
     if hooks_flag:
         click.echo("-" * 40)
@@ -467,6 +604,24 @@ def install(
     is_flag=True,
     help="Uninstall Codex notify integration",
 )
+@click.option(
+    "--cursor",
+    "cursor_flag",
+    is_flag=True,
+    help="Uninstall Cursor hooks",
+)
+@click.option(
+    "--windsurf",
+    "windsurf_flag",
+    is_flag=True,
+    help="Uninstall Windsurf hooks",
+)
+@click.option(
+    "--copilot",
+    "copilot_flag",
+    is_flag=True,
+    help="Uninstall Copilot CLI hooks",
+)
 @click.option(
     "--all",
     "all_flag",
@@ -475,11 +630,19 @@ def install(
     help="Uninstall hooks from all CLIs (default behavior when no flags specified)",
 )
 @click.confirmation_option(prompt="Are you sure you want to uninstall Gobby hooks?")
-def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag: bool) -> None:
+def uninstall(
+    claude_flag: bool,
+    gemini_flag: bool,
+    codex_flag: bool,
+    cursor_flag: bool,
+    windsurf_flag: bool,
+    copilot_flag: bool,
+    all_flag: bool,
+) -> None:
     """Uninstall Gobby hooks from AI coding CLIs.
 
     By default (no flags), uninstalls from all CLIs that have hooks installed.
-    Use --claude, --gemini, or --codex to uninstall only from specific CLIs.
+    Use --claude, --gemini, --codex, --cursor, --windsurf, or --copilot to uninstall only from specific CLIs.
 
     Uninstalls from project-level directories in current working directory.
     """
@@ -487,7 +650,15 @@ def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag:
 
     # Determine which CLIs to uninstall
     # If no flags specified, act like --all
-    if not claude_flag and not gemini_flag and not codex_flag and not all_flag:
+    if (
+        not claude_flag
+        and not gemini_flag
+        and not codex_flag
+        and not cursor_flag
+        and not windsurf_flag
+        and not copilot_flag
+        and not all_flag
+    ):
         all_flag = True
 
     # Build list of CLIs to uninstall
@@ -498,6 +669,9 @@ def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag:
         claude_settings = project_path / ".claude" / "settings.json"
         gemini_settings = project_path / ".gemini" / "settings.json"
         codex_notify = Path.home() / ".gobby" / "hooks" / "codex" / "hook_dispatcher.py"
+        cursor_hooks = project_path / ".cursor" / "hooks.json"
+        windsurf_hooks = project_path / ".windsurf" / "hooks.json"
+        copilot_hooks = project_path / ".copilot" / "hooks.json"
 
         if claude_settings.exists():
             clis_to_uninstall.append("claude")
@@ -505,11 +679,20 @@ def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag:
             clis_to_uninstall.append("gemini")
         if codex_notify.exists():
             clis_to_uninstall.append("codex")
+        if cursor_hooks.exists():
+            clis_to_uninstall.append("cursor")
+        if windsurf_hooks.exists():
+            clis_to_uninstall.append("windsurf")
+        if copilot_hooks.exists():
+            clis_to_uninstall.append("copilot")
 
         if not clis_to_uninstall:
             click.echo("No Gobby hooks found to uninstall.")
             click.echo(f"\nChecked: {project_path / '.claude'}")
             click.echo(f"         {project_path / '.gemini'}")
+            click.echo(f"         {project_path / '.cursor'}")
+            click.echo(f"         {project_path / '.windsurf'}")
+            click.echo(f"         {project_path / '.copilot'}")
             click.echo(f"         {codex_notify}")
             sys.exit(0)
     else:
@@ -519,6 +702,12 @@ def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag:
             clis_to_uninstall.append("gemini")
         if codex_flag:
             clis_to_uninstall.append("codex")
+        if cursor_flag:
+            clis_to_uninstall.append("cursor")
+        if windsurf_flag:
+            clis_to_uninstall.append("windsurf")
+        if copilot_flag:
+            clis_to_uninstall.append("copilot")
 
     click.echo("=" * 60)
     click.echo("  Gobby Hooks Uninstallation")
@@ -597,6 +786,72 @@ def uninstall(claude_flag: bool, gemini_flag: bool, codex_flag: bool, all_flag:
             click.echo(f"Failed: {result['error']}", err=True)
         click.echo("")
 
+    # Uninstall Cursor hooks
+    if "cursor" in clis_to_uninstall:
+        click.echo("-" * 40)
+        click.echo("Cursor")
+        click.echo("-" * 40)
+
+        result = uninstall_cursor(project_path)
+        results["cursor"] = result
+
+        if result["success"]:
+            if result["hooks_removed"]:
+                click.echo(f"Removed {len(result['hooks_removed'])} hooks from hooks.json")
+                for hook in result["hooks_removed"]:
+                    click.echo(f"  - {hook}")
+            if result["files_removed"]:
+                click.echo(f"Removed {len(result['files_removed'])} files")
+            if not result["hooks_removed"] and not result["files_removed"]:
+                click.echo("  (no hooks found to remove)")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
+    # Uninstall Windsurf hooks
+    if "windsurf" in clis_to_uninstall:
+        click.echo("-" * 40)
+        click.echo("Windsurf")
+        click.echo("-" * 40)
+
+        result = uninstall_windsurf(project_path)
+        results["windsurf"] = result
+
+        if result["success"]:
+            if result["hooks_removed"]:
+                click.echo(f"Removed {len(result['hooks_removed'])} hooks from hooks.json")
+                for hook in result["hooks_removed"]:
+                    click.echo(f"  - {hook}")
+            if result["files_removed"]:
+                click.echo(f"Removed {len(result['files_removed'])} files")
+            if not result["hooks_removed"] and not result["files_removed"]:
+                click.echo("  (no hooks found to remove)")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
+    # Uninstall Copilot hooks
+    if "copilot" in clis_to_uninstall:
+        click.echo("-" * 40)
+        click.echo("Copilot CLI")
+        click.echo("-" * 40)
+
+        result = uninstall_copilot(project_path)
+        results["copilot"] = result
+
+        if result["success"]:
+            if result["hooks_removed"]:
+                click.echo(f"Removed {len(result['hooks_removed'])} hooks from hooks.json")
+                for hook in result["hooks_removed"]:
+                    click.echo(f"  - {hook}")
+            if result["files_removed"]:
+                click.echo(f"Removed {len(result['files_removed'])} files")
+            if not result["hooks_removed"] and not result["files_removed"]:
+                click.echo("  (no hooks found to remove)")
+        else:
+            click.echo(f"Failed: {result['error']}", err=True)
+        click.echo("")
+
     # Summary
     click.echo("=" * 60)
     click.echo("  Summary")

gobby/cli/installers/__init__.py

@@ -8,6 +8,8 @@ using the strangler fig pattern for incremental migration.
 from .antigravity import install_antigravity
 from .claude import install_claude, uninstall_claude
 from .codex import install_codex_notify, uninstall_codex_notify
+from .copilot import install_copilot, uninstall_copilot
+from .cursor import install_cursor, uninstall_cursor
 from .gemini import install_gemini, uninstall_gemini
 from .git_hooks import install_git_hooks
 from .shared import (
@@ -15,6 +17,7 @@ from .shared import (
     install_default_mcp_servers,
     install_shared_content,
 )
+from .windsurf import install_windsurf, uninstall_windsurf
 
 __all__ = [
     # Shared
@@ -30,6 +33,15 @@ __all__ = [
     # Codex
     "install_codex_notify",
     "uninstall_codex_notify",
+    # Cursor
+    "install_cursor",
+    "uninstall_cursor",
+    # Windsurf
+    "install_windsurf",
+    "uninstall_windsurf",
+    # Copilot
+    "install_copilot",
+    "uninstall_copilot",
     # Git Hooks
     "install_git_hooks",
     # Antigravity

gobby/cli/installers/copilot.py

@@ -0,0 +1,242 @@
+"""
+GitHub Copilot CLI installation for Gobby hooks.
+
+This module handles installing and uninstalling Gobby hooks for Copilot CLI.
+"""
+
+import json
+import logging
+import os
+import tempfile
+import time
+from pathlib import Path
+from shutil import copy2
+from typing import Any
+
+from gobby.cli.utils import get_install_dir
+
+from .shared import install_shared_content
+
+logger = logging.getLogger(__name__)
+
+
+def install_copilot(project_path: Path) -> dict[str, Any]:
+    """Install Gobby integration for Copilot CLI (hooks, workflows).
+
+    Args:
+        project_path: Path to the project root
+
+    Returns:
+        Dict with installation results including success status and installed items
+    """
+    hooks_installed: list[str] = []
+    result: dict[str, Any] = {
+        "success": False,
+        "hooks_installed": hooks_installed,
+        "workflows_installed": [],
+        "error": None,
+    }
+
+    copilot_path = project_path / ".copilot"
+    hooks_file = copilot_path / "hooks.json"
+
+    # Ensure .copilot subdirectories exist
+    copilot_path.mkdir(parents=True, exist_ok=True)
+    hooks_dir = copilot_path / "hooks"
+    hooks_dir.mkdir(parents=True, exist_ok=True)
+
+    # Get source files
+    install_dir = get_install_dir()
+    copilot_install_dir = install_dir / "copilot"
+    install_hooks_dir = copilot_install_dir / "hooks"
+
+    # Hook files to copy
+    hook_files = {
+        "hook_dispatcher.py": True,  # Make executable
+    }
+
+    source_hooks_template = copilot_install_dir / "hooks-template.json"
+
+    # Verify all source files exist
+    missing_files = []
+    for filename in hook_files.keys():
+        source_file = install_hooks_dir / filename
+        if not source_file.exists():
+            missing_files.append(str(source_file))
+
+    if not source_hooks_template.exists():
+        missing_files.append(str(source_hooks_template))
+
+    if missing_files:
+        result["error"] = f"Missing source files: {missing_files}"
+        return result
+
+    # Copy hook files
+    try:
+        for filename, make_executable in hook_files.items():
+            source_file = install_hooks_dir / filename
+            target_file = hooks_dir / filename
+
+            if target_file.exists():
+                target_file.unlink()
+
+            copy2(source_file, target_file)
+            if make_executable:
+                target_file.chmod(0o755)
+    except OSError as e:
+        logger.error(f"Failed to copy hook files: {e}")
+        result["error"] = f"Failed to copy hook files: {e}"
+        return result
+
+    # Install shared content (workflows) to .gobby/
+    try:
+        gobby_path = project_path / ".gobby"
+        shared = install_shared_content(gobby_path, project_path)
+        result["workflows_installed"] = shared.get("workflows", [])
+    except Exception as e:
+        logger.warning(f"Failed to install shared content: {e}")
+        # Non-fatal - continue with hooks installation
+
+    # Backup existing hooks.json if it exists
+    backup_file = None
+    if hooks_file.exists():
+        timestamp = int(time.time())
+        backup_file = copilot_path / f"hooks.json.{timestamp}.backup"
+        try:
+            copy2(hooks_file, backup_file)
+        except OSError as e:
+            logger.error(f"Failed to create backup of hooks.json: {e}")
+            result["error"] = f"Failed to create backup: {e}"
+            return result
+
+    # Load existing hooks or create empty
+    existing_hooks: dict[str, Any] = {"hooks": {}}
+    if hooks_file.exists():
+        try:
+            with open(hooks_file) as f:
+                existing_hooks = json.load(f)
+        except json.JSONDecodeError as e:
+            logger.warning(f"Failed to parse hooks.json, starting fresh: {e}")
+        except OSError as e:
+            logger.error(f"Failed to read hooks.json: {e}")
+            result["error"] = f"Failed to read hooks.json: {e}"
+            return result
+
+    # Ensure structure
+    if "hooks" not in existing_hooks:
+        existing_hooks["hooks"] = {}
+
+    # Load Gobby hooks from template
+    try:
+        with open(source_hooks_template) as f:
+            gobby_hooks_str = f.read()
+    except OSError as e:
+        logger.error(f"Failed to read hooks template: {e}")
+        result["error"] = f"Failed to read hooks template: {e}"
+        return result
+
+    # Replace $PROJECT_PATH with absolute project path
+    abs_project_path = str(project_path.resolve())
+    gobby_hooks_str = gobby_hooks_str.replace("$PROJECT_PATH", abs_project_path)
+
+    try:
+        gobby_hooks = json.loads(gobby_hooks_str)
+    except json.JSONDecodeError as e:
+        logger.error(f"Failed to parse hooks template: {e}")
+        result["error"] = f"Failed to parse hooks template: {e}"
+        return result
+
+    # Merge Gobby hooks
+    new_hooks = gobby_hooks.get("hooks", {})
+    for hook_type, hook_config in new_hooks.items():
+        existing_hooks["hooks"][hook_type] = hook_config
+        hooks_installed.append(hook_type)
+
+    # Write merged hooks back using atomic write
+    try:
+        fd, temp_path = tempfile.mkstemp(dir=str(copilot_path), suffix=".tmp", prefix="hooks_")
+        try:
+            with os.fdopen(fd, "w") as f:
+                json.dump(existing_hooks, f, indent=2)
+                f.flush()
+                os.fsync(f.fileno())
+            # Atomic replace
+            os.replace(temp_path, hooks_file)
+        except Exception:
+            if os.path.exists(temp_path):
+                os.unlink(temp_path)
+            raise
+    except OSError as e:
+        logger.error(f"Failed to write hooks.json: {e}")
+        if backup_file and backup_file.exists():
+            try:
+                copy2(backup_file, hooks_file)
+                logger.info("Restored hooks.json from backup after write failure")
+            except OSError as restore_error:
+                logger.error(f"Failed to restore from backup: {restore_error}")
+        result["error"] = f"Failed to write hooks.json: {e}"
+        return result
+
+    result["success"] = True
+    return result
+
+
+def uninstall_copilot(project_path: Path) -> dict[str, Any]:
+    """Uninstall Gobby integration from Copilot CLI.
+
+    Args:
+        project_path: Path to the project root
+
+    Returns:
+        Dict with uninstallation results
+    """
+    result: dict[str, Any] = {
+        "success": False,
+        "hooks_removed": [],
+        "files_removed": [],
+        "error": None,
+    }
+
+    copilot_path = project_path / ".copilot"
+    hooks_file = copilot_path / "hooks.json"
+    hooks_dir = copilot_path / "hooks"
+
+    # Remove hook dispatcher
+    dispatcher = hooks_dir / "hook_dispatcher.py"
+    if dispatcher.exists():
+        try:
+            dispatcher.unlink()
+            result["files_removed"].append(str(dispatcher))
+        except OSError as e:
+            logger.warning(f"Failed to remove {dispatcher}: {e}")
+
+    # Remove hooks from hooks.json
+    if hooks_file.exists():
+        try:
+            with open(hooks_file) as f:
+                hooks_config = json.load(f)
+
+            # Remove all Gobby hooks (those that reference hook_dispatcher.py)
+            if "hooks" in hooks_config:
+                hooks_to_remove = []
+                for hook_type, hook_list in hooks_config["hooks"].items():
+                    if isinstance(hook_list, list):
+                        for hook in hook_list:
+                            cmd = hook.get("command", "")
+                            if "hook_dispatcher.py" in cmd:
+                                hooks_to_remove.append(hook_type)
+                                break
+
+                for hook_type in hooks_to_remove:
+                    del hooks_config["hooks"][hook_type]
+                    result["hooks_removed"].append(hook_type)
+
+                # Write back
+                with open(hooks_file, "w") as f:
+                    json.dump(hooks_config, f, indent=2)
+
+        except (json.JSONDecodeError, OSError) as e:
+            logger.warning(f"Failed to update hooks.json: {e}")
+
+    result["success"] = True
+    return result