cursor-bridge 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,178 @@
+#!/usr/bin/env node
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const ws_1 = require("ws");
+const uuid_1 = require("uuid");
+const chalk_1 = __importDefault(require("chalk"));
+const qrcode_terminal_1 = __importDefault(require("qrcode-terminal"));
+const os_1 = __importDefault(require("os"));
+const PORT = Number(process.argv[2]) || 9090;
+const TOKEN = (0, uuid_1.v4)();
+const clients = new Map();
+function getLocalIP() {
+    const interfaces = os_1.default.networkInterfaces();
+    for (const name of Object.keys(interfaces)) {
+        for (const iface of interfaces[name] || []) {
+            if (iface.family === 'IPv4' && !iface.internal) {
+                return iface.address;
+            }
+        }
+    }
+    return 'localhost';
+}
+function findPeer(clientId) {
+    const client = clients.get(clientId);
+    if (!client)
+        return undefined;
+    for (const [, other] of clients) {
+        if (other.id !== clientId &&
+            other.token === client.token &&
+            other.type !== client.type) {
+            return other;
+        }
+    }
+    return undefined;
+}
+function banner() {
+    const ip = getLocalIP();
+    const pairUrl = `cursor-bridge://${ip}:${PORT}/${TOKEN}`;
+    console.clear();
+    console.log('');
+    console.log(chalk_1.default.hex('#A855F7').bold('  ╔══════════════════════════════════════╗'));
+    console.log(chalk_1.default.hex('#A855F7').bold('  ║') +
+        chalk_1.default.white.bold('   IDE For Cursor — Mobile Bridge   ') +
+        chalk_1.default.hex('#A855F7').bold('║'));
+    console.log(chalk_1.default.hex('#A855F7').bold('  ╚══════════════════════════════════════╝'));
+    console.log('');
+    console.log(chalk_1.default.gray('  Scan this QR code with the mobile app:'));
+    console.log('');
+    qrcode_terminal_1.default.generate(pairUrl, { small: true }, (qr) => {
+        const lines = qr.split('\n');
+        lines.forEach(line => console.log('    ' + line));
+    });
+    console.log('');
+    console.log(chalk_1.default.gray('  Or connect manually:'));
+    console.log(chalk_1.default.white('  Host: ') + chalk_1.default.hex('#A855F7')(ip));
+    console.log(chalk_1.default.white('  Port: ') + chalk_1.default.hex('#A855F7')(String(PORT)));
+    console.log(chalk_1.default.white('  Token: ') + chalk_1.default.hex('#A855F7')(TOKEN));
+    console.log('');
+    console.log(chalk_1.default.gray('  Waiting for mobile connection...'));
+    console.log('');
+}
+const wss = new ws_1.WebSocketServer({ port: PORT });
+wss.on('connection', (ws) => {
+    const clientId = (0, uuid_1.v4)();
+    ws.on('message', (raw) => {
+        try {
+            const message = JSON.parse(raw.toString());
+            switch (message.type) {
+                case 'pair': {
+                    const { token, clientType } = message.payload;
+                    clients.set(clientId, {
+                        id: clientId,
+                        ws,
+                        type: clientType,
+                        token,
+                    });
+                    const peer = findPeer(clientId);
+                    ws.send(JSON.stringify({
+                        type: 'status',
+                        payload: {
+                            status: peer ? 'connected' : 'waiting',
+                            clientId,
+                        },
+                        timestamp: Date.now(),
+                    }));
+                    if (peer) {
+                        peer.ws.send(JSON.stringify({
+                            type: 'status',
+                            payload: { status: 'connected' },
+                            timestamp: Date.now(),
+                        }));
+                        console.log(chalk_1.default.hex('#22C55E')('  ✓ ') +
+                            chalk_1.default.white(`${clientType} device connected and paired!`));
+                    }
+                    else {
+                        console.log(chalk_1.default.hex('#F59E0B')('  ⟳ ') +
+                            chalk_1.default.white(`${clientType} device connected, waiting for peer...`));
+                    }
+                    break;
+                }
+                case 'command': {
+                    const peer = findPeer(clientId);
+                    if (peer && peer.ws.readyState === ws_1.WebSocket.OPEN) {
+                        peer.ws.send(JSON.stringify({
+                            ...message,
+                            from: clientId,
+                            timestamp: Date.now(),
+                        }));
+                        console.log(chalk_1.default.hex('#A855F7')('  → ') +
+                            chalk_1.default.gray('Command forwarded to desktop'));
+                    }
+                    break;
+                }
+                case 'response': {
+                    const peer = findPeer(clientId);
+                    if (peer && peer.ws.readyState === ws_1.WebSocket.OPEN) {
+                        peer.ws.send(JSON.stringify({
+                            ...message,
+                            from: clientId,
+                            timestamp: Date.now(),
+                        }));
+                        console.log(chalk_1.default.hex('#A855F7')('  ← ') +
+                            chalk_1.default.gray('Response forwarded to mobile'));
+                    }
+                    break;
+                }
+                case 'ping': {
+                    ws.send(JSON.stringify({
+                        type: 'pong',
+                        payload: {},
+                        timestamp: Date.now(),
+                    }));
+                    break;
+                }
+            }
+        }
+        catch {
+            ws.send(JSON.stringify({
+                type: 'error',
+                payload: { message: 'Invalid message format' },
+            }));
+        }
+    });
+    ws.on('close', () => {
+        const client = clients.get(clientId);
+        if (client) {
+            const peer = findPeer(clientId);
+            if (peer && peer.ws.readyState === ws_1.WebSocket.OPEN) {
+                peer.ws.send(JSON.stringify({
+                    type: 'status',
+                    payload: { status: 'disconnected' },
+                    timestamp: Date.now(),
+                }));
+            }
+            console.log(chalk_1.default.hex('#EF4444')('  ✗ ') +
+                chalk_1.default.gray(`${client.type} device disconnected`));
+            clients.delete(clientId);
+        }
+    });
+});
+// Heartbeat
+setInterval(() => {
+    clients.forEach(client => {
+        if (client.ws.readyState === ws_1.WebSocket.OPEN) {
+            client.ws.ping();
+        }
+    });
+}, 30000);
+banner();
+process.on('SIGINT', () => {
+    console.log('');
+    console.log(chalk_1.default.gray('  Bridge stopped.'));
+    wss.close();
+    process.exit(0);
+});

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "cursor-bridge",
+  "version": "1.0.0",
+  "description": "CLI bridge to connect IDE For Cursor mobile app with desktop Cursor IDE",
+  "main": "dist/index.js",
+  "bin": {
+    "cursor-bridge": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "ts-node src/index.ts"
+  },
+  "keywords": ["cursor", "ide", "mobile", "bridge", "cli"],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "ws": "^8.20.0",
+    "uuid": "^13.0.0",
+    "qrcode-terminal": "^0.12.0"
+  },
+  "devDependencies": {
+    "@types/ws": "^8.18.1",
+    "@types/node": "^25.5.2",
+    "typescript": "^6.0.2",
+    "ts-node": "^10.9.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,250 @@
+#!/usr/bin/env node
+
+import { WebSocketServer, WebSocket } from 'ws';
+import { v4 as uuidv4 } from 'uuid';
+import chalk from 'chalk';
+import qrcode from 'qrcode-terminal';
+import os from 'os';
+
+const PORT = Number(process.argv[2]) || 9090;
+const TOKEN = uuidv4();
+
+interface BridgeMessage {
+  type: string;
+  payload: Record<string, unknown>;
+  from?: string;
+  timestamp: number;
+}
+
+interface ConnectedClient {
+  id: string;
+  ws: WebSocket;
+  type: 'mobile' | 'desktop';
+  token: string;
+}
+
+const clients = new Map<string, ConnectedClient>();
+
+function getLocalIP(): string {
+  const interfaces = os.networkInterfaces();
+  for (const name of Object.keys(interfaces)) {
+    for (const iface of interfaces[name] || []) {
+      if (iface.family === 'IPv4' && !iface.internal) {
+        return iface.address;
+      }
+    }
+  }
+  return 'localhost';
+}
+
+function findPeer(clientId: string): ConnectedClient | undefined {
+  const client = clients.get(clientId);
+  if (!client) return undefined;
+
+  for (const [, other] of clients) {
+    if (
+      other.id !== clientId &&
+      other.token === client.token &&
+      other.type !== client.type
+    ) {
+      return other;
+    }
+  }
+  return undefined;
+}
+
+function banner() {
+  const ip = getLocalIP();
+  const pairUrl = `cursor-bridge://${ip}:${PORT}/${TOKEN}`;
+
+  console.clear();
+  console.log('');
+  console.log(
+    chalk.hex('#A855F7').bold('  ╔══════════════════════════════════════╗'),
+  );
+  console.log(
+    chalk.hex('#A855F7').bold('  ║') +
+      chalk.white.bold('   IDE For Cursor — Mobile Bridge   ') +
+      chalk.hex('#A855F7').bold('║'),
+  );
+  console.log(
+    chalk.hex('#A855F7').bold('  ╚══════════════════════════════════════╝'),
+  );
+  console.log('');
+  console.log(chalk.gray('  Scan this QR code with the mobile app:'));
+  console.log('');
+
+  qrcode.generate(pairUrl, { small: true }, (qr: string) => {
+    const lines = qr.split('\n');
+    lines.forEach(line => console.log('    ' + line));
+  });
+
+  console.log('');
+  console.log(chalk.gray('  Or connect manually:'));
+  console.log(
+    chalk.white('  Host: ') + chalk.hex('#A855F7')(ip),
+  );
+  console.log(
+    chalk.white('  Port: ') + chalk.hex('#A855F7')(String(PORT)),
+  );
+  console.log(
+    chalk.white('  Token: ') + chalk.hex('#A855F7')(TOKEN),
+  );
+  console.log('');
+  console.log(chalk.gray('  Waiting for mobile connection...'));
+  console.log('');
+}
+
+const wss = new WebSocketServer({ port: PORT });
+
+wss.on('connection', (ws: WebSocket) => {
+  const clientId = uuidv4();
+
+  ws.on('message', (raw: Buffer) => {
+    try {
+      const message: BridgeMessage = JSON.parse(raw.toString());
+
+      switch (message.type) {
+        case 'pair': {
+          const { token, clientType } = message.payload as {
+            token: string;
+            clientType: 'mobile' | 'desktop';
+          };
+
+          clients.set(clientId, {
+            id: clientId,
+            ws,
+            type: clientType,
+            token,
+          });
+
+          const peer = findPeer(clientId);
+
+          ws.send(
+            JSON.stringify({
+              type: 'status',
+              payload: {
+                status: peer ? 'connected' : 'waiting',
+                clientId,
+              },
+              timestamp: Date.now(),
+            }),
+          );
+
+          if (peer) {
+            peer.ws.send(
+              JSON.stringify({
+                type: 'status',
+                payload: { status: 'connected' },
+                timestamp: Date.now(),
+              }),
+            );
+            console.log(
+              chalk.hex('#22C55E')('  ✓ ') +
+                chalk.white(`${clientType} device connected and paired!`),
+            );
+          } else {
+            console.log(
+              chalk.hex('#F59E0B')('  ⟳ ') +
+                chalk.white(`${clientType} device connected, waiting for peer...`),
+            );
+          }
+          break;
+        }
+
+        case 'command': {
+          const peer = findPeer(clientId);
+          if (peer && peer.ws.readyState === WebSocket.OPEN) {
+            peer.ws.send(
+              JSON.stringify({
+                ...message,
+                from: clientId,
+                timestamp: Date.now(),
+              }),
+            );
+            console.log(
+              chalk.hex('#A855F7')('  → ') +
+                chalk.gray('Command forwarded to desktop'),
+            );
+          }
+          break;
+        }
+
+        case 'response': {
+          const peer = findPeer(clientId);
+          if (peer && peer.ws.readyState === WebSocket.OPEN) {
+            peer.ws.send(
+              JSON.stringify({
+                ...message,
+                from: clientId,
+                timestamp: Date.now(),
+              }),
+            );
+            console.log(
+              chalk.hex('#A855F7')('  ← ') +
+                chalk.gray('Response forwarded to mobile'),
+            );
+          }
+          break;
+        }
+
+        case 'ping': {
+          ws.send(
+            JSON.stringify({
+              type: 'pong',
+              payload: {},
+              timestamp: Date.now(),
+            }),
+          );
+          break;
+        }
+      }
+    } catch {
+      ws.send(
+        JSON.stringify({
+          type: 'error',
+          payload: { message: 'Invalid message format' },
+        }),
+      );
+    }
+  });
+
+  ws.on('close', () => {
+    const client = clients.get(clientId);
+    if (client) {
+      const peer = findPeer(clientId);
+      if (peer && peer.ws.readyState === WebSocket.OPEN) {
+        peer.ws.send(
+          JSON.stringify({
+            type: 'status',
+            payload: { status: 'disconnected' },
+            timestamp: Date.now(),
+          }),
+        );
+      }
+      console.log(
+        chalk.hex('#EF4444')('  ✗ ') +
+          chalk.gray(`${client.type} device disconnected`),
+      );
+      clients.delete(clientId);
+    }
+  });
+});
+
+// Heartbeat
+setInterval(() => {
+  clients.forEach(client => {
+    if (client.ws.readyState === WebSocket.OPEN) {
+      client.ws.ping();
+    }
+  });
+}, 30000);
+
+banner();
+
+process.on('SIGINT', () => {
+  console.log('');
+  console.log(chalk.gray('  Bridge stopped.'));
+  wss.close();
+  process.exit(0);
+});

package/src/types.d.ts

@@ -0,0 +1,8 @@
+declare module 'qrcode-terminal' {
+  function generate(
+    text: string,
+    options?: { small?: boolean },
+    callback?: (qr: string) => void,
+  ): void;
+  export = { generate };
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "commonjs",
+    "lib": ["ES2020"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}