mtrx-cli 0.1.13 → 0.1.14

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mtrx-cli",
-  "version": "0.1.13",
+  "version": "0.1.14",
   "description": "MATRX CLI for routing Codex, Claude, and Cursor through Matrx",
   "homepage": "https://mtrx.so",
   "repository": {
@@ -28,6 +28,7 @@
     "src/matrx/cli/cursor_ca.py",
     "src/matrx/cli/cursor_config.py",
     "src/matrx/cli/cursor_daemon.py",
+    "src/matrx/cli/cursor_launcher.py",
     "src/matrx/cli/cursor_proxy.py",
     "src/matrx/cli/cursor_service.py",
     "src/matrx/cli/launcher.py",

package/src/matrx/__init__.py

@@ -1 +1 @@
-__version__ = "0.1.13"
+__version__ = "0.1.14"

package/src/matrx/cli/cursor_launcher.py

@@ -0,0 +1,106 @@
+"""
+Cross-platform launcher for Cursor IDE with proxy environment variables.
+
+Cursor must be started with HTTP_PROXY, HTTPS_PROXY, and NODE_EXTRA_CA_CERTS
+for the MITM proxy to work. Launching from Dock/Spotlight does not pass
+these env vars; this module finds the Cursor executable and launches it
+with the correct environment on any platform.
+"""
+
+from __future__ import annotations
+
+import logging
+import os
+import platform
+import shutil
+import subprocess
+from pathlib import Path
+
+logger = logging.getLogger(__name__)
+
+
+def _cursor_executable_darwin() -> str | None:
+    """macOS: /Applications/Cursor.app/Contents/MacOS/Cursor."""
+    app = Path("/Applications/Cursor.app")
+    exe = app / "Contents" / "MacOS" / "Cursor"
+    if exe.exists():
+        return str(exe)
+    return None
+
+
+def _cursor_executable_linux() -> str | None:
+    """Linux: cursor in PATH or common install locations."""
+    cursor = shutil.which("cursor")
+    if cursor:
+        return cursor
+    for path in (
+        Path.home() / ".local" / "share" / "cursor" / "bin" / "cursor",
+        Path.home() / ".local" / "bin" / "cursor",
+    ):
+        if path.exists():
+            return str(path)
+    return None
+
+
+def _cursor_executable_windows() -> str | None:
+    """Windows: Cursor.exe in Local AppData."""
+    local = os.environ.get("LOCALAPPDATA", "")
+    if local:
+        for parts in (("Programs", "cursor", "Cursor.exe"), ("Cursor", "Cursor.exe")):
+            exe = Path(local) / Path(*parts)
+            if exe.exists():
+                return str(exe)
+        alt = Path(local) / "cursor" / "Cursor.exe"
+        if alt.exists():
+            return str(alt)
+    return None
+
+
+def find_cursor_executable() -> str | None:
+    """Return the path to the Cursor executable for the current platform."""
+    system = platform.system()
+    if system == "Darwin":
+        return _cursor_executable_darwin()
+    if system == "Linux":
+        return _cursor_executable_linux()
+    if system == "Windows":
+        return _cursor_executable_windows()
+    return None
+
+
+def launch_cursor_with_proxy(
+    proxy_url: str,
+    ca_cert_path: str,
+) -> bool:
+    """
+    Launch Cursor with HTTP_PROXY, HTTPS_PROXY, and NODE_EXTRA_CA_CERTS set.
+
+    Returns True if Cursor was launched, False if executable not found.
+    """
+    exe = find_cursor_executable()
+    if not exe:
+        return False
+
+    env = os.environ.copy()
+    env["HTTP_PROXY"] = proxy_url
+    env["HTTPS_PROXY"] = proxy_url
+    env["NODE_EXTRA_CA_CERTS"] = str(ca_cert_path)
+
+    kwargs: dict = {}
+    if platform.system() == "Windows":
+        kwargs["creationflags"] = subprocess.CREATE_NEW_PROCESS_GROUP | subprocess.DETACHED_PROCESS
+
+    try:
+        subprocess.Popen(
+            [exe],
+            env=env,
+            stdin=subprocess.DEVNULL,
+            stdout=subprocess.DEVNULL,
+            stderr=subprocess.DEVNULL,
+            start_new_session=(platform.system() != "Windows"),
+            **kwargs,
+        )
+        return True
+    except OSError as exc:
+        logger.warning("Failed to launch Cursor: %s", exc)
+        return False

package/src/matrx/cli/main.py

@@ -120,6 +120,11 @@ def _build_parser() -> argparse.ArgumentParser:
     cursor.add_argument("--route", choices=["direct", "matrx"])
     cursor.add_argument("--status", action="store_true", help="Check proxy status")
     cursor.add_argument("--stop", action="store_true", help="Stop the proxy service")
+    cursor.add_argument(
+        "--launch",
+        action="store_true",
+        help="Launch Cursor with proxy env (required for traffic to flow)",
+    )
 
     return parser
 
@@ -841,6 +846,10 @@ def _cmd_cursor(args) -> int:
         trust_ca_system,
     )
     from matrx.cli.cursor_proxy import DEFAULT_PORT, PROXY_HOST
+    from matrx.cli.cursor_launcher import (
+        find_cursor_executable,
+        launch_cursor_with_proxy,
+    )
     from matrx.cli.cursor_service import (
         get_proxy_status,
         install_service,
@@ -963,10 +972,19 @@ def _cmd_cursor(args) -> int:
     print(f"  ca_cert:    {ca_cert_path()}")
     print(f"  telemetry:  {matrx_base_url}/v1/telemetry/cursor")
     print()
-    if cursor_is_running():
-        print("  Cursor is running — restart it for settings to take effect.")
+
+    # Launch Cursor with proxy env vars (required for traffic to flow)
+    if getattr(args, "launch", False):
+        from matrx.cli.cursor_launcher import find_cursor_executable, launch_cursor_with_proxy
+
+        if launch_cursor_with_proxy(proxy_url, str(ca_cert_path())):
+            print("  Launched Cursor with proxy env vars — traffic will flow through MTRX.")
+        else:
+            print("  [warn] Could not launch Cursor. Is it installed?")
+            print("  To route traffic, launch Cursor via: mtrx cursor --launch")
     else:
-        print("  Settings will apply next time Cursor starts.")
+        print("  To route traffic, launch Cursor via: mtrx cursor --launch")
+        print("  (Cursor must be started with proxy env vars; Dock/Spotlight launch won't work)")
     print()
     print("  Check status: mtrx cursor --status")
     print("  To disable:   mtrx use cursor direct")