@hmduc16031996/claude-mb-bridge 2.2.2 → 2.3.2

package/README.md

@@ -1,76 +1,53 @@
-# Claude MB Bridge 🤖📱
+# Claude Mobile Bridge 🤖📱
 
-A lightweight bridge between the **Claude Code CLI** and your **mobile app** (e.g., iOS/Android) via Supabase. It allows you to use Claude Code to interact with your codebase directly from your mobile device.
-
-![App Icon](appicon.png)
+A lightweight bridge between the **Claude Code CLI** and your **mobile app** via a secure Cloudflare Tunnel. This tool allows you to interact with your local development environment directly from your mobile device using the Claude Code CLI.
 
 ## ✨ Features
 
-- **Real-time Communication**: USes Supabase Realtime to bridge messages between your Mac and mobile device.
-- **Persistent Sessions**: Resumes previous Claude conversations automatically, even after restarts.
-- **Streaming Output**: (In-progress) Supports viewing Claude's output as it's generated.
-- **Pairing System**: Securely pair your mobile app using a simple 6-digit code.
-- **Background Service**: Easily install as a login item on macOS to keep the bridge running.
-- **Model Selection**: Supports switching between Claude 3.5 Sonnet, 3 Opus, and 3.5 Haiku.
-- **Command Cancellation**: Stop running Claude processes directly from your mobile app.
+- **Secure Tunneling**: Uses Cloudflare Tunnel (`cloudflared`) to expose your local terminal securely.
+- **Terminal Integration**: Full terminal emulation using `node-pty` and `xterm.js`.
+- **Session Management**: Pairing via tokens and a central coordination server.
+- **Cross-Platform**: Works on macOS, Linux, and Windows.
 
 ## 📋 Prerequisites
 
 1.  **Node.js**: Version 18.0.0 or higher.
