@btatum5/codex-bridge 0.1.0 → 1.3.3

package/bin/codex-bridge.js

@@ -1,105 +1,141 @@
-#!/usr/bin/env node
-
-const args = process.argv.slice(2);
-const command = resolveCommand(args[0]);
-const commandArgs = command === "up" ? args : args.slice(1);
-
-switch (command) {
-  case "up":
-  case "start":
-    runServer(commandArgs);
-    break;
-  case "help":
-  case "--help":
-  case "-h":
-    printHelp();
-    break;
-  case "version":
-  case "--version":
-  case "-v":
-    printVersion();
-    break;
-  default:
-    console.error(`[codex-bridge] Unknown command: ${command}`);
-    printHelp(1);
-    break;
-}
-
-function runServer(args) {
-  const options = parseArgs(args);
-
-  if (options.port) {
-    process.env.PORT = String(options.port);
-  }
-
-  if (options.host) {
-    process.env.HOST = options.host;
-  }
-
-  import(new URL("../server.mjs", import.meta.url).href);
-}
-
-function parseArgs(args) {
-  const options = {
-    host: "",
-    port: ""
-  };
-
-  for (let index = 0; index < args.length; index += 1) {
-    const value = args[index];
-
-    if (value === "up" || value === "start") {
-      continue;
+#!/usr/bin/env node
+// FILE: codex-bridge.js
+// Purpose: CLI surface for foreground bridge runs, pairing reset, thread resume, and macOS service control.
+// Layer: CLI binary
+// Exports: none
+// Depends on: ../src
+
+const {
+  printMacOSBridgePairingQr,
+  printMacOSBridgeServiceStatus,
+  readBridgeConfig,
+  resetMacOSBridgePairing,
+  runMacOSBridgeService,
+  startBridge,
+  startMacOSBridgeService,
+  stopMacOSBridgeService,
+  resetBridgePairing,
+  openLastActiveThread,
+  watchThreadRollout,
+} = require("../src");
+const { version } = require("../package.json");
+
+const command = process.argv[2] || "up";
+
+void main();
+
+// ─── ENTRY POINT ─────────────────────────────────────────────
+
+async function main() {
+  if (isVersionCommand(command)) {
+    console.log(version);
+    return;
+  }
+
+  if (command === "up") {
+    if (process.platform === "darwin") {
+      const result = await startMacOSBridgeService({
+        waitForPairing: true,
+      });
+      printMacOSBridgePairingQr({
+        pairingSession: result.pairingSession,
+      });
+      return;
+    }
+
+    startBridge();
+    return;
+  }
+
+  if (command === "run") {
+    startBridge();
+    return;
+  }
+
+  if (command === "run-service") {
+    runMacOSBridgeService();
+    return;
+  }
+
+  if (command === "start") {
+    assertMacOSCommand(command);
+    readBridgeConfig();
+    await startMacOSBridgeService({
+      waitForPairing: false,
+    });
+    console.log("[codex-bridge] macOS bridge service is running.");
+    return;
+  }
+
+  if (command === "stop") {
+    assertMacOSCommand(command);
+    stopMacOSBridgeService();
+    console.log("[codex-bridge] macOS bridge service stopped.");
+    return;
+  }
+
+  if (command === "status") {
+    assertMacOSCommand(command);
+    printMacOSBridgeServiceStatus();
+    return;
+  }
+
+  if (command === "reset-pairing") {
+    try {
+      if (process.platform === "darwin") {
+        resetMacOSBridgePairing();
+        console.log("[codex-bridge] Stopped the macOS bridge service and cleared the saved pairing state. Run `codex-bridge up` to pair again.");
+      } else {
+        resetBridgePairing();
+        console.log("[codex-bridge] Cleared the saved pairing state. Run `codex-bridge up` to pair again.");
+      }
+    } catch (error) {
+      console.error(`[codex-bridge] ${(error && error.message) || "Failed to clear the saved pairing state."}`);
+      process.exit(1);
     }
-
-    if (value === "--host" && args[index + 1]) {
-      options.host = args[index + 1];
-      index += 1;
-      continue;
+    return;
+  }
+
+  if (command === "resume") {
+    try {
+      const state = openLastActiveThread();
+      console.log(
+        `[codex-bridge] Opened last active thread: ${state.threadId} (${state.source || "unknown"})`
+      );
+    } catch (error) {
+      console.error(`[codex-bridge] ${(error && error.message) || "Failed to reopen the last thread."}`);
+      process.exit(1);
     }
-
-    if ((value === "--port" || value === "-p") && args[index + 1]) {
-      options.port = args[index + 1];
-      index += 1;
+    return;
+  }
+
+  if (command === "watch") {
+    try {
+      watchThreadRollout(process.argv[3] || "");
+    } catch (error) {
+      console.error(`[codex-bridge] ${(error && error.message) || "Failed to watch the thread rollout."}`);
+      process.exit(1);
     }
-  }
-
-  return options;
-}
-
-function resolveCommand(firstArg) {
-  if (!firstArg) {
-    return "up";
-  }
-
-  switch (firstArg) {
-    case "help":
-    case "--help":
-    case "-h":
-      return "help";
-    case "version":
-    case "--version":
-    case "-v":
-      return "version";
-    default:
-      return firstArg.startsWith("-") ? "up" : firstArg;
-  }
-}
-
-function printHelp(exitCode = 0) {
-  const lines = [
-    "Usage:",
-    "  codex-bridge up [--host 127.0.0.1] [--port 8787]",
-    "  codex-bridge start [--host 127.0.0.1] [--port 8787]",
-    "  codex-bridge help",
-    "  codex-bridge version"
-  ];
-
-  const stream = exitCode === 0 ? process.stdout : process.stderr;
-  stream.write(`${lines.join("\n")}\n`);
-  process.exit(exitCode);
+    return;
+  }
+
+  console.error(`Unknown command: ${command}`);
+  console.error(
+    "Usage: codex-bridge up | codex-bridge run | codex-bridge start | codex-bridge stop | codex-bridge status | "
+    + "codex-bridge reset-pairing | codex-bridge resume | codex-bridge watch [threadId] | codex-bridge --version"
+  );
+  process.exit(1);
 }
-
-function printVersion() {
-  process.stdout.write("0.1.0\n");
+
+function assertMacOSCommand(name) {
+  if (process.platform === "darwin") {
+    return;
+  }
+
+  console.error(`[codex-bridge] \`${name}\` is only available on macOS. Use \`codex-bridge up\` or \`codex-bridge run\` for the foreground bridge on this OS.`);
+  process.exit(1);
 }
+
+function isVersionCommand(value) {
+  return value === "-v" || value === "--v" || value === "-V" || value === "--version" || value === "version";
+}

package/bin/phodex.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// FILE: phodex.js
+// Purpose: Backward-compatible wrapper that forwards legacy `phodex` usage to `codex-bridge`.
+// Layer: CLI binary
+// Exports: none
+// Depends on: ./codex-bridge
+
+require("./codex-bridge");

package/bin/remodex.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+// FILE: codex-bridge.js
+// Purpose: Backward-compatible wrapper that forwards legacy `remodex` usage to `codex-bridge`.
+// Layer: CLI binary
+// Exports: none
+// Depends on: ./codex-bridge
+
+require("./codex-bridge");

package/package.json

@@ -1,24 +1,38 @@
-{
-  "name": "@btatum5/codex-bridge",
-  "version": "0.1.0",
-  "description": "Codex desktop companion bridge for the iOS controller app.",
-  "license": "MIT",
-  "type": "module",
-  "bin": {
-    "codex-bridge": "bin/codex-bridge.js"
-  },
-  "files": [
-    "bin",
-    "server.mjs",
-    "README.md"
-  ],
-  "publishConfig": {
-    "access": "public"
-  },
-  "engines": {
-    "node": ">=20"
-  },
-  "scripts": {
-    "start": "node ./bin/codex-bridge.js up"
-  }
-}
+{
+  "name": "@btatum5/codex-bridge",
+  "version": "1.3.3",
+  "description": "Local bridge between Codex and the Codex mobile app. Run `codex-bridge up` to start.",
+  "main": "src/index.js",
+  "bin": {
+    "codex-bridge": "bin/codex-bridge.js",
+    "remodex": "bin/codex-bridge.js",
+    "phodex": "bin/phodex.js"
+  },
+  "files": [
+    "bin/",
+    "src/"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "start": "node ./bin/codex-bridge.js up",
+    "test": "node --test ./test/*.test.js",
+    "prepack": "node ./scripts/prepare-private-defaults.js",
+    "postpack": "node ./scripts/cleanup-private-defaults.js"
+  },
+  "keywords": [
+    "codex-bridge",
+    "remodex",
+    "codex",
+    "bridge",
+    "cli"
+  ],
+  "author": "Emanuele Di Pietro",
+  "license": "ISC",
+  "type": "commonjs",
+  "dependencies": {
+    "qrcode-terminal": "^0.12.0",
+    "ws": "^8.19.0"
+  }
+}