feat: add --remote-url CLI option to connect to remote OpenCode instances (#161)

* feat: add --remote-url CLI option to connect to remote OpenCode instances

* fix: pass remoteUrl to main function when running as CLI

packages/web/bin/cli.js

@@ -74,7 +74,7 @@ function buildTunnelUrl(baseUrl, password, includePassword) {
 function parseArgs() {
   const args = process.argv.slice(2);
   const envPassword = process.env.OPENCHAMBER_UI_PASSWORD || undefined;
-  const options = { port: DEFAULT_PORT, daemon: false, uiPassword: envPassword, tryCfTunnel: false, tunnelQr: false, tunnelPasswordUrl: false };
+  const options = { port: DEFAULT_PORT, daemon: false, uiPassword: envPassword, tryCfTunnel: false, tunnelQr: false, tunnelPasswordUrl: false, remoteUrl: null };
   let command = 'serve';
 
   const consumeValue = (currentIndex, inlineValue) => {
@@ -132,6 +132,12 @@ function parseArgs() {
           options.uiPassword = typeof value === 'string' ? value : '';
           break;
         }
+        case 'remote-url': {
+          const { value, nextIndex } = consumeValue(i, inlineValue);
+          i = nextIndex;
+          options.remoteUrl = typeof value === 'string' && value.length > 0 ? value : null;
+          break;
+        }
         case 'help':
         case 'h':
           showHelp();
@@ -167,6 +173,7 @@ COMMANDS:
 
 OPTIONS:
   -p, --port              Web server port (default: ${DEFAULT_PORT})
+  --remote-url            Connect to remote OpenCode instance instead of starting local
   --ui-password           Protect browser UI with single password
   --try-cf-tunnel         Create a Cloudflare Quick Tunnel for remote access
   --tunnel-qr             Display QR code for tunnel URL (use with --try-cf-tunnel)
@@ -177,12 +184,14 @@ OPTIONS:
 
 ENVIRONMENT:
   OPENCHAMBER_UI_PASSWORD  Alternative to --ui-password flag
+  OPENCODE_REMOTE_URL      Alternative to --remote-url flag
 
 EXAMPLES:
   openchamber                    # Start on default port 3000
   openchamber --port 8080        # Start on port 8080
   openchamber serve --daemon     # Start in background
   openchamber --try-cf-tunnel    # Start with Cloudflare Quick Tunnel
+  openchamber --remote-url http://remote-server:3000  # Connect to remote OpenCode
   openchamber stop               # Stop all running instances
   openchamber stop --port 3000   # Stop specific instance
   openchamber status             # Check status
@@ -456,7 +465,8 @@ const commands = {
       process.exit(1);
     }
 
-    const opencodeBinary = await checkOpenCodeCLI();
+    // When remoteUrl is provided, skip local OpenCode CLI check
+    const opencodeBinary = options.remoteUrl ? null : await checkOpenCodeCLI();
 
     const serverPath = path.join(__dirname, '..', 'server', 'index.js');
 
@@ -475,6 +485,9 @@ const commands = {
     if (options.tryCfTunnel) {
       serverArgs.push('--try-cf-tunnel');
     }
+    if (options.remoteUrl) {
+      serverArgs.push('--remote-url', options.remoteUrl);
+    }
 
     const preferredRuntime = getPreferredServerRuntime();
     const runtimeBin = preferredRuntime === 'bun' ? BUN_BIN : process.execPath;
@@ -487,9 +500,10 @@ const commands = {
         env: {
           ...process.env,
           OPENCHAMBER_PORT: options.port.toString(),
-          OPENCODE_BINARY: opencodeBinary,
+          ...(opencodeBinary ? { OPENCODE_BINARY: opencodeBinary } : {}),
           ...(typeof effectiveUiPassword === 'string' ? { OPENCHAMBER_UI_PASSWORD: effectiveUiPassword } : {}),
           OPENCHAMBER_TRY_CF_TUNNEL: options.tryCfTunnel ? 'true' : 'false',
+          ...(options.remoteUrl ? { OPENCODE_REMOTE_URL: options.remoteUrl } : {}),
         }
       });
 
@@ -514,10 +528,15 @@ const commands = {
 
     } else {
 
-      process.env.OPENCODE_BINARY = opencodeBinary;
+      if (opencodeBinary) {
+        process.env.OPENCODE_BINARY = opencodeBinary;
+      }
       if (typeof effectiveUiPassword === 'string') {
         process.env.OPENCHAMBER_UI_PASSWORD = effectiveUiPassword;
       }
+      if (options.remoteUrl) {
+        process.env.OPENCODE_REMOTE_URL = options.remoteUrl;
+      }
       if (showAutoGeneratedPassword) {
         console.log(`\n🔐 Auto-generated password: \x1b[92m${effectiveUiPassword}\x1b[0m`);
         console.log('⚠️  Save this password - it won\'t be shown again!\n');
@@ -533,9 +552,10 @@ const commands = {
           env: {
             ...process.env,
             OPENCHAMBER_PORT: options.port.toString(),
-            OPENCODE_BINARY: opencodeBinary,
+            ...(opencodeBinary ? { OPENCODE_BINARY: opencodeBinary } : {}),
             ...(typeof effectiveUiPassword === 'string' ? { OPENCHAMBER_UI_PASSWORD: effectiveUiPassword } : {}),
             OPENCHAMBER_TRY_CF_TUNNEL: options.tryCfTunnel ? 'true' : 'false',
+            ...(options.remoteUrl ? { OPENCODE_REMOTE_URL: options.remoteUrl } : {}),
           },
         });
 
@@ -553,6 +573,7 @@ const commands = {
         exitOnShutdown: true,
         uiPassword: typeof effectiveUiPassword === 'string' ? effectiveUiPassword : null,
         tryCfTunnel: options.tryCfTunnel,
+        remoteUrl: options.remoteUrl,
         onTunnelReady: async (url) => {
           const displayUrl = buildTunnelUrl(url, effectiveUiPassword, options.tunnelPasswordUrl);
           console.log(`\n🌐 Tunnel URL: \x1b[36m${displayUrl}\x1b[0m\n`);