@gleapai/kai-bridge 0.2.0

package/README.md

@@ -0,0 +1,45 @@
+# kai-bridge
+
+Run [Gleap Kai Code](https://gleap.io) sessions on your own machine — with your own
+Claude Code / Codex login — and preview your real dev servers from the dashboard or the
+Gleap app on your phone.
+
+```bash
+npm i -g @gleapai/kai-bridge   # one install, so the background service has a stable path
+kai-bridge login             # pair this machine with your Gleap account
+kai-bridge install           # run at login (launchd / systemd / Task Scheduler)
+kai-bridge status
+```
+
+(`npx @gleapai/kai-bridge login` works for a quick look, but `install` needs the
+global install — npm garbage-collects the npx cache, which would leave the
+background service pointing at a deleted file.)
+
+Then pick **Run on → your machine** in any Kai Code session. Repos are discovered
+automatically under `~/Documents`, `~/code`, `~/dev`, `~/Projects`, `~/src` (add more with
+`kai-bridge repo roots add <dir>`); each session runs in an isolated worktree under
+`~/.kai/worktrees` unless you choose "Work in my checkout".
+
+## Accounts
+
+The bridge runs the official `claude` / `codex` binaries installed on your machine under
+**your** login (`ambient` profile). Add a second account with a managed profile:
+
+```bash
+kai-bridge profile add personal --harness claude
+kai-bridge profile login personal
+```
+
+Your harness logins never leave the machine; the bridge stores only its pairing token
+(`~/.kai/config.json`).
+
+## Local dry run
+
+```bash
+kai-bridge run --task "Explain the auth flow in this repo" --cwd ~/code/my-app
+```
+
+## Development
+
+`npm run sync-runner` copies the ACP runner from a sibling `gleap_code_analyzer` checkout;
+`npm test` runs the unit suite (uses real `git`).

package/bin/kai-bridge.mjs

@@ -0,0 +1,275 @@
+#!/usr/bin/env node
+// kai-bridge — run Gleap Kai Code on this machine.
+//
+//   kai-bridge setup                 guided onboarding: pair · background service · harness sign-ins
+//                                    (a bare `kai-bridge` on an unpaired machine runs it too)
+//   kai-bridge login | logout        pair this device with your Gleap account / disconnect it
+//   kai-bridge install | uninstall   run at login (launchd / systemd / Task Scheduler)
+//   kai-bridge start                 run in the foreground (what the service runs)
+//   kai-bridge status                device, service, profiles, repos
+//   kai-bridge harness list|install <id>|login <id>      Claude Code + Codex are bundled; Cursor is downloaded
+//   kai-bridge profile list|add <id> --harness claude|codex|cursor [--label …]|login <id>|remove <id>
+//   kai-bridge repo scan|roots [add <dir>|remove <dir>]|primary <repoKey> <path>
+//   kai-bridge run --task "…" [--model …] [--profile …] [--cwd …]   (local turn, no server)
+//   kai-bridge doctor
+
+import { spawn } from "node:child_process";
+import { mkdtempSync } from "node:fs";
+import { tmpdir } from "node:os";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+
+import { KAI_HOME, loadConfig, saveConfig } from "../src/config.mjs";
+import { logout, pairDevice, runSetup } from "../src/setup.mjs";
+import { BridgeDaemon, createLogger, resolveProfiles } from "../src/daemon.mjs";
+import { runTurn } from "../src/executor.mjs";
+import { HARNESSES, createManagedProfile, describeProfiles, findBinary, loginCommand } from "../src/profiles.mjs";
+import { defaultRoots, groupByRepo, scanRoots, toDeviceRepoReport } from "../src/repos.mjs";
+import { install, isInstalled, uninstall, isEphemeralBinPath } from "../src/service.mjs";
+import { HARNESS_INFO, describeHarnesses, installHarness } from "../src/harnesses.mjs";
+
+const BIN = fileURLToPath(import.meta.url);
+const argv = process.argv.slice(2);
+const cmd = argv[0];
+const flags = {};
+const positional = [];
+for (let i = 1; i < argv.length; i++) {
+  const a = argv[i];
+  if (a.startsWith("--")) {
+    const [k, v] = a.slice(2).split("=");
+    flags[k] = v ?? (argv[i + 1] && !argv[i + 1].startsWith("--") ? argv[++i] : true);
+  } else positional.push(a);
+}
+const out = (s) => process.stdout.write(s + "\n");
+const fail = (s) => {
+  process.stderr.write(`error: ${s}\n`);
+  process.exit(1);
+};
+
+async function login() {
+  const config = loadConfig();
+  await pairDevice({ config, name: flags.name, print: out });
+  out(`Next: \`kai-bridge install\` keeps it running at login. \`kai-bridge start\` runs it right now.`);
+}
+
+async function status() {
+  const config = loadConfig();
+  out(`home:     ${KAI_HOME}`);
+  out(`device:   ${config.device ? `${config.device.name} (${config.device.id})` : "not paired — run `kai-bridge login`"}`);
+  out(`service:  ${isInstalled() ? "installed" : "not installed — run `kai-bridge install`"}`);
+  out("harnesses:");
+  for (const h of describeHarnesses(KAI_HOME)) out(`  ${h.id.padEnd(8)} ${h.installed ? `installed ${h.version ?? ""}` : "not installed — kai-bridge harness install " + h.id}${h.bundled ? " (bundled)" : ""}`);
+  const profiles = await describeProfiles(resolveProfiles(config));
+  out("profiles:");
+  for (const p of profiles) out(`  ${p.id.padEnd(18)} ${p.harness.padEnd(7)} ${p.authState.padEnd(14)} ${p.account ?? ""} ${p.version ? `(${p.version})` : ""}`);
+  const groups = groupByRepo(scanRoots([...defaultRoots(), ...(config.roots || [])]), config.primaryOverrides);
+  out(`repos (${groups.length}):`);
+  for (const r of toDeviceRepoReport(groups)) out(`  ${r.key.padEnd(48)} ${r.primaryPath}${r.checkouts > 1 ? ` (+${r.checkouts - 1})` : ""} ${r.dirtyCount ? `· ${r.dirtyCount} dirty` : ""}`);
+}
+
+async function profile() {
+  const config = loadConfig();
+  const sub = positional[0];
+  if (sub === "list" || !sub) {
+    for (const p of await describeProfiles(resolveProfiles(config))) out(`${p.id}\t${p.harness}\t${p.kind}\t${p.authState}\t${p.account ?? ""}`);
+    return;
+  }
+  if (sub === "add") {
+    const id = positional[1];
+    const harness = flags.harness;
+    if (!id || !HARNESSES.includes(harness)) fail("usage: profile add <id> --harness claude|codex [--label …]");
+    if (config.profiles.some((p) => p.id === id)) fail(`profile ${id} exists`);
+    createManagedProfile(harness, id, KAI_HOME);
+    config.profiles.push({ id, harness, kind: "managed", label: flags.label || `${harness} (${id})` });
+    saveConfig(config);
+    out(`Added managed profile ${id}. Sign in with: kai-bridge profile login ${id}`);
+    return;
+  }
+  if (sub === "login") {
+    const p = resolveProfiles(config).find((x) => x.id === positional[1]);
+    if (!p) fail("unknown profile");
+    const c = loginCommand(p.harness, p.configDir);
+    if (!c) fail(`${p.harness} is not installed`);
+    const child = spawn(c.cmd, c.args, { env: c.env, stdio: "inherit" });
+    child.on("close", (code) => process.exit(code ?? 0));
+    return;
+  }
+  if (sub === "remove") {
+    config.profiles = config.profiles.filter((p) => p.id !== positional[1]);
+    saveConfig(config);
+    out("removed (the login dir is kept under ~/.kai/accounts)");
+    return;
+  }
+  fail("usage: profile list|add|login|remove");
+}
+
+async function harness() {
+  const sub = positional[0] || "list";
+  if (sub === "list") {
+    for (const h of describeHarnesses(KAI_HOME)) out(`${h.id.padEnd(8)} ${h.label.padEnd(12)} ${h.installed ? "installed" : "not installed"} ${h.version ?? ""}${h.bundled ? " (bundled)" : ""}${h.localOnly ? " · local only" : ""}`);
+    return;
+  }
+  const id = positional[1];
+  if (!HARNESS_INFO[id]) fail("usage: harness list|install <claude|codex|cursor>|login <id>");
+  if (sub === "install" || sub === "update") {
+    const res = await installHarness(id, { kaiHome: KAI_HOME, onLog: out });
+    if (!res.ok) fail(`${id} is not usable`);
+    out(`${HARNESS_INFO[id].label} ${res.version} → ${res.binary}`);
+    return;
+  }
+  if (sub === "login") {
+    positional[1] = `${id}-ambient`;
+    positional[0] = "login";
+    return profile();
+  }
+  fail("usage: harness list|install <id>|login <id>");
+}
+
+async function repo() {
+  const config = loadConfig();
+  const sub = positional[0] || "scan";
+  if (sub === "scan") {
+    const groups = groupByRepo(scanRoots([...defaultRoots(), ...(config.roots || [])]), config.primaryOverrides);
+    for (const r of toDeviceRepoReport(groups)) out(`${r.key}\t${r.primaryPath}\t${r.branch}`);
+    return;
+  }
+  if (sub === "roots") {
+    if (positional[1] === "add") {
+      config.roots = [...new Set([...(config.roots || []), resolve(positional[2])])];
+      saveConfig(config);
+    } else if (positional[1] === "remove") {
+      config.roots = (config.roots || []).filter((r) => r !== resolve(positional[2]));
+      saveConfig(config);
+    }
+    for (const r of [...defaultRoots(), ...(config.roots || [])]) out(r);
+    return;
+  }
+  if (sub === "primary") {
+    config.primaryOverrides = { ...(config.primaryOverrides || {}), [positional[1]]: resolve(positional[2]) };
+    saveConfig(config);
+    out("ok");
+    return;
+  }
+  fail("usage: repo scan|roots [add|remove <dir>]|primary <repoKey> <path>");
+}
+
+async function runLocal() {
+  if (!flags.task) fail("usage: run --task \"…\" [--model anthropic/claude-sonnet-4-6] [--profile claude-ambient] [--cwd .]");
+  const config = loadConfig();
+  const profile = resolveProfiles(config).find((p) => p.id === (flags.profile || "claude-ambient"));
+  if (!profile) fail("unknown profile");
+  const model = flags.model || (profile.harness === "codex" ? "openai/gpt-5.5" : "anthropic/claude-sonnet-4-6");
+  const cwd = resolve(flags.cwd || process.cwd());
+  const res = await runTurn({
+    turn: { task: flags.task, model, engineModelSlug: model.split("/").slice(1).join("/"), effort: flags.effort, agent: flags.agent, harness: profile.harness },
+    profile,
+    workDir: cwd,
+    onEvent: (ev) => {
+      if (ev.type === "text" || ev.type === "plan") out(`\n${ev.message}`);
+      else if (ev.type === "tool_status" && ev.toolStatus === "running") out(`▸ ${ev.message}`);
+      else if (ev.type === "error") process.stderr.write(`✖ ${ev.message}\n`);
+      else if (ev.type === "result") out(`\n— ${ev.inputTokens ?? 0} in / ${ev.outputTokens ?? 0} out${ev.costUsd != null ? ` · $${ev.costUsd.toFixed(4)}` : ""} · session ${ev.sessionId}`);
+    },
+    onLog: (l) => {
+      if (process.env.KAI_RUNNER_DEBUG === "1") process.stderr.write(l);
+    },
+  });
+  process.exit(res.code ?? 0);
+}
+
+async function doctor() {
+  out(`node:    ${process.version}`);
+  out(`claude:  ${findBinary("claude") ?? "not found (npm i -g @anthropic-ai/claude-code)"}`);
+  out(`codex:   ${findBinary("codex") ?? "not found (npm i -g @openai/codex)"}`);
+  out(`git:     ${findBinary("git") ?? "not found"}`);
+  out(`home:    ${KAI_HOME}`);
+  await status();
+}
+
+try {
+  switch (cmd) {
+    case "login":
+      await login();
+      break;
+    case "setup":
+      await runSetup({ binPath: BIN });
+      break;
+    case "logout":
+      await logout();
+      break;
+    case "install": {
+      if (isEphemeralBinPath(BIN)) {
+        fail(
+          "Running from npx, so there's no stable path to install from.\n" +
+            "Install it once, then this works:\n\n" +
+            "  npm i -g @gleapai/kai-bridge\n  kai-bridge install\n",
+        );
+      }
+      const res = install({ binPath: BIN, logDir: join(KAI_HOME, "logs") });
+      out(`Installed (${res.kind}): ${res.path}. It runs at login and restarts if it crashes.`);
+      break;
+    }
+    case "uninstall":
+      out(uninstall() ? "Removed." : "Nothing to remove.");
+      break;
+    case "start": {
+      process.env.KAI_BRIDGE_FOREGROUND = process.stdout.isTTY ? "1" : "0";
+      const daemon = new BridgeDaemon({ log: createLogger() });
+      await daemon.start();
+      const stop = () => {
+        // Give in-flight turns a moment to post their result before the
+        // process dies; a hard exit here is what left sessions spinning.
+        daemon.stop();
+        setTimeout(() => process.exit(0), 3_000).unref?.();
+      };
+      process.on("SIGINT", stop);
+      process.on("SIGTERM", stop);
+      break;
+    }
+    case "status":
+      await status();
+      break;
+    case "profile":
+      await profile();
+      break;
+    case "harness":
+      await harness();
+      break;
+    case "repo":
+      await repo();
+      break;
+    case "run":
+      await runLocal();
+      break;
+    case "doctor":
+      await doctor();
+      break;
+    default: {
+      // A bare `kai-bridge` in a terminal IS the setup — first run pairs,
+      // later runs open with keep / reconnect / log out, so it doubles as
+      // "manage this machine". Help lives on `kai-bridge help` (and on any
+      // non-TTY invocation, where a wizard could never prompt).
+      if (!cmd && process.stdin.isTTY) {
+        await runSetup({ binPath: BIN });
+        break;
+      }
+      out(`kai-bridge — run Gleap Kai Code on this machine
+
+  setup                            guided onboarding (pair · service · sign-ins)
+  login | logout | install | uninstall | start | status | doctor
+  harness list|install <id>|login <id>
+  profile list|add <id> --harness claude|codex|cursor|login <id>|remove <id>
+  repo scan|roots [add|remove <dir>]|primary <repoKey> <path>
+  run --task "…" [--model …] [--profile …] [--cwd …]`);
+    }
+  }
+} catch (err) {
+  // Revoked pairing under the background service: exit 0 so launchd
+  // records a deliberate stop instead of crash-restarting into an
+  // endless loop of 403s. Interactively it stays a visible failure.
+  if (err?.code === "REVOKED" && !process.stdout.isTTY) {
+    process.stderr.write(`${err.message}\n`);
+    process.exit(0);
+  }
+  fail(err?.message ?? String(err));
+}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@gleapai/kai-bridge",
+  "version": "0.2.0",
+  "description": "Run Gleap Kai Code sessions on your own machine with your own Claude Code / Codex login — and preview your real dev servers from the dashboard or the phone.",
+  "type": "module",
+  "license": "MIT",
+  "bin": {
+    "kai-bridge": "bin/kai-bridge.mjs"
+  },
+  "files": [
+    "bin",
+    "src",
+    "runner",
+    "scripts/postinstall.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test 'test/**/*.test.mjs'",
+    "sync-runner": "node scripts/sync-runner.mjs",
+    "postinstall": "node scripts/postinstall.mjs"
+  },
+  "dependencies": {
+    "@agentclientprotocol/claude-agent-acp": "0.70.0",
+    "@agentclientprotocol/codex-acp": "1.6.2",
+    "@agentclientprotocol/sdk": "1.4.0",
+    "@playwright/mcp": "^0.0.79",
+    "@sockudo/client": "^2.0.0",
+    "chokidar": "^4.0.1",
+    "yaml": "^2.9.0"
+  },
+  "overrides": {
+    "@anthropic-ai/claude-agent-sdk": "0.3.245"
+  },
+  "exports": {
+    ".": "./src/daemon.mjs",
+    "./src/*": "./src/*",
+    "./runner/*": "./runner/*"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/GleapSDK/kai-bridge.git"
+  },
+  "homepage": "https://gleap.io"
+}