@rehpic/vcli 0.1.0-beta.34.1 → 0.1.0-beta.35.1

package/dist/index.js

@@ -1,6 +1,12 @@
 #!/usr/bin/env node
 var __defProp = Object.defineProperty;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
 var __esm = (fn, res) => function __init() {
   return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
 };
@@ -436,16 +442,16 @@ function detectArchBinary(binary) {
   }
   return archBinary;
 }
-function detectPlatformBinary({ [platform]: platformBinary }, { wsl } = {}) {
+function detectPlatformBinary({ [platform2]: platformBinary }, { wsl } = {}) {
   if (wsl && is_wsl_default) {
     return detectArchBinary(wsl);
   }
   if (!platformBinary) {
-    throw new Error(`${platform} is not supported`);
+    throw new Error(`${platform2} is not supported`);
   }
   return detectArchBinary(platformBinary);
 }
-var fallbackAttemptSymbol, __dirname, localXdgOpenPath, platform, arch, tryEachApp, baseOpen, open, openApp, apps, open_default;
+var fallbackAttemptSymbol, __dirname2, localXdgOpenPath, platform2, arch, tryEachApp, baseOpen, open, openApp, apps, open_default;
 var init_open = __esm({
   "../../node_modules/.pnpm/open@11.0.0/node_modules/open/index.js"() {
     "use strict";
@@ -456,9 +462,9 @@ var init_open = __esm({
     init_is_inside_container();
     init_is_in_ssh();
     fallbackAttemptSymbol = Symbol("fallbackAttempt");
-    __dirname = import.meta.url ? path2.dirname(fileURLToPath(import.meta.url)) : "";
-    localXdgOpenPath = path2.join(__dirname, "xdg-open");
-    ({ platform, arch } = process8);
+    __dirname2 = import.meta.url ? path2.dirname(fileURLToPath(import.meta.url)) : "";
+    localXdgOpenPath = path2.join(__dirname2, "xdg-open");
+    ({ platform: platform2, arch } = process8);
     tryEachApp = async (apps2, opener) => {
       if (apps2.length === 0) {
         return;
@@ -555,7 +561,7 @@ var init_open = __esm({
       if (is_wsl_default && !isInsideContainer() && !is_in_ssh_default && !app) {
         shouldUseWindowsInWsl = await canAccessPowerShell();
       }
-      if (platform === "darwin") {
+      if (platform2 === "darwin") {
         command = "open";
         if (options.wait) {
           cliArguments.push("--wait-apps");
@@ -569,7 +575,7 @@ var init_open = __esm({
         if (app) {
           cliArguments.push("-a", app);
         }
-      } else if (platform === "win32" || shouldUseWindowsInWsl) {
+      } else if (platform2 === "win32" || shouldUseWindowsInWsl) {
         command = await powerShellPath2();
         cliArguments.push(...executePowerShell.argumentsPrefix);
         if (!is_wsl_default) {
@@ -602,14 +608,14 @@ var init_open = __esm({
         if (app) {
           command = app;
         } else {
-          const isBundled = !__dirname || __dirname === "/";
+          const isBundled = !__dirname2 || __dirname2 === "/";
           let exeLocalXdgOpen = false;
           try {
             await fs6.access(localXdgOpenPath, fsConstants3.X_OK);
             exeLocalXdgOpen = true;
           } catch {
           }
-          const useSystemXdgOpen = process8.versions.electron ?? (platform === "android" || isBundled || !exeLocalXdgOpen);
+          const useSystemXdgOpen = process8.versions.electron ?? (platform2 === "android" || isBundled || !exeLocalXdgOpen);
           command = useSystemXdgOpen ? "xdg-open" : localXdgOpenPath;
         }
         if (appArguments.length > 0) {
@@ -620,7 +626,7 @@ var init_open = __esm({
           childProcessOptions.detached = true;
         }
       }
-      if (platform === "darwin" && appArguments.length > 0) {
+      if (platform2 === "darwin" && appArguments.length > 0) {
         cliArguments.push("--args", ...appArguments);
       }
       if (options.target) {
@@ -736,9 +742,9 @@ var init_open = __esm({
 });
 
 // ../../src/cli/index.ts
-import { readFileSync } from "fs";
+import { readFileSync as readFileSync2 } from "fs";
 import { readFile as readFile2 } from "fs/promises";
-import { dirname, extname, join } from "path";
+import { dirname, extname, join as join2 } from "path";
 import { fileURLToPath as fileURLToPath2 } from "url";
 import { config as loadEnv } from "dotenv";
 import { Command } from "commander";
@@ -1094,7 +1100,413 @@ function createEmptySession() {
   };
 }
 
+// ../../src/cli/bridge-service.ts
+import { ConvexHttpClient as ConvexHttpClient2 } from "convex/browser";
+import { execSync } from "child_process";
+import {
+  existsSync,
+  mkdirSync,
+  readFileSync,
+  writeFileSync,
+  unlinkSync
+} from "fs";
+import { homedir as homedir2, hostname, platform } from "os";
+import { join } from "path";
+import { randomUUID } from "crypto";
+var CONFIG_DIR = join(homedir2(), ".vector");
+var BRIDGE_CONFIG_FILE = join(CONFIG_DIR, "bridge.json");
+var PID_FILE = join(CONFIG_DIR, "bridge.pid");
+var LIVE_ACTIVITIES_CACHE = join(CONFIG_DIR, "live-activities.json");
+var LAUNCHAGENT_DIR = join(homedir2(), "Library", "LaunchAgents");
+var LAUNCHAGENT_PLIST = join(LAUNCHAGENT_DIR, "com.vector.bridge.plist");
+var LAUNCHAGENT_LABEL = "com.vector.bridge";
+var HEARTBEAT_INTERVAL_MS = 3e4;
+var COMMAND_POLL_INTERVAL_MS = 5e3;
+var PROCESS_DISCOVERY_INTERVAL_MS = 6e4;
+function loadBridgeConfig() {
+  if (!existsSync(BRIDGE_CONFIG_FILE)) return null;
+  try {
+    return JSON.parse(readFileSync(BRIDGE_CONFIG_FILE, "utf-8"));
+  } catch {
+    return null;
+  }
+}
+function saveBridgeConfig(config) {
+  if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+  writeFileSync(BRIDGE_CONFIG_FILE, JSON.stringify(config, null, 2));
+}
+function discoverLocalProcesses() {
+  const processes = [];
+  const patterns = [
+    {
+      grep: "[c]laude",
+      provider: "claude_code",
+      label: "Claude",
+      prefix: "claude"
+    },
+    { grep: "[c]odex", provider: "codex", label: "Codex", prefix: "codex" }
+  ];
+  for (const { grep, provider, label, prefix } of patterns) {
+    try {
+      const ps = execSync(
+        `ps aux | grep -E '${grep}' | grep -v vector-bridge | grep -v grep`,
+        { encoding: "utf-8", timeout: 5e3 }
+      );
+      for (const line of ps.trim().split("\n").filter(Boolean)) {
+        const pid = line.split(/\s+/)[1];
+        if (!pid) continue;
+        let cwd;
+        try {
+          cwd = execSync(
+            `lsof -p ${pid} 2>/dev/null | grep cwd | awk '{print $NF}'`,
+            { encoding: "utf-8", timeout: 3e3 }
+          ).trim() || void 0;
+        } catch {
+        }
+        const gitInfo = cwd ? getGitInfo(cwd) : {};
+        processes.push({
+          provider,
+          providerLabel: label,
+          localProcessId: pid,
+          sessionKey: `${prefix}-${pid}`,
+          cwd,
+          ...gitInfo,
+          mode: "observed",
+          status: "observed",
+          supportsInboundMessages: false
+        });
+      }
+    } catch {
+    }
+  }
+  return processes;
+}
+function getGitInfo(cwd) {
+  try {
+    const branch = execSync("git rev-parse --abbrev-ref HEAD", {
+      encoding: "utf-8",
+      cwd,
+      timeout: 3e3
+    }).trim();
+    const repoRoot = execSync("git rev-parse --show-toplevel", {
+      encoding: "utf-8",
+      cwd,
+      timeout: 3e3
+    }).trim();
+    return { branch, repoRoot };
+  } catch {
+    return {};
+  }
+}
+function generateReply(userMessage) {
+  const lower = userMessage.toLowerCase().trim();
+  if (["hey", "hi", "hello"].includes(lower)) {
+    return "Hey! I'm running on your local machine via the Vector bridge. What would you like me to work on?";
+  }
+  if (lower.includes("status") || lower.includes("progress")) {
+    return "I'm making good progress. Currently reviewing the changes and running tests.";
+  }
+  if (lower.includes("stop") || lower.includes("cancel")) {
+    return "Understood \u2014 wrapping up the current step.";
+  }
+  return `Got it \u2014 "${userMessage}". I'll incorporate that into my current work.`;
+}
+var BridgeService = class {
+  constructor(config) {
+    this.timers = [];
+    this.config = config;
+    this.client = new ConvexHttpClient2(config.convexUrl);
+  }
+  async heartbeat() {
+    await this.client.mutation(api.agentBridge.bridgePublic.heartbeat, {
+      deviceId: this.config.deviceId,
+      deviceSecret: this.config.deviceSecret
+    });
+  }
+  async pollCommands() {
+    const commands = await this.client.query(
+      api.agentBridge.bridgePublic.getPendingCommands,
+      {
+        deviceId: this.config.deviceId,
+        deviceSecret: this.config.deviceSecret
+      }
+    );
+    if (commands.length > 0) {
+      console.log(`[${ts()}] ${commands.length} pending command(s)`);
+    }
+    for (const cmd of commands) {
+      await this.handleCommand(cmd);
+    }
+  }
+  async handleCommand(cmd) {
+    console.log(`  ${cmd.kind}: ${cmd._id}`);
+    if (cmd.kind === "message" && cmd.liveActivityId) {
+      const payload = cmd.payload;
+      const body = payload?.body ?? "";
+      console.log(`  > "${body}"`);
+      const reply = generateReply(body);
+      await this.client.mutation(
+        api.agentBridge.bridgePublic.postAgentMessage,
+        {
+          deviceId: this.config.deviceId,
+          deviceSecret: this.config.deviceSecret,
+          liveActivityId: cmd.liveActivityId,
+          role: "assistant",
+          body: reply
+        }
+      );
+      console.log(`  < "${reply.slice(0, 60)}..."`);
+    }
+    await this.client.mutation(api.agentBridge.bridgePublic.completeCommand, {
+      deviceId: this.config.deviceId,
+      deviceSecret: this.config.deviceSecret,
+      commandId: cmd._id,
+      status: "delivered"
+    });
+  }
+  async reportProcesses() {
+    const processes = discoverLocalProcesses();
+    for (const proc of processes) {
+      try {
+        await this.client.mutation(api.agentBridge.bridgePublic.reportProcess, {
+          deviceId: this.config.deviceId,
+          deviceSecret: this.config.deviceSecret,
+          ...proc
+        });
+      } catch {
+      }
+    }
+    if (processes.length > 0) {
+      console.log(`[${ts()}] Discovered ${processes.length} local process(es)`);
+    }
+  }
+  async refreshLiveActivities() {
+    try {
+      const activities = await this.client.query(
+        api.agentBridge.bridgePublic.getDeviceLiveActivities,
+        {
+          deviceId: this.config.deviceId,
+          deviceSecret: this.config.deviceSecret
+        }
+      );
+      writeFileSync(LIVE_ACTIVITIES_CACHE, JSON.stringify(activities, null, 2));
+    } catch {
+    }
+  }
+  async run() {
+    console.log("Vector Bridge Service");
+    console.log(
+      `  Device:  ${this.config.displayName} (${this.config.deviceId})`
+    );
+    console.log(`  Convex:  ${this.config.convexUrl}`);
+    console.log(`  PID:     ${process.pid}`);
+    console.log("");
+    if (!existsSync(CONFIG_DIR)) mkdirSync(CONFIG_DIR, { recursive: true });
+    writeFileSync(PID_FILE, String(process.pid));
+    await this.heartbeat();
+    await this.reportProcesses();
+    await this.refreshLiveActivities();
+    console.log(`[${ts()}] Service running. Ctrl+C to stop.
+`);
+    this.timers.push(
+      setInterval(() => {
+        this.heartbeat().catch(
+          (e) => console.error(`[${ts()}] Heartbeat error:`, e.message)
+        );
+        this.refreshLiveActivities().catch(() => {
+        });
+      }, HEARTBEAT_INTERVAL_MS)
+    );
+    this.timers.push(
+      setInterval(() => {
+        this.pollCommands().catch(
+          (e) => console.error(`[${ts()}] Command poll error:`, e.message)
+        );
+      }, COMMAND_POLL_INTERVAL_MS)
+    );
+    this.timers.push(
+      setInterval(() => {
+        this.reportProcesses().catch(
+          (e) => console.error(`[${ts()}] Discovery error:`, e.message)
+        );
+      }, PROCESS_DISCOVERY_INTERVAL_MS)
+    );
+    const shutdown = () => {
+      console.log(`
+[${ts()}] Shutting down...`);
+      for (const t of this.timers) clearInterval(t);
+      try {
+        unlinkSync(PID_FILE);
+      } catch {
+      }
+      process.exit(0);
+    };
+    process.on("SIGINT", shutdown);
+    process.on("SIGTERM", shutdown);
+    await new Promise(() => {
+    });
+  }
+};
+async function setupBridgeDevice(convexUrl, userId) {
+  const client = new ConvexHttpClient2(convexUrl);
+  const deviceKey = `${hostname()}-${randomUUID().slice(0, 8)}`;
+  const deviceSecret = randomUUID();
+  const displayName = `${process.env.USER ?? "user"}'s ${platform() === "darwin" ? "Mac" : "machine"}`;
+  const result = await client.mutation(
+    api.agentBridge.bridgePublic.setupDevice,
+    {
+      userId,
+      deviceKey,
+      deviceSecret,
+      displayName,
+      hostname: hostname(),
+      platform: platform(),
+      cliVersion: "0.1.0",
+      capabilities: ["codex", "claude_code"]
+    }
+  );
+  const config = {
+    deviceId: result.deviceId,
+    deviceKey,
+    deviceSecret,
+    userId,
+    displayName,
+    convexUrl,
+    registeredAt: (/* @__PURE__ */ new Date()).toISOString()
+  };
+  saveBridgeConfig(config);
+  return config;
+}
+function installLaunchAgent(vcliPath) {
+  if (platform() !== "darwin") {
+    console.error("LaunchAgent is macOS only. Use systemd on Linux.");
+    return;
+  }
+  const plist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCHAGENT_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${vcliPath}</string>
+    <string>service</string>
+    <string>start</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${CONFIG_DIR}/bridge.log</string>
+  <key>StandardErrorPath</key>
+  <string>${CONFIG_DIR}/bridge.err.log</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>/usr/local/bin:/opt/homebrew/bin:/usr/bin:/bin</string>
+  </dict>
+</dict>
+</plist>`;
+  const menuBarBinary = join(
+    __dirname,
+    "..",
+    "..",
+    "cli",
+    "macos",
+    "VectorMenuBar"
+  );
+  if (existsSync(menuBarBinary)) {
+    const menuBarPlist = `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>com.vector.menubar</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${menuBarBinary}</string>
+  </array>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <false/>
+</dict>
+</plist>`;
+    const menuBarPlistPath = join(LAUNCHAGENT_DIR, "com.vector.menubar.plist");
+    writeFileSync(menuBarPlistPath, menuBarPlist);
+    try {
+      execSync(`launchctl load ${menuBarPlistPath}`, { stdio: "pipe" });
+      console.log("Menu bar helper installed.");
+    } catch {
+    }
+  }
+  if (!existsSync(LAUNCHAGENT_DIR)) {
+    mkdirSync(LAUNCHAGENT_DIR, { recursive: true });
+  }
+  writeFileSync(LAUNCHAGENT_PLIST, plist);
+  console.log(`Installed LaunchAgent: ${LAUNCHAGENT_PLIST}`);
+}
+function loadLaunchAgent() {
+  try {
+    execSync(`launchctl load ${LAUNCHAGENT_PLIST}`, { stdio: "inherit" });
+    console.log(
+      "LaunchAgent loaded. Bridge will start automatically on login."
+    );
+  } catch {
+    console.error("Failed to load LaunchAgent");
+  }
+}
+function unloadLaunchAgent() {
+  try {
+    execSync(`launchctl unload ${LAUNCHAGENT_PLIST}`, { stdio: "inherit" });
+    console.log("LaunchAgent unloaded.");
+  } catch {
+    console.error("Failed to unload LaunchAgent (may not be loaded)");
+  }
+}
+function uninstallLaunchAgent() {
+  unloadLaunchAgent();
+  try {
+    unlinkSync(LAUNCHAGENT_PLIST);
+    console.log("LaunchAgent removed.");
+  } catch {
+  }
+}
+function getBridgeStatus() {
+  const config = loadBridgeConfig();
+  if (!config) return { configured: false, running: false };
+  let running = false;
+  let pid;
+  if (existsSync(PID_FILE)) {
+    const pidStr = readFileSync(PID_FILE, "utf-8").trim();
+    pid = Number(pidStr);
+    try {
+      process.kill(pid, 0);
+      running = true;
+    } catch {
+      running = false;
+    }
+  }
+  return { configured: true, running, pid, config };
+}
+function stopBridge() {
+  if (!existsSync(PID_FILE)) return false;
+  const pid = Number(readFileSync(PID_FILE, "utf-8").trim());
+  try {
+    process.kill(pid, "SIGTERM");
+    return true;
+  } catch {
+    return false;
+  }
+}
+function ts() {
+  return (/* @__PURE__ */ new Date()).toLocaleTimeString();
+}
+
 // ../../src/cli/index.ts
+import { platform as osPlatform } from "os";
 loadEnv({ path: ".env.local", override: false });
 loadEnv({ path: ".env", override: false });
 var cliApi = {
@@ -1537,7 +1949,7 @@ var program = new Command();
 function readPackageVersionSync() {
   try {
     const dir = import.meta.dirname ?? dirname(fileURLToPath2(import.meta.url));
-    const raw = readFileSync(join(dir, "..", "package.json"), "utf8");
+    const raw = readFileSync2(join2(dir, "..", "package.json"), "utf8");
     return JSON.parse(raw).version ?? "unknown";
   } catch {
     return "unknown";
@@ -1999,6 +2411,75 @@ permissionCommand.command("check-many <permissions>").option("--team <teamKey>")
   printOutput(result, runtime.json);
 });
 var activityCommand = program.command("activity").description("Activity feed");
+activityCommand.command("list").description(
+  "List org-wide activity with optional filters by entity type, event type, and time range"
+).option(
+  "--entity-type <type>",
+  "Filter by entity type: issue, project, team, document"
+).option(
+  "--event-type <type>",
+  "Filter by event type (e.g. issue_created, issue_priority_changed)"
+).option(
+  "--since <datetime>",
+  "Start of time range (ISO date or shorthand: today, yesterday, 7d, 30d)"
+).option(
+  "--until <datetime>",
+  "End of time range (ISO date or shorthand: today, now)"
+).option("--limit <n>").option("--cursor <cursor>").action(async (options, command) => {
+  const { client, runtime } = await getClient(command);
+  const orgSlug = requireOrg(runtime);
+  function parseTimeArg(value, bound) {
+    if (!value) return void 0;
+    const now = /* @__PURE__ */ new Date();
+    const startOfToday = new Date(
+      now.getFullYear(),
+      now.getMonth(),
+      now.getDate()
+    );
+    const endOfToday = new Date(
+      now.getFullYear(),
+      now.getMonth(),
+      now.getDate(),
+      23,
+      59,
+      59,
+      999
+    );
+    switch (value) {
+      case "now":
+        return now.getTime();
+      case "today":
+        return bound === "start" ? startOfToday.getTime() : endOfToday.getTime();
+      case "yesterday":
+        return bound === "start" ? startOfToday.getTime() - 864e5 : startOfToday.getTime() - 1;
+      default: {
+        const daysMatch = value.match(/^(\d+)d$/);
+        if (daysMatch) {
+          return now.getTime() - Number(daysMatch[1]) * 864e5;
+        }
+        const parsed = new Date(value).getTime();
+        if (Number.isNaN(parsed)) {
+          throw new Error(`Invalid time value: ${value}`);
+        }
+        return parsed;
+      }
+    }
+  }
+  const result = await runQuery(
+    client,
+    api.activities.queries.listOrgActivity,
+    {
+      orgSlug,
+      entityType: options.entityType ?? void 0,
+      eventType: options.eventType ?? void 0,
+      since: parseTimeArg(options.since, "start"),
+      until: parseTimeArg(options.until, "end"),
+      limit: optionalNumber(options.limit, "limit") ?? void 0,
+      cursor: options.cursor ?? void 0
+    }
+  );
+  printOutput(result, runtime.json);
+});
 activityCommand.command("project <projectKey>").option("--limit <n>").option("--cursor <cursor>").action(async (projectKey, options, command) => {
   const { client, runtime } = await getClient(command);
   const orgSlug = requireOrg(runtime);
@@ -2664,13 +3145,14 @@ projectCommand.command("set-lead <projectKey> <member>").action(async (projectKe
   printOutput(result, runtime.json);
 });
 var issueCommand = program.command("issue").description("Issues");
-issueCommand.command("list [slug]").option("--project <projectKey>").option("--team <teamKey>").option("--limit <n>").option("--created-after <date>", "Filter: created on or after date (ISO)").option("--created-before <date>", "Filter: created on or before date (ISO)").option("--sort <field>", "Sort by field (e.g. createdAt, title, key)").option("--order <direction>", "Sort order: asc or desc (default: asc)").action(async (slug, options, command) => {
+issueCommand.command("list [slug]").option("--project <projectKey>").option("--team <teamKey>").option("--assignee <name>", "Filter by assignee name or email").option("--limit <n>").option("--created-after <date>", "Filter: created on or after date (ISO)").option("--created-before <date>", "Filter: created on or before date (ISO)").option("--sort <field>", "Sort by field (e.g. createdAt, title, key)").option("--order <direction>", "Sort order: asc or desc (default: asc)").action(async (slug, options, command) => {
   const { client, runtime } = await getClient(command);
   const orgSlug = requireOrg(runtime, slug);
   const raw = await runAction(client, cliApi.listIssues, {
     orgSlug,
     projectKey: options.project,
-    teamKey: options.team
+    teamKey: options.team,
+    assigneeName: options.assignee
   });
   const filtered = applyListFilters(raw, options);
   const result = addEntityUrls(filtered, runtime.appUrl, orgSlug, "issues");
@@ -3014,6 +3496,129 @@ folderCommand.command("delete <folderId>").action(async (folderId, _options, com
   });
   printOutput(result, runtime.json);
 });
+var serviceCommand = program.command("service").description("Manage the local bridge service");
+serviceCommand.command("start").description("Run the bridge service in the foreground").action(async (_options, command) => {
+  let config = loadBridgeConfig();
+  if (!config) {
+    const runtime = await getRuntime(command);
+    const session = requireSession(runtime);
+    const client = await createConvexClient(
+      session,
+      runtime.appUrl,
+      runtime.convexUrl
+    );
+    const user = await runQuery(client, api.users.currentUser);
+    if (!user) throw new Error("Not logged in. Run `vcli auth login` first.");
+    config = await setupBridgeDevice(runtime.convexUrl, user._id);
+    console.log(`Device registered: ${config.deviceId}`);
+  }
+  const bridge = new BridgeService(config);
+  await bridge.run();
+});
+serviceCommand.command("stop").description("Stop the running bridge service").action(() => {
+  if (stopBridge()) {
+    console.log("Bridge stopped.");
+  } else {
+    console.log("Bridge is not running.");
+  }
+});
+serviceCommand.command("status").description("Show bridge service status").action((_options, command) => {
+  const status = getBridgeStatus();
+  if (!status.configured) {
+    console.log("Bridge not configured. Run: vcli service start");
+    return;
+  }
+  console.log("Vector Bridge");
+  console.log(
+    `  Device:  ${status.config.displayName} (${status.config.deviceId})`
+  );
+  console.log(`  User:    ${status.config.userId}`);
+  console.log(
+    `  Status:  ${status.running ? `Running (PID ${status.pid})` : "Not running"}`
+  );
+  console.log(`  Config:  ~/.vector/bridge.json`);
+});
+serviceCommand.command("install").description("Install the bridge as a system service (macOS LaunchAgent)").action(async (_options, command) => {
+  if (osPlatform() !== "darwin") {
+    console.error("Service install is currently macOS only (LaunchAgent).");
+    console.error("On Linux, use systemd --user manually for now.");
+    return;
+  }
+  const vcliPath = process.argv[1] ?? "vcli";
+  installLaunchAgent(vcliPath);
+  loadLaunchAgent();
+});
+serviceCommand.command("uninstall").description("Uninstall the bridge system service").action(() => {
+  uninstallLaunchAgent();
+});
+serviceCommand.command("logs").description("Show bridge service logs").action(() => {
+  const { existsSync: exists, readFileSync: read } = __require("fs");
+  const logPath = __require("path").join(
+    __require("os").homedir(),
+    ".vector",
+    "bridge.log"
+  );
+  if (exists(logPath)) {
+    const content = read(logPath, "utf-8");
+    const lines = content.split("\n");
+    console.log(lines.slice(-50).join("\n"));
+  } else {
+    console.log("No log file found at ~/.vector/bridge.log");
+  }
+});
+var bridgeCommand = program.command("bridge").description("Start/stop the local agent bridge");
+bridgeCommand.command("start").description("Register device, install service, and start the bridge").action(async (_options, command) => {
+  let config = loadBridgeConfig();
+  if (!config) {
+    const runtime = await getRuntime(command);
+    const session = requireSession(runtime);
+    const client = await createConvexClient(
+      session,
+      runtime.appUrl,
+      runtime.convexUrl
+    );
+    const user = await runQuery(client, api.users.currentUser);
+    if (!user) throw new Error("Not logged in. Run `vcli auth login` first.");
+    config = await setupBridgeDevice(runtime.convexUrl, user._id);
+    console.log(
+      `Device registered: ${config.displayName} (${config.deviceId})`
+    );
+  }
+  if (osPlatform() === "darwin") {
+    const vcliPath = process.argv[1] ?? "vcli";
+    installLaunchAgent(vcliPath);
+    loadLaunchAgent();
+    console.log("\nBridge installed and started as LaunchAgent.");
+    console.log("It will restart automatically on login.");
+    console.log("Run `vcli service status` to check.");
+  } else {
+    console.log("Starting bridge in foreground...");
+    const bridge = new BridgeService(config);
+    await bridge.run();
+  }
+});
+bridgeCommand.command("stop").description("Stop the bridge service").action(() => {
+  if (osPlatform() === "darwin") {
+    uninstallLaunchAgent();
+  }
+  if (stopBridge()) {
+    console.log("Bridge stopped.");
+  } else {
+    console.log("Bridge is not running.");
+  }
+});
+bridgeCommand.command("status").description("Show bridge status").action(() => {
+  const s = getBridgeStatus();
+  if (!s.configured) {
+    console.log("Bridge not configured. Run: vcli bridge start");
+    return;
+  }
+  console.log("Vector Bridge");
+  console.log(`  Device:  ${s.config.displayName} (${s.config.deviceId})`);
+  console.log(
+    `  Status:  ${s.running ? `Running (PID ${s.pid})` : "Not running"}`
+  );
+});
 async function main() {
   await program.parseAsync(process.argv);
 }