nexting-cc-bridge 0.8.3

package/dist/watch-manager.js

@@ -0,0 +1,77 @@
+// Owns the set of transcript followers (one per phone-watched session).
+// cc_watch is idempotent: a re-watch refreshes the TTL and re-sends
+// watch_ok{entryCount} — the phone uses that count as a reconciliation
+// heartbeat (mismatch → it refetches the full transcript anchor).
+import { findSessionFile } from "./scanner.js";
+import { createTranscriptFollower, } from "./transcript-watcher.js";
+const WATCH_TTL_MS = 10 * 60 * 1000; // phone keepalive re-watches every 4 min
+const SWEEP_MS = 60 * 1000;
+export function createWatchManager(send, deps) {
+    const findFile = deps?.findFile ?? findSessionFile;
+    const log = deps?.log ?? (() => { });
+    const followers = new Map();
+    const sweep = setInterval(() => {
+        const now = Date.now();
+        for (const [id, w] of followers) {
+            if (now - w.lastTouch > WATCH_TTL_MS) {
+                w.f.stop();
+                followers.delete(id);
+            }
+        }
+    }, SWEEP_MS);
+    sweep.unref?.();
+    const ok = (sessionId, entryCount) => send({
+        type: "cc_event",
+        sessionId,
+        kind: "watch_ok",
+        payload: { entryCount },
+    });
+    return {
+        async watch(sessionId) {
+            const existing = followers.get(sessionId);
+            if (existing) {
+                existing.lastTouch = Date.now();
+                ok(sessionId, existing.f.entryCount());
+                return;
+            }
+            const file = await findFile(sessionId);
+            if (!file) {
+                // No jsonl on this Mac (unknown id, or a codex bridge) — the phone
+                // falls back to slow polling on this signal.
+                log(`watch failed (no file): ${sessionId.slice(0, 8)}`);
+                send({
+                    type: "cc_event",
+                    sessionId,
+                    kind: "watch_failed",
+                    payload: { reason: "session_file_not_found" },
+                });
+                return;
+            }
+            const f = createTranscriptFollower({
+                sessionId,
+                file,
+                emit: send,
+                parse: deps?.parse,
+                transform: deps?.transform,
+            });
+            await f.start();
+            followers.set(sessionId, { f, lastTouch: Date.now() });
+            log(`watch started: ${sessionId.slice(0, 8)} (${f.entryCount()} entries)`);
+            ok(sessionId, f.entryCount());
+        },
+        unwatch(sessionId) {
+            const w = followers.get(sessionId);
+            if (w) {
+                w.f.stop();
+                followers.delete(sessionId);
+                log(`watch stopped: ${sessionId.slice(0, 8)}`);
+            }
+        },
+        stopAll() {
+            clearInterval(sweep);
+            for (const w of followers.values())
+                w.f.stop();
+            followers.clear();
+        },
+    };
+}

package/install-cc.sh

