@willjackson/claude-code-bridge 0.2.4 → 0.3.0

package/README.md

@@ -10,7 +10,6 @@ A bidirectional communication system that enables two separate Claude Code insta
 - [Quick Start](#quick-start)
 - [CLI Reference](#cli-reference)
 - [Configuration](#configuration)
-- [Environment Setup](#environment-setup)
 - [Programmatic Usage](#programmatic-usage)
 - [Troubleshooting](#troubleshooting)
 - [Development](#development)
@@ -18,7 +17,7 @@ A bidirectional communication system that enables two separate Claude Code insta
 
 ## Overview
 
-Claude Code Bridge connects a native macOS/Linux Claude Code instance with a Claude Code instance running inside a Docker-based development environment (Docksal, DDEV, Lando, or plain Docker).
+Claude Code Bridge connects two Claude Code instances running on different machines, containers, or networks via WebSocket.
 
 ### Architecture
 
@@ -47,7 +46,6 @@ Claude Code Bridge connects a native macOS/Linux Claude Code instance with a Cla
 ## Features
 
 - **WebSocket-based communication** with automatic reconnection
-- **Environment auto-detection** for Docksal, DDEV, Lando, and Docker
 - **Context synchronization** with configurable file patterns
 - **Task delegation** with timeout handling
 - **Remote file operations** - read, write, and delete files on connected peers
@@ -100,19 +98,7 @@ claude-bridge start --port 8766
 claude-bridge start --port 8765 --connect ws://host.docker.internal:8766
 ```
 
-### Scenario 2: Auto-Detection Mode
-
-Let the bridge automatically detect your environment and configure itself:
-
-```bash
-# On Mac (auto-detects native environment, uses port 8766)
-claude-bridge start --auto
-
-# In container (auto-detects Docker environment, uses port 8765)
-claude-bridge start --auto --connect ws://host.docker.internal:8766
-```
-
-### Scenario 3: Peer-to-Peer Mode
+### Scenario 2: Peer-to-Peer Mode
 
 Both instances can initiate communication:
 
@@ -128,7 +114,7 @@ claude-bridge start --port 8765 --connect ws://host.docker.internal:8766
 
 Once connected, either side can send context or delegate tasks to the other.
 
-### Scenario 4: Remote File Operations
+### Scenario 3: Remote File Operations
 
 Enable file operations on the remote to allow reading, writing, and deleting files:
 
@@ -166,10 +152,9 @@ Options:
 claude-bridge start [options]
 
 Options:
-  -p, --port <port>    Port to listen on (default: 8765 in container, 8766 native)
+  -p, --port <port>    Port to listen on (default: 8765)
   -h, --host <host>    Host to bind to (default: 0.0.0.0)
   -c, --connect <url>  URL to connect to on startup (e.g., ws://localhost:8765)
-  -a, --auto           Auto-detect environment and configure
   -d, --daemon         Run in background
   --with-handlers      Enable file operations and task handling (read/write/delete files)
 ```
@@ -231,27 +216,15 @@ claude-bridge connect ws://localhost:8765
 claude-bridge connect ws://host.docker.internal:8766
 ```
 
-#### `discover` - Discover Local Bridges
-
-```bash
-claude-bridge discover
-```
-
-Searches for:
-- Docker containers with `claude.bridge.enabled=true` label
-- Running Docksal projects
-- Running DDEV projects
-
-#### `info` - Show Environment Information
+#### `info` - Show System Information
 
 ```bash
 claude-bridge info
 ```
 
 Displays:
-- Detected environment (native, Docksal, DDEV, Lando, Docker)
-- Platform information
-- Network configuration
+- System information (Node version, OS, platform)
+- Network interfaces
 - Current configuration settings
 
 ## Configuration
@@ -320,95 +293,6 @@ interaction:
 | `interaction.notifyOnActivity` | boolean | true | Show notifications on activity |
 | `interaction.taskTimeout` | number | 300000 | Task timeout in ms |
 
-## Environment Setup
-
-### DDEV
-
-**Option 1: Using the DDEV Addon**
-
-Copy the addon files to your DDEV project:
-
-```bash
-cp -r addons/ddev/* .ddev/
-ddev restart
-```
-
-Then start the bridge:
-
-```bash
-ddev exec claude-bridge start --connect ws://host.docker.internal:8766
-```
-
-**Option 2: Add to docker-compose**
-
-Create `.ddev/docker-compose.claude-bridge.yaml`:
-
-```yaml
-services:
-  web:
-    labels:
-      - "claude.bridge.enabled=true"
-      - "claude.bridge.port=8765"
-```
-
-### Docksal
-
-**Option 1: Using the Docksal Addon**
-
-```bash
-# Copy addon to Docksal
-cp -r addons/docksal/* ~/.docksal/addons/claude-bridge/
-
-# Install in your project
-fin addon install claude-bridge
-
-# Start the bridge
-fin claude-bridge start
-```
-
-**Option 2: Manual Setup**
-
-Add to your project's `.docksal/docksal.yml`:
-
-```yaml
-services:
-  cli:
-    labels:
-      - "claude.bridge.enabled=true"
-      - "claude.bridge.port=8765"
-```
-
-### Lando
-
-Lando support is coming soon. For now, you can manually install the bridge in your Lando container:
-
-```bash
-lando ssh
-npm install -g claude-code-bridge
-claude-bridge start --connect ws://host.docker.internal:8766
-```
-
-### Plain Docker
-
-Add to your `docker-compose.yml`:
-
-```yaml
-services:
-  app:
-    labels:
-      - "claude.bridge.enabled=true"
-      - "claude.bridge.port=8765"
-    environment:
-      - NODE_ENV=development
-```
-
-Then inside the container:
-
-```bash
-npm install -g claude-code-bridge
-claude-bridge start --auto
-```
-
 ## Programmatic Usage
 
 ### Basic Usage
@@ -638,18 +522,6 @@ for (const change of delta.changes) {
 2. Increase timeout settings in config
 3. Enable verbose logging: `claude-bridge start -v`
 
-### Environment Detection Issues
-
-**Problem:** Bridge doesn't detect my environment correctly
-
-**Solutions:**
-1. Run `claude-bridge info` to see detected environment
-2. Check environment variables are set correctly:
-   - Docksal: `DOCKSAL_STACK` should be set
-   - DDEV: `IS_DDEV_PROJECT=true` should be set
-   - Lando: `LANDO=ON` should be set
-3. Use explicit configuration instead of auto-detection
-
 ### Port Conflicts
 
 **Problem:** Port already in use
@@ -719,13 +591,7 @@ claude-code-bridge/
 │   │   └── context.ts     # Context manager
 │   ├── transport/
 │   │   ├── interface.ts   # Transport abstraction
-│   │   ├── websocket.ts   # WebSocket implementation
-│   │   └── discovery.ts   # Peer discovery
-│   ├── environment/
-│   │   ├── detect.ts      # Environment detection
-│   │   ├── docksal.ts     # Docksal helpers
-│   │   ├── ddev.ts        # DDEV helpers
-│   │   └── lando.ts       # Lando helpers
+│   │   └── websocket.ts   # WebSocket implementation
 │   ├── cli/
 │   │   ├── index.ts       # CLI entry point
 │   │   └── commands/      # CLI commands
@@ -737,10 +603,6 @@ claude-code-bridge/
 │   ├── unit/              # Unit tests
 │   ├── integration/       # Integration tests
 │   └── e2e/               # End-to-end tests
-└── addons/
-    ├── ddev/              # DDEV addon
-    ├── docksal/           # Docksal addon
-    └── lando/             # Lando plugin
 ```
 
 ### Running Tests

package/dist/{chunk-5HWFDZKH.js → chunk-LUL3SX2F.js}

@@ -1613,350 +1613,6 @@ var Bridge = class {
   }
 };
 
-// src/transport/discovery.ts
-import { execSync } from "child_process";
-var logger3 = createLogger("transport:discovery");
-function parseDockerLabels(labels) {
-  if (!labels) {
-    return null;
-  }
-  const labelMap = {};
-  for (const label of labels.split(",")) {
-    const [key, value] = label.split("=");
-    if (key && value) {
-      labelMap[key.trim()] = value.trim();
-    }
-  }
-  if (labelMap["claude.bridge.enabled"] !== "true") {
-    return null;
-  }
-  return {
-    enabled: true,
-    port: labelMap["claude.bridge.port"] ? parseInt(labelMap["claude.bridge.port"], 10) : void 0,
-    name: labelMap["claude.bridge.name"]
-  };
-}
-function isDockerAvailable() {
-  try {
-    execSync("docker info", { stdio: "pipe", timeout: 5e3 });
-    return true;
-  } catch {
-    return false;
-  }
-}
-function discoverDockerPeers() {
-  const peers = [];
-  if (!isDockerAvailable()) {
-    logger3.debug("Docker is not available");
-    return peers;
-  }
-  try {
-    const output = execSync(
-      'docker ps --format "{{.ID}}|{{.Names}}|{{.Labels}}|{{.Status}}|{{.Ports}}"',
-      {
-        encoding: "utf-8",
-        stdio: ["pipe", "pipe", "pipe"],
-        timeout: 1e4
-      }
-    );
-    const lines = output.trim().split("\n").filter(Boolean);
-    for (const line of lines) {
-      const [id, names, labels, status, ports] = line.split("|");
-      if (!id || !names) continue;
-      const bridgeConfig = parseDockerLabels(labels);
-      if (!bridgeConfig) continue;
-      let port = bridgeConfig.port;
-      if (!port && ports) {
-        const portMatch = ports.match(/0\.0\.0\.0:(\d+)/);
-        if (portMatch) {
-          port = parseInt(portMatch[1], 10);
-        }
-      }
-      if (port) {
-        peers.push({
-          name: bridgeConfig.name || names,
-          source: "docker",
-          url: `ws://localhost:${port}`,
-          containerId: id,
-          status
-        });
-        logger3.debug(
-          { containerId: id, name: bridgeConfig.name || names, port },
-          "Found bridge-enabled container"
-        );
-      }
-    }
-  } catch (error) {
-    logger3.debug(
-      { error: error.message },
-      "Failed to discover Docker peers"
-    );
-  }
-  return peers;
-}
-function discoverDocksalProjects() {
-  const peers = [];
-  try {
-    execSync("which fin", { stdio: "pipe" });
-    const output = execSync('fin project list 2>/dev/null || echo ""', {
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 1e4
-    });
-    const lines = output.trim().split("\n").filter(Boolean);
-    for (const line of lines) {
-      if (line.includes("NAME") || line.startsWith("-")) continue;
-      const parts = line.trim().split(/\s+/);
-      const projectName = parts[0];
-      const status = parts.slice(1).join(" ");
-      if (projectName && status.toLowerCase().includes("running")) {
-        peers.push({
-          name: projectName,
-          source: "docksal",
-          url: `ws://${projectName}.docksal:8765`,
-          status: "running"
-        });
-        logger3.debug({ projectName }, "Found Docksal project");
-      }
-    }
-  } catch (error) {
-    logger3.debug(
-      { error: error.message },
-      "Docksal not available or no projects found"
-    );
-  }
-  return peers;
-}
-function discoverDdevProjects() {
-  const peers = [];
-  try {
-    execSync("which ddev", { stdio: "pipe" });
-    const output = execSync('ddev list --json-output 2>/dev/null || echo "[]"', {
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 1e4
-    });
-    try {
-      const data = JSON.parse(output);
-      const projects = data.raw || [];
-      for (const project of projects) {
-        if (project.status === "running") {
-          peers.push({
-            name: project.name,
-            source: "ddev",
-            url: `ws://${project.name}.ddev.site:8765`,
-            status: "running"
-          });
-          logger3.debug({ projectName: project.name }, "Found DDEV project");
-        }
-      }
-    } catch {
-      logger3.debug("Failed to parse DDEV JSON output, trying text parsing");
-      const lines = output.trim().split("\n").filter(Boolean);
-      for (const line of lines) {
-        if (line.includes("running")) {
-          const parts = line.trim().split(/\s+/);
-          if (parts[0]) {
-            peers.push({
-              name: parts[0],
-              source: "ddev",
-              url: `ws://${parts[0]}.ddev.site:8765`,
-              status: "running"
-            });
-          }
-        }
-      }
-    }
-  } catch (error) {
-    logger3.debug(
-      { error: error.message },
-      "DDEV not available or no projects found"
-    );
-  }
-  return peers;
-}
-function discoverLandoProjects() {
-  const peers = [];
-  try {
-    execSync("which lando", { stdio: "pipe" });
-    const output = execSync('lando list --format json 2>/dev/null || echo "[]"', {
-      encoding: "utf-8",
-      stdio: ["pipe", "pipe", "pipe"],
-      timeout: 1e4
-    });
-    try {
-      const apps = JSON.parse(output);
-      for (const app of apps) {
-        if (app.running) {
-          peers.push({
-            name: app.app || app.name,
-            source: "lando",
-            url: `ws://localhost:8765`,
-            // Would need to check app config for actual port
-            status: "running"
-          });
-          logger3.debug({ appName: app.app || app.name }, "Found Lando app");
-        }
-      }
-    } catch {
-      logger3.debug("Failed to parse Lando JSON output");
-    }
-  } catch (error) {
-    logger3.debug(
-      { error: error.message },
-      "Lando not available or no projects found"
-    );
-  }
-  return peers;
-}
-function discoverAllPeers() {
-  const allPeers = [];
-  const dockerPeers = discoverDockerPeers();
-  allPeers.push(...dockerPeers);
-  logger3.debug({ count: dockerPeers.length }, "Docker peers discovered");
-  const docksalPeers = discoverDocksalProjects();
-  allPeers.push(...docksalPeers);
-  logger3.debug({ count: docksalPeers.length }, "Docksal peers discovered");
-  const ddevPeers = discoverDdevProjects();
-  allPeers.push(...ddevPeers);
-  logger3.debug({ count: ddevPeers.length }, "DDEV peers discovered");
-  const landoPeers = discoverLandoProjects();
-  allPeers.push(...landoPeers);
-  logger3.debug({ count: landoPeers.length }, "Lando peers discovered");
-  return allPeers;
-}
-
-// src/environment/detect.ts
-import { existsSync as existsSync2 } from "fs";
-function isInDocker() {
-  return existsSync2("/.dockerenv");
-}
-function isDocksalEnvironment() {
-  return !!process.env.DOCKSAL_STACK;
-}
-function isDdevEnvironment() {
-  return process.env.IS_DDEV_PROJECT === "true";
-}
-function isLandoEnvironment() {
-  return process.env.LANDO === "ON";
-}
-function isDockerComposeEnvironment() {
-  return !!process.env.COMPOSE_PROJECT_NAME;
-}
-function detectEnvironment() {
-  const platform = process.platform;
-  const inDocker = isInDocker();
-  if (isDocksalEnvironment()) {
-    return {
-      type: "docksal",
-      isContainer: true,
-      projectName: process.env.DOCKSAL_PROJECT,
-      projectRoot: process.env.PROJECT_ROOT,
-      hostGateway: getHostGateway(),
-      platform,
-      meta: {
-        stack: process.env.DOCKSAL_STACK || "",
-        environment: process.env.DOCKSAL_ENVIRONMENT || ""
-      }
-    };
-  }
-  if (isDdevEnvironment()) {
-    return {
-      type: "ddev",
-      isContainer: true,
-      projectName: process.env.DDEV_PROJECT,
-      projectRoot: process.env.DDEV_DOCROOT,
-      hostGateway: getHostGateway(),
-      platform,
-      meta: {
-        hostname: process.env.DDEV_HOSTNAME || "",
-        primaryUrl: process.env.DDEV_PRIMARY_URL || ""
-      }
-    };
-  }
-  if (isLandoEnvironment()) {
-    return {
-      type: "lando",
-      isContainer: true,
-      projectName: process.env.LANDO_APP_NAME,
-      projectRoot: process.env.LANDO_APP_ROOT,
-      hostGateway: getHostGateway(),
-      platform,
-      meta: {
-        service: process.env.LANDO_SERVICE_NAME || "",
-        type: process.env.LANDO_SERVICE_TYPE || ""
-      }
-    };
-  }
-  if (isDockerComposeEnvironment() && inDocker) {
-    return {
-      type: "docker-compose",
-      isContainer: true,
-      projectName: process.env.COMPOSE_PROJECT_NAME,
-      hostGateway: getHostGateway(),
-      platform,
-      meta: {
-        service: process.env.COMPOSE_SERVICE || ""
-      }
-    };
-  }
-  if (inDocker) {
-    return {
-      type: "docker",
-      isContainer: true,
-      hostGateway: getHostGateway(),
-      platform
-    };
-  }
-  return {
-    type: "native",
-    isContainer: false,
-    platform
-  };
-}
-function getHostGateway() {
-  if (process.env.DOCKER_HOST_GATEWAY) {
-    return process.env.DOCKER_HOST_GATEWAY;
-  }
-  if (process.platform === "darwin" || process.platform === "win32") {
-    return "host.docker.internal";
-  }
-  if (isInDocker()) {
-    return "host.docker.internal";
-  }
-  return "localhost";
-}
-function getDefaultConfig(env) {
-  const baseConfig = {
-    mode: "peer",
-    instanceName: env.projectName || `${env.type}-instance`
-  };
-  if (env.isContainer) {
-    return {
-      ...baseConfig,
-      listen: {
-        port: 8765,
-        host: "0.0.0.0"
-      },
-      connect: {
-        url: `ws://${env.hostGateway || "host.docker.internal"}:8766`,
-        hostGateway: true
-      }
-    };
-  }
-  return {
-    ...baseConfig,
-    listen: {
-      port: 8766,
-      host: "0.0.0.0"
-    },
-    connect: {
-      url: "ws://localhost:8765",
-      hostGateway: false
-    }
-  };
-}
-
 // src/utils/config.ts
 import * as fs2 from "fs";
 import * as path2 from "path";
@@ -2086,19 +1742,9 @@ export {
   createContextRequestMessage,
   createNotificationMessage,
   Bridge,
-  parseDockerLabels,
-  isDockerAvailable,
-  discoverDockerPeers,
-  discoverDocksalProjects,
-  discoverDdevProjects,
-  discoverLandoProjects,
-  discoverAllPeers,
-  detectEnvironment,
-  getHostGateway,
-  getDefaultConfig,
   DEFAULT_CONFIG,
   mergeConfig,
   loadConfig,
   loadConfigSync
 };
-//# sourceMappingURL=chunk-5HWFDZKH.js.map
+//# sourceMappingURL=chunk-LUL3SX2F.js.map