-2.  **Claude Code CLI**: Must be installed on your Mac.
-    - Install via brew: `brew install --cask claude-code`
-    - Or visit: [code.claude.com](https://code.claude.com)
-3.  **Supabase Account**: A Supabase project with the required schema (tables: `device_pairs`, `bridge_sessions`, `messages`, `ide_presence`).
+2.  **Claude Code CLI**: Installed and authenticated (`npm install -g @anthropic-ai/claude-code`).
+3.  **Cloudflared**: The Cloudflare Tunnel CLI must be installed and in your PATH.
+    - `brew install cloudflared` (macOS)
+    - [Download for other platforms](https://developers.cloudflare.com/cloudflare-one/connections/connect-apps/install-and-setup/installation/)
 
-## 🚀 Installation
+## 🚀 Installation & Usage
 
-Install the package globally or run it directly using `npx`:
+Install the package globally:
 
 ```bash
-# Run via npx
-npx claude-mb-bridge
-
-# Or install globally
-npm install -g claude-mb-bridge
+npm install -g @hmduc16031996/claude-mb-bridge
 ```
 
-## 🔧 Setup & Pairing
-
-1.  **Start the Bridge**: Run `claude-mb-bridge` in your project's root directory.
-2.  **Get Pair Code**: The bridge will start a local pairing server (default port: `38473`).
-3.  **Connect Mobile App**: Open your mobile app, enter the 6-digit code displayed in your terminal.
-4.  **Authorized**: Once paired, the bridge will remember your device and automatically reconnect in the future.
-
-## 💻 CLI Options
-
-| Option | Description |
-| :--- | :--- |
-| `-p, --path <dir>` | Project directory for Claude to work in (defaults to current directory) |
-| `--port <number>` | Port for the pairing server (default: `38473`) |
-| `--install` | Install as a background service (starts on login) |
-| `--uninstall` | Remove the background service |
-| `--version` | Show version number |
-
-## ⚙️ Configuration
-
-The bridge stores its configuration in `~/.claude-mobile/config.json`.
-
-You can override the default Supabase credentials using environment variables:
+Or run it directly using `npx`:
 
 ```bash
-SUPABASE_URL="your-project-url"
-SUPABASE_ANON_KEY="your-anon-key"
+npx @hmduc16031996/claude-mb-bridge --token YOUR_PAIRING_TOKEN
 ```
 
-## 🏗️ Architecture
+### Options
+
+| Option | Description | Default |
+| :--- | :--- | :--- |
+| `--token` | **Required**. Pairing token from your mobile app. | |
+| `--server` | URL of the central coordination server. | `http://127.0.0.1:3000` |
+| `--path` | Working directory for the terminal session. | `process.cwd()` |
+| `--port` | Local port for the terminal server. | `38473` |
+
+## 🏗️ How it Works
 
-The bridge acts as a middleman:
-1.  **Mobile App** inserts a `user` message into the Supabase `messages` table.
-2.  **Bridge** (this package) detects the new message via Realtime/Polling.
-3.  **Bridge** executes the command using the local `claude-code` CLI.
-4.  **Bridge** captures the output and inserts an `agent` reply back into the `messages` table.
-5.  **Mobile App** displays the reply to the user.
+1.  **Start the Bridge**: Run the CLI with your pairing token.
+2.  **Local Server**: The bridge starts a local HTTP/WebSocket server that hosts a terminal interface.
+3.  **Cloudflare Tunnel**: It automatically creates a temporary `.trycloudflare.com` tunnel pointing to your local server.
+4.  **Connect**: The bridge reports the tunnel URL to the central server, which then allows your mobile app to connect to the terminal via the secure URL.
+5.  **Interactive Session**: Use Claude Code directly in your mobile app as if you were in your local terminal.
 
 ## 📄 License
 
-MIT © [Your Name/Company]
+MIT © [hmduc16031996](https://github.com/hmduc16031996)

package/dist/index.js

@@ -1,4 +1,3 @@
-#!/usr/bin/env node
 import { Command } from 'commander';
 import { CloudflareTunnel } from './tunnel.js';
 import { startTerminalServer } from './server.js';
@@ -6,9 +5,9 @@ const program = new Command();
 program
     .name('claude-mobile-bridge')
     .description('Bridge Claude Code CLI to mobile via WebView')
-    .version('2.0.0')
+    .version('2.3.2')
     .option('--token <token>', 'Pairing token from mobile app')
-    .option('--server <url>', 'Backend server URL', 'http://127.0.0.1:3000')
+    .option('--server <url>', 'Backend server URL', 'http://127.0.0.1:3777')
     .option('--path <path>', 'Working directory', process.cwd())
     .option('--port <port>', 'Local port for terminal server', '38473')
     .action(async (options) => {
@@ -31,16 +30,21 @@ program
         }
     };
     // 1. Start local terminal server
+    console.log('📦 Starting terminal server...');
     const localPort = parseInt(port, 10);
     const { server: terminalServer, actualPort } = await startTerminalServer(localPort, path, cleanup);
+    console.log(`✅ Terminal server started on port ${actualPort}`);
     // 2. Start Cloudflare Tunnel
+    console.log('🌐 Establishing secure tunnel...');
     const tunnel = new CloudflareTunnel();
     const tunnelResult = await tunnel.start(actualPort);
     if (!tunnelResult.url) {
         console.error('❌ Failed to start Cloudflare Tunnel.');
         process.exit(1);
     }
+    console.log('✅ Secure tunnel established');
     // 3. Validate token and report public URL to central server
+    console.log('🔑 Validating session token...');
     try {
         const res = await fetch(`${server}/api/sessions/${token}/validate`, {
             method: 'POST',
@@ -54,11 +58,11 @@ program
         if (!res.ok) {
             throw new Error('Invalid token or session expired');
         }
-        console.log('✅ Session connected');
+        console.log('✅ Session connected and authorized');
     }
     catch (err) {
         console.error(`❌ Validation failed: ${err.message}`);
-        console.error('   Ensure the central server is running at:', server);
+        console.error('   Ensure the central server is available');
         cleanup();
     }
     // Handle graceful shutdown signals

package/dist/server.js

@@ -19,14 +19,39 @@ export function startTerminalServer(port, workingDir, onDisconnect) {
     wss.on('connection', (ws, req) => {
         console.log(`📡 New connection attempt from ${req.socket.remoteAddress}`);
         console.log('✅ Connection authorized');
-        const shell = process.platform === 'win32' ? 'powershell.exe' : 'bash';
-        const term = pty.spawn(shell, [], {
-            name: 'xterm-256color',
-            cols: 80,
-            rows: 24,
-            cwd: workingDir,
-            env: process.env
-        });
+        // Use absolute paths for shells to avoid posix_spawnp failure
+        let shell = '/bin/bash';
+        if (process.platform === 'win32') {
+            shell = 'powershell.exe';
+        }
+        else if (process.platform === 'darwin') {
+            // Prefer zsh on macOS as it's the modern default, fallback to bash
+            shell = require('fs').existsSync('/bin/zsh') ? '/bin/zsh' : '/bin/bash';
+        }
+        console.log(`🚀 Spawning shell: ${shell} in ${workingDir}`);
+        let term;
+        try {
+            // Ensure working directory exists
+            if (!require('fs').existsSync(workingDir)) {
+                console.error(`❌ Working directory does not exist: ${workingDir}`);
+                ws.send('\r\n\x1b[31mError: Working directory does not exist\x1b[0m\r\n');
+                ws.close();
+                return;
+            }
+            term = pty.spawn(shell, [], {
+                name: 'xterm-256color',
+                cols: 80,
+                rows: 24,
+                cwd: workingDir,
+                env: process.env
+            });
+        }
+        catch (err) {
+            console.error(`❌ Failed to spawn terminal: ${err.message}`);
+            ws.send(`\r\n\x1b[31mError: Failed to spawn terminal (${err.message})\x1b[0m\r\n`);
+            ws.close();
+            return;
+        }
         term.write('claude\r');
         term.onData((data) => {
             ws.send(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hmduc16031996/claude-mb-bridge",
-  "version": "2.2.2",
+  "version": "2.3.2",
   "description": "Bridge between Claude Code CLI and your mobile app via WebView",
   "type": "module",
   "main": "dist/index.js",
@@ -8,7 +8,7 @@
     "claude-mb-bridge": "dist/index.js"
   },
   "scripts": {
-    "build": "tsc && echo '#!/usr/bin/env node' > dist/index.js.tmp && cat dist/index.js >> dist/index.js.tmp && mv dist/index.js.tmp dist/index.js && chmod +x dist/index.js",
+    "build": "tsc",
     "start": "node dist/index.js",
     "dev": "tsx src/index.ts",
     "postinstall": "node scripts/postinstall.cjs"