@@ -0,0 +1,90 @@
+#!/usr/bin/env bash
+# Nexting Claude Code bridge installer.
+#   curl -fsSL https://nexting.ai/install-cc | bash
+# Logs you in to Nexting in your browser, installs the bridge, and makes `claude`
+# phone-controllable (claude shim + background hub). One step: log in = installed.
+# Fully reversible:  nexting-cc-bridge uninstall
+set -euo pipefail
+
+API="${NEXTING_API:-https://api.nexting.ai}"
+WS_URL="${NEXTING_CC_URL:-wss://api.nexting.ai/cc-bridge/connect}"
+CFG_DIR="$HOME/.nexting"
+CFG="$CFG_DIR/cc-bridge.json"
+
+echo "→ Nexting Claude Code bridge installer"
+
+command -v node >/dev/null 2>&1 || { echo "✗ Node.js not found. Claude Code needs Node — install it first."; exit 1; }
+
+# ── 1. log in to Nexting (device-code browser flow = the binding) ──
+# Logging in IS the binding: the browser login authorizes this Mac for your
+# account, no separate step. A token may be supplied out-of-band via
+# NEXTING_CC_TOKEN to skip the browser login (e.g. an automated re-install).
+if [ -n "${NEXTING_CC_TOKEN:-}" ]; then
+  TOKEN="$NEXTING_CC_TOKEN"
+  echo "✓ Using the Nexting account token provided."
+else
+  echo "→ Logging you in to Nexting…"
+  START=$(curl -fsS -X POST "$API/api/v1/agent-bus/device/start")
+  DEVICE_CODE=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).device_code))')
+  VERIFY_URL=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).verify_url))')
+  INTERVAL=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).interval||3))')
+
+  echo "→ Opening your browser to log in:"
+  echo "    $VERIFY_URL"
+  ( command -v open >/dev/null 2>&1 && open "$VERIFY_URL" ) || echo "  (open the URL above manually)"
+
+  echo "→ Waiting for you to log in & authorize…"
+  TOKEN=""
+  for _ in $(seq 1 100); do
+    sleep "$INTERVAL"
+    POLL=$(curl -fsS -X POST "$API/api/v1/agent-bus/device/poll" \
+      -H 'Content-Type: application/json' -d "{\"device_code\":\"$DEVICE_CODE\"}")
+    STATUS=$(echo "$POLL" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).status||""))')
+    if [ "$STATUS" = "approved" ]; then
+      TOKEN=$(echo "$POLL" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).token||""))')
+      break
+    fi
+    [ "$STATUS" = "expired" ] && { echo "✗ Login expired. Re-run the installer."; exit 1; }
+  done
+  [ -n "$TOKEN" ] || { echo "✗ Timed out waiting for login."; exit 1; }
+  echo "✓ Logged in."
+fi
+
+# ── 2. install the bridge ──
+echo "→ Installing nexting-cc-bridge…"
+npm install -g nexting-cc-bridge >/dev/null 2>&1 || {
+  echo "  (npm global install unavailable — will run via npx instead)"
+}
+
+# ── 3. write config ──
+mkdir -p "$CFG_DIR"
+cat > "$CFG" <<EOF
+{
+  "url": "$WS_URL",
+  "token": "$TOKEN"
+}
+EOF
+chmod 600 "$CFG"
+echo "✓ Config written to $CFG"
+
+# ── 4. make `claude` phone-controllable (shim + PATH + hub daemon) ──
+# Delegates to `nexting-cc-bridge install`: installs the `claude` shim (so the
+# sessions you start are mirrored to + drivable from your phone), puts it on PATH,
+# and keeps the hub daemon alive via launchd. Reversible: nexting-cc-bridge uninstall.
+echo "→ Setting up the Claude Code manager…"
+# `install` also gates Boss Mode: it verifies the superpowers/gstack Claude Code
+# (Workflow tool + /loop) and exits non-zero if absent. Under `set -euo pipefail`
+# that aborts this script before the `Done.` line — install the required Claude
+# Code, then re-run this installer.
+if command -v nexting-cc-bridge >/dev/null 2>&1; then
+  nexting-cc-bridge install
+elif command -v npx >/dev/null 2>&1; then
+  npx -y nexting-cc-bridge install
+else
+  echo "✗ Could not run nexting-cc-bridge install (no global bin / npx)."; exit 1
+fi
+
+echo
+echo "Done. Run \`claude\` as usual — it now mirrors to your phone."
+echo "Open Nexting on your phone → Claude Code to see and control your sessions."
+echo "Bypass once with: NEXTING_CC_DISABLE=1 claude   ·   Remove with: nexting-cc-bridge uninstall"

package/install-codex.sh

@@ -0,0 +1,97 @@
+#!/usr/bin/env bash
+# Nexting Codex bridge installer.
+#   curl -fsSL https://nexting.ai/install-codex | bash
+# Logs you in to Nexting in your browser, installs the bridge, and makes your
+# Codex sessions visible and controllable from your phone. No shim needed —
+# a background daemon (launchd) pushes session snapshots to the cloud.
+# Fully reversible:  nexting-cc-bridge codex-uninstall
+set -euo pipefail
+
+API="${NEXTING_API:-https://api.nexting.ai}"
+WS_URL="${NEXTING_CODEX_URL:-wss://api.nexting.ai/codex-bridge/connect}"
+CFG_DIR="$HOME/.nexting"
+CFG="$CFG_DIR/codex-bridge.json"
+
+echo "→ Nexting Codex bridge installer"
+
+command -v node >/dev/null 2>&1 || { echo "✗ Node.js not found. Install it first (https://nodejs.org)."; exit 1; }
+
+command -v codex >/dev/null 2>&1 || {
+  echo "✗ Codex CLI not found. Install it: npm install -g @openai/codex, then run: codex login"
+  exit 1
+}
+echo "  (reminder: make sure you have run \`codex login\` before using Nexting Codex)"
+
+# ── 1. log in to Nexting (device-code browser flow = the binding) ──
+# Logging in IS the binding: the browser login authorizes this Mac for your
+# account, no separate step. A token may be supplied out-of-band via
+# NEXTING_CODEX_TOKEN to skip the browser login (e.g. an automated re-install).
+if [ -n "${NEXTING_CODEX_TOKEN:-}" ]; then
+  TOKEN="$NEXTING_CODEX_TOKEN"
+  echo "✓ Using the Nexting account token provided."
+else
+  echo "→ Logging you in to Nexting…"
+  START=$(curl -fsS -X POST "$API/api/v1/agent-bus/device/start")
+  DEVICE_CODE=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).device_code))')
+  VERIFY_URL=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).verify_url))')
+  INTERVAL=$(echo "$START" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).interval||3))')
+
+  echo "→ Opening your browser to log in:"
+  echo "    $VERIFY_URL"
+  ( command -v open >/dev/null 2>&1 && open "$VERIFY_URL" ) || echo "  (open the URL above manually)"
+
+  echo "→ Waiting for you to log in & authorize…"
+  TOKEN=""
+  for _ in $(seq 1 100); do
+    sleep "$INTERVAL"
+    POLL=$(curl -fsS -X POST "$API/api/v1/agent-bus/device/poll" \
+      -H 'Content-Type: application/json' -d "{\"device_code\":\"$DEVICE_CODE\"}")
+    STATUS=$(echo "$POLL" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).status||""))')
+    if [ "$STATUS" = "approved" ]; then
+      TOKEN=$(echo "$POLL" | node -e 'process.stdin.once("data",d=>console.log(JSON.parse(d).token||""))')
+      break
+    fi
+    [ "$STATUS" = "expired" ] && { echo "✗ Login expired. Re-run the installer."; exit 1; }
+  done
+  [ -n "$TOKEN" ] || { echo "✗ Timed out waiting for login."; exit 1; }
+  echo "✓ Logged in."
+fi
+
+# ── 2. install the bridge ──
+echo "→ Installing nexting-cc-bridge…"
+npm install -g nexting-cc-bridge >/dev/null 2>&1 || {
+  echo "  (npm global install unavailable — will run via npx instead)"
+}
+
+# ── 3. write config ──
+mkdir -p "$CFG_DIR"
+cat > "$CFG" <<EOF
+{
+  "url": "$WS_URL",
+  "token": "$TOKEN"
+}
+EOF
+chmod 600 "$CFG"
+echo "✓ Config written to $CFG"
+
+# ── 4. start the background daemon (launchd keeps it alive) ──
+# Delegates to `nexting-cc-bridge codex-install`: writes a launchd plist that
+# runs `nexting-cc-bridge codex-start` on login and keeps it alive. No shim,
+# no PATH change. Reversible: nexting-cc-bridge codex-uninstall.
+echo "→ Setting up the Codex bridge daemon…"
+# `codex-install` also gates Boss Mode: it verifies the superpowers/gstack Claude
+# Code (Workflow tool + /loop) and exits non-zero if absent. Under `set -euo
+# pipefail` that aborts this script before the `Done.` line — install the required
+# Claude Code, then re-run this installer.
+if command -v nexting-cc-bridge >/dev/null 2>&1; then
+  nexting-cc-bridge codex-install
+elif command -v npx >/dev/null 2>&1; then
+  npx -y nexting-cc-bridge codex-install
+else
+  echo "✗ Could not run nexting-cc-bridge codex-install (no global bin / npx)."; exit 1
+fi
+
+echo
+echo "Done. Your Codex sessions now appear on your phone."
+echo "Open Nexting on your phone → Claude Code to see and co-control your sessions."
+echo "Live co-control a folder: nexting-cc-bridge codex-run   ·   Remove: nexting-cc-bridge codex-uninstall"

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "nexting-cc-bridge",
+  "version": "0.8.3",
+  "description": "Nexting Claude Code bridge \u2014 runs Claude Code through a local hub so your phone mirrors and controls your terminal sessions (two-way synced).",
+  "type": "module",
+  "bin": {
+    "nexting-cc-bridge": "dist/cli.js"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "shim",
+    "install-cc.sh",
+    "install-codex.sh",
+    "README.md"
+  ],
+  "scripts": {
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "build": "tsc -p tsconfig.json && chmod +x dist/cli.js",
+    "prepublishOnly": "npm run build",
+    "dev": "node --import tsx src/cli.ts",
+    "devserver": "node --import tsx src/dev-server.ts"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "chokidar": "^3.6.0",
+    "https-proxy-agent": "^7.0.6",
+    "node-pty": "^1.1.0",
+    "ws": "^8.18.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.0.0",
+    "@types/ws": "^8.5.12",
+    "tsx": "^4.19.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}

package/shim/claude

@@ -0,0 +1,55 @@
+#!/usr/bin/env bash
+# Nexting Claude Code shim — installed to ~/.nexting/bin/claude and put first on
+# PATH so `claude` transparently runs through the phone-controllable hub.
+#
+# Your terminal experience is unchanged (native Claude Code TUI); the hub just
+# mirrors the session to your phone and lets the phone type into it.
+#
+# Escape hatch:  NEXTING_CC_DISABLE=1 claude   → runs claude normally, no hub.
+# Uninstall:     nexting-cc-bridge uninstall    → removes this shim + PATH entry.
+
+# Find the REAL claude (known install locations), never this shim.
+REAL=""
+for c in \
+  "$HOME/Library/pnpm/claude" \
+  "$HOME/.local/bin/claude" \
+  "$HOME/.npm-global/bin/claude" \
+  /opt/homebrew/bin/claude \
+  /usr/local/bin/claude; do
+  if [ -x "$c" ]; then REAL="$c"; break; fi
+done
+if [ -z "$REAL" ]; then
+  # Last resort: first `claude` on PATH that isn't this shim's dir.
+  REAL="$(command -v -a claude 2>/dev/null | grep -v "$HOME/.nexting/bin/claude" | head -1)"
+fi
+
+# Bypass when asked, or if we can't find the real claude or the bridge.
+if [ -n "${NEXTING_CC_DISABLE:-}" ] || [ -z "$REAL" ] || ! command -v nexting-cc-bridge >/dev/null 2>&1; then
+  exec "${REAL:-claude}" "$@"
+fi
+
+# Bypass the phone-mirroring hub for NON-INTERACTIVE usage. The hub wraps claude in
+# a pty so the phone can watch/drive it — wrong for scripted / piped / one-shot
+# runs, which a pty would slow down, hang, or make claude think it's interactive.
+# (a) stdin or stdout is not a TTY → piped / redirected / CI / script.
+if [ ! -t 0 ] || [ ! -t 1 ]; then
+  exec "$REAL" "$@"
+fi
+# (b) print mode (-p / --print) anywhere in the args → one-shot, no TUI.
+for arg in "$@"; do
+  case "$arg" in
+    -p | --print)
+      exec "$REAL" "$@"
+      ;;
+  esac
+done
+# (c) non-interactive subcommands / info flags → don't need the hub.
+case "${1:-}" in
+  mcp | config | doctor | update | install | --version | -v | --help | -h)
+    exec "$REAL" "$@"
+    ;;
+esac
+
+# Tell the hub shell exactly which binary to run (absolute → no shim recursion).
+export NEXTING_CC_CLAUDE_BIN="$REAL"
+exec nexting-cc-bridge term -- "$@"