@locusai/cli 0.15.4 → 0.15.5

package/bin/locus.js

@@ -43451,9 +43451,9 @@ var init_progress_renderer = __esm(() => {
 });
 
 // src/repl/image-detect.ts
-import { copyFileSync, existsSync as existsSync18, mkdirSync as mkdirSync8 } from "node:fs";
-import { homedir as homedir2, tmpdir as tmpdir2 } from "node:os";
-import { basename as basename2, join as join18 } from "node:path";
+import { copyFileSync, existsSync as existsSync20, mkdirSync as mkdirSync9 } from "node:fs";
+import { homedir as homedir4, tmpdir as tmpdir2 } from "node:os";
+import { basename as basename2, join as join20 } from "node:path";
 function hasImageExtension(p) {
   const dot = p.lastIndexOf(".");
   if (dot === -1)
@@ -43466,16 +43466,16 @@ function resolvePath(raw) {
     p = p.slice(1, -1);
   }
   if (p.startsWith("~/")) {
-    p = homedir2() + p.slice(1);
+    p = homedir4() + p.slice(1);
   }
   return p;
 }
 function copyToStable(srcPath) {
   try {
-    mkdirSync8(STABLE_IMAGE_DIR, { recursive: true });
+    mkdirSync9(STABLE_IMAGE_DIR, { recursive: true });
     const ts = Date.now();
     const name = `${ts}-${basename2(srcPath)}`;
-    const destPath = join18(STABLE_IMAGE_DIR, name);
+    const destPath = join20(STABLE_IMAGE_DIR, name);
     copyFileSync(srcPath, destPath);
     return destPath;
   } catch {
@@ -43495,7 +43495,7 @@ function detectImages(input) {
     let exists = false;
     let stablePath = normalized;
     try {
-      exists = existsSync18(normalized);
+      exists = existsSync20(normalized);
     } catch {}
     if (exists) {
       const copied = copyToStable(normalized);
@@ -43569,7 +43569,7 @@ var init_image_detect = __esm(() => {
     ".tif",
     ".tiff"
   ]);
-  STABLE_IMAGE_DIR = join18(tmpdir2(), "locus-images");
+  STABLE_IMAGE_DIR = join20(tmpdir2(), "locus-images");
 });
 
 // src/repl/input-handler.ts
@@ -44783,1972 +44783,2034 @@ async function configCommand(args) {
       showConfigHelp();
   }
 }
-// src/commands/discuss.ts
+// src/commands/daemon.ts
 init_index_node();
-init_progress_renderer();
-init_image_detect();
-init_input_handler();
 init_settings_manager();
 init_utils3();
-import { parseArgs as parseArgs3 } from "node:util";
-async function discussCommand(args) {
-  const { values, positionals } = parseArgs3({
-    args,
-    options: {
-      list: { type: "boolean" },
-      show: { type: "string" },
-      archive: { type: "string" },
-      delete: { type: "string" },
-      model: { type: "string" },
-      provider: { type: "string" },
-      "reasoning-effort": { type: "string" },
-      dir: { type: "string" }
-    },
-    strict: false,
-    allowPositionals: true
+import { existsSync as existsSync19, mkdirSync as mkdirSync8, unlinkSync as unlinkSync6, writeFileSync as writeFileSync8 } from "node:fs";
+import { homedir as homedir3 } from "node:os";
+import { join as join19 } from "node:path";
+
+// src/utils/process.ts
+import { spawn as spawn4 } from "node:child_process";
+import { existsSync as existsSync18, readdirSync as readdirSync6, readFileSync as readFileSync15 } from "node:fs";
+import { homedir as homedir2 } from "node:os";
+import { dirname as dirname4, join as join18 } from "node:path";
+function runShell(cmd, args) {
+  return new Promise((resolve2) => {
+    const proc = spawn4(cmd, args, { stdio: ["pipe", "pipe", "pipe"] });
+    let stdout = "";
+    let stderr = "";
+    proc.stdout?.on("data", (d) => {
+      stdout += d.toString();
+    });
+    proc.stderr?.on("data", (d) => {
+      stderr += d.toString();
+    });
+    proc.on("close", (exitCode) => resolve2({ exitCode, stdout, stderr }));
+    proc.on("error", (err) => resolve2({ exitCode: 1, stdout, stderr: err.message }));
   });
-  const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "discuss");
-  const discussionManager = new DiscussionManager(projectPath);
-  if (values.list) {
-    return listDiscussions(discussionManager);
+}
+async function findTelegramBinary() {
+  const result = await runShell("which", ["locus-telegram"]);
+  const p = result.stdout.trim();
+  return p?.startsWith?.("/") ? p : null;
+}
+async function findBinDir(binary) {
+  const result = await runShell("which", [binary]);
+  const p = result.stdout.trim();
+  if (p?.startsWith?.("/"))
+    return dirname4(p);
+  return null;
+}
+function resolveNvmBinDir() {
+  const nvmDir = process.env.NVM_DIR || join18(homedir2(), ".nvm");
+  const versionsDir = join18(nvmDir, "versions", "node");
+  if (!existsSync18(versionsDir))
+    return null;
+  let versions2;
+  try {
+    versions2 = readdirSync6(versionsDir).filter((d) => d.startsWith("v"));
+  } catch {
+    return null;
   }
-  if (values.show) {
-    return showDiscussion(discussionManager, values.show);
+  if (versions2.length === 0)
+    return null;
+  const currentNodeVersion = `v${process.versions.node}`;
+  const currentBin = join18(versionsDir, currentNodeVersion, "bin");
+  if (versions2.includes(currentNodeVersion) && existsSync18(currentBin)) {
+    return currentBin;
   }
-  if (values.archive) {
-    return archiveDiscussion(discussionManager, values.archive);
+  const aliasPath = join18(nvmDir, "alias", "default");
+  if (existsSync18(aliasPath)) {
+    try {
+      const alias = readFileSync15(aliasPath, "utf-8").trim();
+      const match = versions2.find((v) => v === `v${alias}` || v.startsWith(`v${alias}.`));
+      if (match) {
+        const bin2 = join18(versionsDir, match, "bin");
+        if (existsSync18(bin2))
+          return bin2;
+      }
+    } catch {}
   }
-  if (values.delete) {
-    return deleteDiscussion(discussionManager, values.delete);
+  const sorted = versions2.sort((a, b) => {
+    const pa = a.slice(1).split(".").map(Number);
+    const pb = b.slice(1).split(".").map(Number);
+    for (let i = 0;i < 3; i++) {
+      if ((pa[i] || 0) !== (pb[i] || 0))
+        return (pb[i] || 0) - (pa[i] || 0);
+    }
+    return 0;
+  });
+  const bin = join18(versionsDir, sorted[0], "bin");
+  return existsSync18(bin) ? bin : null;
+}
+async function buildServicePath() {
+  const home = homedir2();
+  const dirs = new Set;
+  dirs.add("/usr/local/bin");
+  dirs.add("/usr/bin");
+  dirs.add("/bin");
+  const candidates = [
+    join18(home, ".bun", "bin"),
+    join18(home, ".local", "bin"),
+    join18(home, ".npm", "bin"),
+    join18(home, ".npm-global", "bin"),
+    join18(home, ".yarn", "bin")
+  ];
+  for (const d of candidates) {
+    if (existsSync18(d))
+      dirs.add(d);
   }
-  const topic = positionals.join(" ").trim();
-  if (!topic) {
-    showDiscussHelp();
+  const nvmBin = resolveNvmBinDir();
+  if (nvmBin)
+    dirs.add(nvmBin);
+  const fnmCurrent = join18(home, ".fnm", "current", "bin");
+  if (existsSync18(fnmCurrent))
+    dirs.add(fnmCurrent);
+  for (const bin of ["claude", "codex"]) {
+    const dir = await findBinDir(bin);
+    if (dir)
+      dirs.add(dir);
+  }
+  return Array.from(dirs).join(":");
+}
+var SERVICE_NAME = "locus";
+var SYSTEMD_UNIT_PATH = `/etc/systemd/system/${SERVICE_NAME}.service`;
+var PLIST_LABEL = "com.locus.agent";
+function getPlistPath() {
+  return join18(homedir2(), "Library/LaunchAgents", `${PLIST_LABEL}.plist`);
+}
+function getPlatform() {
+  if (process.platform === "linux")
+    return "linux";
+  if (process.platform === "darwin")
+    return "darwin";
+  return null;
+}
+async function killOrphanedProcesses() {
+  const result = await runShell("pgrep", ["-f", "locus-telegram"]);
+  const pids = result.stdout.trim().split(`
+`).filter((p) => p.length > 0);
+  if (pids.length === 0)
     return;
+  console.log(`  Killing ${pids.length} orphaned locus-telegram process${pids.length > 1 ? "es" : ""}...`);
+  await runShell("pkill", ["-f", "locus-telegram"]);
+  await new Promise((resolve2) => setTimeout(resolve2, 2000));
+  const check2 = await runShell("pgrep", ["-f", "locus-telegram"]);
+  if (check2.stdout.trim().length > 0) {
+    await runShell("pkill", ["-9", "-f", "locus-telegram"]);
   }
-  const settings = new SettingsManager(projectPath).load();
-  const provider = resolveProvider3(values.provider || settings.provider);
-  const model = values.model || settings.model || DEFAULT_MODEL[provider];
-  const reasoningEffort = values["reasoning-effort"];
-  const aiRunner = createAiRunner(provider, {
-    projectPath,
-    model,
-    reasoningEffort
-  });
-  const log = (message, level) => {
-    const icon = level === "success" ? c.success("✔") : level === "error" ? c.error("✖") : level === "warn" ? c.warning("!") : c.info("●");
-    console.log(`  ${icon} ${message}`);
-  };
-  const facilitator = new DiscussionFacilitator({
-    projectPath,
-    aiRunner,
-    discussionManager,
-    log,
-    provider,
-    model
-  });
+}
+async function isDaemonRunning() {
+  const platform = getPlatform();
+  if (platform === "linux") {
+    const result = await runShell("systemctl", ["is-active", SERVICE_NAME]);
+    return result.stdout.trim() === "active";
+  }
+  if (platform === "darwin") {
+    const plistPath = getPlistPath();
+    if (!existsSync18(plistPath))
+      return false;
+    const result = await runShell("launchctl", ["list"]);
+    const match = result.stdout.split(`
+`).find((l) => l.includes(PLIST_LABEL));
+    if (!match)
+      return false;
+    const pid = match.trim().split(/\s+/)[0];
+    return pid !== "-";
+  }
+  return false;
+}
+async function restartDaemonIfRunning() {
+  const platform = getPlatform();
+  if (!platform)
+    return false;
+  const running = await isDaemonRunning();
+  if (!running)
+    return false;
+  if (platform === "linux") {
+    const result = await runShell("systemctl", ["restart", SERVICE_NAME]);
+    return result.exitCode === 0;
+  }
+  if (platform === "darwin") {
+    const plistPath = getPlistPath();
+    await runShell("launchctl", ["unload", plistPath]);
+    const result = await runShell("launchctl", ["load", plistPath]);
+    return result.exitCode === 0;
+  }
+  return false;
+}
+
+// src/commands/daemon.ts
+function showDaemonHelp() {
   console.log(`
-  ${c.header(" DISCUSSION ")} ${c.bold("Starting interactive discussion...")}
-`);
-  console.log(`  ${c.dim("Topic:")} ${c.bold(topic)}`);
-  console.log(`  ${c.dim("Model:")} ${c.dim(`${model} (${provider})`)}
-`);
-  const renderer = new ProgressRenderer;
-  let discussionId;
-  try {
-    renderer.showThinkingStarted();
-    const result = await facilitator.startDiscussion(topic);
-    renderer.showThinkingStopped();
-    discussionId = result.discussion.id;
-    process.stdout.write(`
-`);
-    process.stdout.write(result.message);
-    process.stdout.write(`
+  ${c.header(" DAEMON ")}
+    ${c.primary("locus daemon")} ${c.dim("<subcommand>")}
+
+  ${c.header(" SUBCOMMANDS ")}
+    ${c.success("start")}     Install and start Locus as a background service
+                ${c.dim("Sets up systemd (Linux) or launchd (macOS)")}
+    ${c.success("stop")}      Stop and remove the background service
+    ${c.success("restart")}   Restart the background service
+    ${c.success("status")}    Check if the service is running
 
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus daemon start")}
+    ${c.dim("$")} ${c.primary("locus daemon status")}
+    ${c.dim("$")} ${c.primary("locus daemon restart")}
+    ${c.dim("$")} ${c.primary("locus daemon stop")}
 `);
-    renderer.finalize();
-  } catch (error48) {
-    renderer.finalize();
+}
+async function resolveBinaries() {
+  const binaryPath = await findTelegramBinary();
+  if (!binaryPath) {
     console.error(`
-  ${c.error("✖")} ${c.red("Failed to start discussion:")} ${error48 instanceof Error ? error48.message : String(error48)}
+  ${c.error("✖")} ${c.bold("Could not find locus-telegram binary.")}
+` + `  Install with: ${c.primary("npm install -g @locusai/telegram")}
 `);
     process.exit(1);
   }
-  console.log(`  ${c.dim("Type your response, or 'help' for commands.")}`);
-  console.log(`  ${c.dim("Enter to send, Shift+Enter for newline. Use 'exit' or Ctrl+D to quit.")}
+  for (const bin of ["claude", "codex"]) {
+    if (!await findBinDir(bin)) {
+      console.warn(`
+  ${c.secondary("⚠")} ${c.bold(`Could not find '${bin}' CLI in PATH.`)}
+` + `  The service may need it to execute tasks.
 `);
-  let isProcessing = false;
-  let interrupted = false;
-  const shutdown = () => {
-    if (isProcessing) {
-      aiRunner.abort();
     }
-    console.log(`
-  ${c.dim("Discussion saved.")} ${c.dim("ID:")} ${c.cyan(discussionId)}`);
-    console.log(c.dim(`
-  Goodbye!
-`));
-    inputHandler.stop();
-    process.exit(0);
-  };
-  const handleSubmit = async (input) => {
-    interrupted = false;
-    const trimmed = input.trim();
-    if (trimmed === "") {
-      inputHandler.showPrompt();
-      return;
-    }
-    if (!trimmed.includes(`
-`)) {
-      const lowerInput = trimmed.toLowerCase();
-      if (lowerInput === "help") {
-        showReplHelp();
-        inputHandler.showPrompt();
-        return;
-      }
-      if (lowerInput === "exit" || lowerInput === "quit") {
-        shutdown();
-        return;
-      }
-      if (lowerInput === "insights") {
-        showCurrentInsights(discussionManager, discussionId);
-        inputHandler.showPrompt();
-        return;
-      }
-      if (lowerInput === "summary") {
-        isProcessing = true;
-        const summaryRenderer = new ProgressRenderer;
-        try {
-          summaryRenderer.showThinkingStarted();
-          const summary = await facilitator.summarizeDiscussion(discussionId);
-          summaryRenderer.showThinkingStopped();
-          process.stdout.write(`
+  }
+  const servicePath = await buildServicePath();
+  return { binaryPath, servicePath };
+}
+function requirePlatform() {
+  const platform = getPlatform();
+  if (!platform) {
+    console.error(`
+  ${c.error("✖")} ${c.bold(`Unsupported platform: ${process.platform}`)}
+` + `  Daemon management is supported on Linux (systemd) and macOS (launchd).
 `);
-          process.stdout.write(summary);
-          process.stdout.write(`
-`);
-          summaryRenderer.finalize();
-          const discussion2 = discussionManager.load(discussionId);
-          if (discussion2) {
-            console.log(`
-  ${c.success("✔")} ${c.success("Discussion completed!")}
-`);
-            console.log(`  ${c.dim("Messages:")} ${discussion2.messages.length}  ${c.dim("Insights:")} ${discussion2.insights.length}
-`);
-          }
-          console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
-          console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
-`);
-        } catch (error48) {
-          summaryRenderer.finalize();
-          console.error(`
-  ${c.error("✖")} ${c.red("Failed to summarize:")} ${error48 instanceof Error ? error48.message : String(error48)}
-`);
-        }
-        inputHandler.stop();
-        process.exit(0);
-        return;
-      }
-    }
-    const images = detectImages(trimmed);
-    if (images.length > 0) {
-      for (const img of images) {
-        const status = img.exists ? c.success("attached") : c.warning("not found");
-        process.stdout.write(`  ${c.cyan(`[Image: ${imageDisplayName(img.path)}]`)} ${status}\r
-`);
-      }
-    }
-    const cleanedInput = stripImagePaths(trimmed, images);
-    const effectiveInput = cleanedInput + buildImageContext(images);
-    isProcessing = true;
-    const chunkRenderer = new ProgressRenderer;
-    try {
-      chunkRenderer.showThinkingStarted();
-      const stream4 = facilitator.continueDiscussionStream(discussionId, effectiveInput);
-      let result = {
-        response: "",
-        insights: []
-      };
-      let iterResult = await stream4.next();
-      while (!iterResult.done) {
-        chunkRenderer.renderChunk(iterResult.value);
-        iterResult = await stream4.next();
-      }
-      result = iterResult.value;
-      chunkRenderer.finalize();
-      if (result.insights.length > 0) {
-        console.log("");
-        for (const insight of result.insights) {
-          const tag = formatInsightTag(insight.type);
-          console.log(`  ${tag} ${c.bold(insight.title)}`);
-          console.log(`  ${c.dim(insight.content)}
+    process.exit(1);
+  }
+  return platform;
+}
+function validateConfig(projectPath) {
+  const manager = new SettingsManager(projectPath);
+  const settings = manager.load();
+  if (!settings.telegram?.botToken || !settings.telegram?.chatId) {
+    console.error(`
+  ${c.error("✖")} ${c.bold("Telegram is not configured.")}
+` + `  Run ${c.primary("locus telegram setup")} first.
 `);
-        }
-      }
-    } catch (error48) {
-      chunkRenderer.finalize();
-      console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+    process.exit(1);
+  }
+  if (!settings.apiKey) {
+    console.error(`
+  ${c.error("✖")} ${c.bold("API key is not configured.")}
+` + `  Run ${c.primary("locus config setup --api-key <key>")} first.
 `);
-    }
-    isProcessing = false;
-    if (!interrupted) {
-      inputHandler.showPrompt();
-    }
-  };
-  const inputHandler = new InputHandler({
-    prompt: c.cyan("> "),
-    continuationPrompt: c.dim("… "),
-    onSubmit: (input) => {
-      handleSubmit(input).catch((err) => {
-        console.error(`
-  ${c.error("✖")} ${c.red(err instanceof Error ? err.message : String(err))}
+    process.exit(1);
+  }
+}
+function generateSystemdUnit(projectPath, user2, bins) {
+  return `[Unit]
+Description=Locus AI Agent (Telegram bot + proposal scheduler)
+After=network-online.target
+Wants=network-online.target
+
+[Service]
+Type=simple
+User=${user2}
+WorkingDirectory=${projectPath}
+ExecStart=${bins.binaryPath}
+Restart=on-failure
+RestartSec=10
+Environment=PATH=${bins.servicePath}
+Environment=HOME=${homedir3()}
+
+[Install]
+WantedBy=multi-user.target
+`;
+}
+async function startSystemd(projectPath, bins) {
+  const user2 = process.env.USER || "root";
+  const unit = generateSystemdUnit(projectPath, user2, bins);
+  console.log(`
+  ${c.info("▶")} Writing systemd unit to ${c.dim(SYSTEMD_UNIT_PATH)}`);
+  writeFileSync8(SYSTEMD_UNIT_PATH, unit, "utf-8");
+  console.log(`  ${c.info("▶")} Reloading systemd daemon...`);
+  await runShell("systemctl", ["daemon-reload"]);
+  console.log(`  ${c.info("▶")} Enabling and starting ${SERVICE_NAME}...`);
+  await runShell("systemctl", ["enable", SERVICE_NAME]);
+  const result = await runShell("systemctl", ["start", SERVICE_NAME]);
+  if (result.exitCode !== 0) {
+    console.error(`
+  ${c.error("✖")} Failed to start service: ${result.stderr.trim()}`);
+    console.error(`  ${c.dim("Check logs with:")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}`);
+    return;
+  }
+  console.log(`
+  ${c.success("✔")} ${c.bold("Locus daemon started!")}
+
+  ${c.bold("Service:")} ${SERVICE_NAME}
+  ${c.bold("Unit file:")} ${SYSTEMD_UNIT_PATH}
+
+  ${c.bold("Useful commands:")}
+    ${c.dim("$")} ${c.primary(`sudo systemctl status ${SERVICE_NAME}`)}
+    ${c.dim("$")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}
 `);
-        inputHandler.showPrompt();
-      });
-    },
-    onInterrupt: () => {
-      if (isProcessing) {
-        interrupted = true;
-        aiRunner.abort();
-        isProcessing = false;
-        console.log(c.dim(`
-[Interrupted]`));
-        inputHandler.showPrompt();
-      } else {
-        shutdown();
-      }
-    },
-    onClose: () => shutdown()
-  });
-  inputHandler.start();
-  inputHandler.showPrompt();
 }
-function listDiscussions(discussionManager) {
-  const discussions = discussionManager.list();
-  if (discussions.length === 0) {
+async function stopSystemd() {
+  if (!existsSync19(SYSTEMD_UNIT_PATH)) {
     console.log(`
-  ${c.dim("No discussions found.")}
-`);
-    console.log(`  ${c.dim("Start one with:")} ${c.cyan('locus discuss "your topic"')}
+  ${c.dim("No systemd service found. Nothing to stop.")}
 `);
+    await killOrphanedProcesses();
     return;
   }
+  console.log(`  ${c.info("▶")} Stopping and disabling ${SERVICE_NAME}...`);
+  await runShell("systemctl", ["stop", SERVICE_NAME]);
+  await runShell("systemctl", ["disable", SERVICE_NAME]);
+  unlinkSync6(SYSTEMD_UNIT_PATH);
+  await runShell("systemctl", ["daemon-reload"]);
+  await killOrphanedProcesses();
   console.log(`
-  ${c.header(" DISCUSSIONS ")} ${c.dim(`(${discussions.length})`)}
+  ${c.success("✔")} ${c.bold("Locus daemon stopped.")}
 `);
-  for (const disc of discussions) {
-    const statusIcon = disc.status === "active" ? c.warning("◯") : disc.status === "completed" ? c.success("✔") : c.dim("⊘");
-    console.log(`  ${statusIcon} ${c.bold(disc.title)} ${c.dim(`[${disc.status}]`)} ${c.dim(`— ${disc.messages.length} messages, ${disc.insights.length} insights`)}`);
-    console.log(`    ${c.dim("ID:")} ${disc.id}`);
-    console.log(`    ${c.dim("Created:")} ${disc.createdAt}`);
-    console.log("");
-  }
 }
-function showDiscussion(discussionManager, id) {
-  const md = discussionManager.getMarkdown(id);
-  if (!md) {
+async function restartSystemd() {
+  if (!existsSync19(SYSTEMD_UNIT_PATH)) {
+    console.log(`
+  ${c.dim("No systemd service found. Use")} ${c.primary("locus daemon start")} ${c.dim("first.")}
+`);
+    return;
+  }
+  console.log(`  ${c.info("▶")} Restarting ${SERVICE_NAME}...`);
+  const result = await runShell("systemctl", ["restart", SERVICE_NAME]);
+  if (result.exitCode !== 0) {
     console.error(`
-  ${c.error("✖")} ${c.red(`Discussion not found: ${id}`)}
+  ${c.error("✖")} Failed to restart: ${result.stderr.trim()}
 `);
-    process.exit(1);
+    return;
   }
   console.log(`
-${md}
+  ${c.success("✔")} ${c.bold("Locus daemon restarted.")}
 `);
 }
-function archiveDiscussion(discussionManager, id) {
-  try {
-    discussionManager.archive(id);
+async function statusSystemd() {
+  const result = await runShell("systemctl", ["is-active", SERVICE_NAME]);
+  const state = result.stdout.trim();
+  if (state === "active") {
     console.log(`
-  ${c.success("✔")} ${c.dim("Discussion archived.")}
+  ${c.success("●")} ${c.bold("Locus daemon is running")} ${c.dim("(systemd)")}
 `);
-  } catch (error48) {
-    console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+  } else if (existsSync19(SYSTEMD_UNIT_PATH)) {
+    console.log(`
+  ${c.secondary("●")} ${c.bold(`Locus daemon is ${state}`)} ${c.dim("(systemd)")}
 `);
-    process.exit(1);
-  }
-}
-function deleteDiscussion(discussionManager, id) {
-  try {
-    discussionManager.delete(id);
+    console.log(`  ${c.dim("Start with:")} ${c.primary("locus daemon start")}
+`);
+  } else {
     console.log(`
-  ${c.success("✔")} ${c.dim("Discussion deleted.")}
+  ${c.secondary("●")} ${c.bold("Locus daemon is not installed")}
 `);
-  } catch (error48) {
-    console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+    console.log(`  ${c.dim("Start with:")} ${c.primary("locus daemon start")}
 `);
-    process.exit(1);
   }
 }
-function showCurrentInsights(discussionManager, discussionId) {
-  const discussion2 = discussionManager.load(discussionId);
-  if (!discussion2 || discussion2.insights.length === 0) {
-    console.log(`
-  ${c.dim("No insights extracted yet.")}
-`);
+function generatePlist(projectPath, bins) {
+  const logDir = join19(homedir3(), "Library/Logs/Locus");
+  return `<?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>${PLIST_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>${bins.binaryPath}</string>
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${projectPath}</string>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>KeepAlive</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${join19(logDir, "locus.log")}</string>
+  <key>StandardErrorPath</key>
+  <string>${join19(logDir, "locus-error.log")}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${bins.servicePath}</string>
+  </dict>
+</dict>
+</plist>
+`;
+}
+async function startLaunchd(projectPath, bins) {
+  const plistPath = getPlistPath();
+  if (existsSync19(plistPath)) {
+    await runShell("launchctl", ["unload", plistPath]);
+  }
+  const logDir = join19(homedir3(), "Library/Logs/Locus");
+  mkdirSync8(logDir, { recursive: true });
+  mkdirSync8(join19(homedir3(), "Library/LaunchAgents"), { recursive: true });
+  const plist = generatePlist(projectPath, bins);
+  console.log(`
+  ${c.info("▶")} Writing plist to ${c.dim(plistPath)}`);
+  writeFileSync8(plistPath, plist, "utf-8");
+  console.log(`  ${c.info("▶")} Loading service...`);
+  const result = await runShell("launchctl", ["load", plistPath]);
+  if (result.exitCode !== 0) {
+    console.error(`
+  ${c.error("✖")} Failed to load service: ${result.stderr.trim()}`);
     return;
   }
+  const logPath = join19(logDir, "locus.log");
   console.log(`
-  ${c.header(" INSIGHTS ")} ${c.dim(`(${discussion2.insights.length})`)}
+  ${c.success("✔")} ${c.bold("Locus daemon started!")}
+
+  ${c.bold("Plist:")} ${plistPath}
+  ${c.bold("Logs:")}  ${logPath}
+
+  ${c.bold("Useful commands:")}
+    ${c.dim("$")} ${c.primary(`launchctl list | grep ${PLIST_LABEL}`)}
+    ${c.dim("$")} ${c.primary(`tail -f ${logPath}`)}
 `);
-  for (const insight of discussion2.insights) {
-    const tag = formatInsightTag(insight.type);
-    console.log(`  ${tag} ${c.bold(insight.title)}`);
-    console.log(`  ${c.dim(insight.content)}`);
-    if (insight.tags.length > 0) {
-      console.log(`  ${c.dim(`Tags: ${insight.tags.join(", ")}`)}`);
-    }
-    console.log("");
-  }
 }
-function formatInsightTag(type) {
-  switch (type) {
-    case "decision":
-      return c.green("[DECISION]");
-    case "requirement":
-      return c.blue("[REQUIREMENT]");
-    case "idea":
-      return c.yellow("[IDEA]");
-    case "concern":
-      return c.red("[CONCERN]");
-    case "learning":
-      return c.cyan("[LEARNING]");
+async function stopLaunchd() {
+  const plistPath = getPlistPath();
+  if (!existsSync19(plistPath)) {
+    console.log(`
+  ${c.dim("No launchd service found. Nothing to stop.")}
+`);
+    await killOrphanedProcesses();
+    return;
   }
-}
-function showReplHelp() {
+  console.log(`  ${c.info("▶")} Unloading service...`);
+  await runShell("launchctl", ["unload", plistPath]);
+  unlinkSync6(plistPath);
+  await killOrphanedProcesses();
   console.log(`
-  ${c.header(" DISCUSSION COMMANDS ")}
-
-    ${c.cyan("summary")}     Generate a final summary and end the discussion
-    ${c.cyan("insights")}    Show all insights extracted so far
-    ${c.cyan("exit")}        Save and exit without generating a summary
-    ${c.cyan("help")}        Show this help message
-
-  ${c.header(" KEY BINDINGS ")}
-
-    ${c.cyan("Enter")}              Send message
-    ${c.cyan("Shift+Enter")}        Insert newline (also: Alt+Enter, Ctrl+J)
-    ${c.cyan("Ctrl+C")}             Interrupt / clear input / exit
-    ${c.cyan("Ctrl+U")}             Clear current input
-    ${c.cyan("Ctrl+W")}             Delete last word
-
-  ${c.dim("Type anything else to continue the discussion.")}
+  ${c.success("✔")} ${c.bold("Locus daemon stopped.")}
 `);
 }
-function showDiscussHelp() {
+async function restartLaunchd() {
+  const plistPath = getPlistPath();
+  if (!existsSync19(plistPath)) {
+    console.log(`
+  ${c.dim("No launchd service found. Use")} ${c.primary("locus daemon start")} ${c.dim("first.")}
+`);
+    return;
+  }
+  console.log(`  ${c.info("▶")} Restarting service...`);
+  await runShell("launchctl", ["unload", plistPath]);
+  const result = await runShell("launchctl", ["load", plistPath]);
+  if (result.exitCode !== 0) {
+    console.error(`
+  ${c.error("✖")} Failed to restart: ${result.stderr.trim()}
+`);
+    return;
+  }
   console.log(`
-  ${c.header(" LOCUS DISCUSS ")} ${c.dim("— Interactive AI Discussion")}
-
-  ${c.bold("Usage:")}
-    ${c.cyan('locus discuss "topic"')}              Start a discussion on a topic
-    ${c.cyan("locus discuss --list")}                List all discussions
-    ${c.cyan("locus discuss --show <id>")}           Show discussion details
-    ${c.cyan("locus discuss --archive <id>")}        Archive a discussion
-    ${c.cyan("locus discuss --delete <id>")}         Delete a discussion
-
-  ${c.bold("Options:")}
-    ${c.dim("--model <model>")}    AI model (claude: opus, sonnet, haiku | codex: gpt-5.3-codex, gpt-5-codex-mini)
-    ${c.dim("--provider <p>")}     AI provider (claude, codex)
-    ${c.dim("--reasoning-effort <level>")}  Reasoning effort (low, medium, high)
-    ${c.dim("--dir <path>")}       Project directory
-
-  ${c.bold("REPL Commands:")}
-    ${c.dim("summary")}     Generate final summary and end the discussion
-    ${c.dim("insights")}    Show all insights extracted so far
-    ${c.dim("exit")}        Save and exit without generating a summary
-    ${c.dim("help")}        Show available commands
-
-  ${c.bold("Examples:")}
-    ${c.dim("# Start a discussion about architecture")}
-    ${c.cyan('locus discuss "how should we structure the auth system?"')}
-
-    ${c.dim("# Review a past discussion")}
-    ${c.cyan("locus discuss --show disc-1234567890")}
-
-    ${c.dim("# List all discussions")}
-    ${c.cyan("locus discuss --list")}
+  ${c.success("✔")} ${c.bold("Locus daemon restarted.")}
 `);
 }
-// src/commands/docs.ts
-init_index_node();
-init_config_manager();
-init_settings_manager();
-init_utils3();
-init_workspace_resolver();
-import { parseArgs as parseArgs4 } from "node:util";
-async function docsCommand(args) {
+async function statusLaunchd() {
+  const plistPath = getPlistPath();
+  if (!existsSync19(plistPath)) {
+    console.log(`
+  ${c.secondary("●")} ${c.bold("Locus daemon is not installed")}
+`);
+    console.log(`  ${c.dim("Start with:")} ${c.primary("locus daemon start")}
+`);
+    return;
+  }
+  const result = await runShell("launchctl", ["list"]);
+  const match = result.stdout.split(`
+`).find((l) => l.includes(PLIST_LABEL));
+  if (match) {
+    const parts = match.trim().split(/\s+/);
+    const pid = parts[0] === "-" ? null : parts[0];
+    if (pid) {
+      console.log(`
+  ${c.success("●")} ${c.bold("Locus daemon is running")} ${c.dim(`(PID ${pid}, launchd)`)}
+`);
+    } else {
+      console.log(`
+  ${c.secondary("●")} ${c.bold("Locus daemon is stopped")} ${c.dim("(launchd)")}
+`);
+      console.log(`  ${c.dim("Start with:")} ${c.primary("locus daemon start")}
+`);
+    }
+  } else {
+    console.log(`
+  ${c.secondary("●")} ${c.bold("Locus daemon is not loaded")} ${c.dim("(plist exists but not loaded)")}
+`);
+    console.log(`  ${c.dim("Start with:")} ${c.primary("locus daemon start")}
+`);
+  }
+}
+async function daemonCommand(args) {
+  const projectPath = process.cwd();
+  requireInitialization(projectPath, "daemon");
   const subcommand = args[0];
-  const subArgs = args.slice(1);
+  const platform = subcommand ? requirePlatform() : null;
+  const isLinux = platform === "linux";
   switch (subcommand) {
-    case "sync":
-      await docsSyncCommand(subArgs);
+    case "start": {
+      validateConfig(projectPath);
+      const bins = await resolveBinaries();
+      if (isLinux)
+        await startSystemd(projectPath, bins);
+      else
+        await startLaunchd(projectPath, bins);
       break;
-    default:
-      showDocsHelp();
+    }
+    case "stop":
+      if (isLinux)
+        await stopSystemd();
+      else
+        await stopLaunchd();
+      break;
+    case "restart":
+      if (isLinux)
+        await restartSystemd();
+      else
+        await restartLaunchd();
       break;
+    case "status":
+      if (isLinux)
+        await statusSystemd();
+      else
+        await statusLaunchd();
+      break;
+    default:
+      showDaemonHelp();
   }
 }
-async function docsSyncCommand(args) {
-  const { values } = parseArgs4({
+// src/commands/discuss.ts
+init_index_node();
+init_progress_renderer();
+init_image_detect();
+init_input_handler();
+init_settings_manager();
+init_utils3();
+import { parseArgs as parseArgs3 } from "node:util";
+async function discussCommand(args) {
+  const { values, positionals } = parseArgs3({
     args,
     options: {
-      "api-key": { type: "string" },
-      "api-url": { type: "string" },
-      workspace: { type: "string" },
-      dir: { type: "string" },
-      help: { type: "boolean" }
+      list: { type: "boolean" },
+      show: { type: "string" },
+      archive: { type: "string" },
+      delete: { type: "string" },
+      model: { type: "string" },
+      provider: { type: "string" },
+      "reasoning-effort": { type: "string" },
+      dir: { type: "string" }
     },
-    strict: false
+    strict: false,
+    allowPositionals: true
   });
-  if (values.help) {
-    showDocsSyncHelp();
-    return;
-  }
   const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "docs sync");
-  const configManager = new ConfigManager(projectPath);
-  configManager.updateVersion(VERSION2);
-  const settingsManager = new SettingsManager(projectPath);
-  const settings = settingsManager.load();
-  const apiKey = values["api-key"] || settings.apiKey;
-  if (!apiKey) {
-    console.error(`
-  ${c.error("✖")} ${c.red("API key is required")}
-` + `  ${c.dim(`Configure with: locus config setup --api-key <key>
-  Or pass --api-key flag`)}
-`);
-    process.exit(1);
+  requireInitialization(projectPath, "discuss");
+  const discussionManager = new DiscussionManager(projectPath);
+  if (values.list) {
+    return listDiscussions(discussionManager);
   }
-  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
-  const resolver = new WorkspaceResolver({
-    apiKey,
-    apiBase,
-    workspaceId: values.workspace
-  });
-  let workspaceId;
-  try {
-    workspaceId = await resolver.resolve();
-  } catch (error48) {
-    console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
-`);
-    process.exit(1);
+  if (values.show) {
+    return showDiscussion(discussionManager, values.show);
   }
-  const client = new LocusClient({
-    baseUrl: apiBase,
-    token: apiKey
+  if (values.archive) {
+    return archiveDiscussion(discussionManager, values.archive);
+  }
+  if (values.delete) {
+    return deleteDiscussion(discussionManager, values.delete);
+  }
+  const topic = positionals.join(" ").trim();
+  if (!topic) {
+    showDiscussHelp();
+    return;
+  }
+  const settings = new SettingsManager(projectPath).load();
+  const provider = resolveProvider3(values.provider || settings.provider);
+  const model = values.model || settings.model || DEFAULT_MODEL[provider];
+  const reasoningEffort = values["reasoning-effort"];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model,
+    reasoningEffort
   });
-  const fetcher = new DocumentFetcher({
-    client,
-    workspaceId,
+  const log = (message, level) => {
+    const icon = level === "success" ? c.success("✔") : level === "error" ? c.error("✖") : level === "warn" ? c.warning("!") : c.info("●");
+    console.log(`  ${icon} ${message}`);
+  };
+  const facilitator = new DiscussionFacilitator({
     projectPath,
-    log: (message, level) => {
-      if (level === "error") {
-        console.log(`  ${c.error("✖")} ${message}`);
-        return;
-      }
-      if (level === "warn") {
-        console.log(`  ${c.warning("!")} ${message}`);
-        return;
-      }
-      if (level === "success") {
-        console.log(`  ${c.success("✔")} ${message}`);
-        return;
-      }
-      console.log(`  ${c.info("●")} ${message}`);
-    }
+    aiRunner,
+    discussionManager,
+    log,
+    provider,
+    model
   });
   console.log(`
-  ${c.info("●")} ${c.bold("Syncing docs from API...")}
+  ${c.header(" DISCUSSION ")} ${c.bold("Starting interactive discussion...")}
 `);
-  try {
-    await fetcher.fetch();
-    console.log(`
-  ${c.success("✔")} ${c.success("Docs sync complete.")} ${c.dim("Local docs: .locus/documents")}
+  console.log(`  ${c.dim("Topic:")} ${c.bold(topic)}`);
+  console.log(`  ${c.dim("Model:")} ${c.dim(`${model} (${provider})`)}
 `);
-  } catch (error48) {
-    console.error(`
-  ${c.error("✖")} ${c.red(`Docs sync failed: ${error48 instanceof Error ? error48.message : String(error48)}`)}
-`);
-    process.exit(1);
-  }
-}
-function showDocsHelp() {
-  console.log(`
-  ${c.header(" DOCS ")}
-    ${c.primary("locus docs")} ${c.dim("<command> [options]")}
-
-  ${c.header(" COMMANDS ")}
-    ${c.success("sync")}      Sync workspace docs from API to .locus/documents
-
-  ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus docs sync")}
-    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
+  const renderer = new ProgressRenderer;
+  let discussionId;
+  try {
+    renderer.showThinkingStarted();
+    const result = await facilitator.startDiscussion(topic);
+    renderer.showThinkingStopped();
+    discussionId = result.discussion.id;
+    process.stdout.write(`
 `);
-}
-function showDocsSyncHelp() {
-  console.log(`
-  ${c.header(" DOCS SYNC ")}
-    ${c.primary("locus docs sync")} ${c.dim("[options]")}
-
-  ${c.header(" OPTIONS ")}
-    ${c.secondary("--api-key")} <key>     API key override (reads from settings.json)
-    ${c.secondary("--api-url")} <url>     API base URL (default: https://api.locusai.dev/api)
-    ${c.secondary("--workspace")} <id>    Workspace ID (optional if persisted or resolvable)
-    ${c.secondary("--dir")} <path>        Project directory (default: current)
-    ${c.secondary("--help")}              Show docs sync help
+    process.stdout.write(result.message);
+    process.stdout.write(`
 
-  ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus docs sync")}
-    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
 `);
-}
-// src/commands/exec.ts
-init_index_node();
-import { randomUUID as randomUUID2 } from "node:crypto";
-import { parseArgs as parseArgs5 } from "node:util";
-
-// src/display/json-stream-renderer.ts
-init_src();
-
-class JsonStreamRenderer {
-  sessionId;
-  command;
-  model;
-  provider;
-  cwd;
-  statsTracker;
-  started = false;
-  done = false;
-  constructor(options) {
-    this.sessionId = options.sessionId;
-    this.command = options.command;
-    this.model = options.model;
-    this.provider = options.provider;
-    this.cwd = options.cwd;
-    this.statsTracker = new ExecutionStatsTracker;
-  }
-  emitStart() {
-    if (this.started)
-      return;
-    this.started = true;
-    this.emit(createCliStreamEvent(CliStreamEventType.START, this.sessionId, {
-      command: this.command,
-      model: this.model,
-      provider: this.provider,
-      cwd: this.cwd
-    }));
-  }
-  handleChunk(chunk) {
-    this.ensureStarted();
-    switch (chunk.type) {
-      case "text_delta":
-        this.emit(createCliStreamEvent(CliStreamEventType.TEXT_DELTA, this.sessionId, {
-          content: chunk.content
-        }));
-        break;
-      case "thinking":
-        this.emit(createCliStreamEvent(CliStreamEventType.THINKING, this.sessionId, {
-          content: chunk.content
-        }));
-        break;
-      case "tool_use":
-        this.statsTracker.toolStarted(chunk.tool, chunk.id);
-        this.emit(createCliStreamEvent(CliStreamEventType.TOOL_STARTED, this.sessionId, {
-          tool: chunk.tool,
-          toolId: chunk.id,
-          parameters: chunk.parameters
-        }));
-        break;
-      case "tool_result":
-        if (chunk.success) {
-          this.statsTracker.toolCompleted(chunk.tool, chunk.id);
-        } else {
-          this.statsTracker.toolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
-        }
-        this.emit(createCliStreamEvent(CliStreamEventType.TOOL_COMPLETED, this.sessionId, {
-          tool: chunk.tool,
-          toolId: chunk.id,
-          success: chunk.success,
-          duration: chunk.duration,
-          error: chunk.error
-        }));
-        break;
-      case "tool_parameters":
-        break;
-      case "result":
-        break;
-      case "error":
-        this.statsTracker.setError(chunk.error);
-        this.emitError("UNKNOWN", chunk.error);
-        break;
-    }
-  }
-  emitStatus(status, message) {
-    this.ensureStarted();
-    this.emit(createCliStreamEvent(CliStreamEventType.STATUS, this.sessionId, {
-      status,
-      message
-    }));
-  }
-  emitError(code, message, options) {
-    this.ensureStarted();
-    this.emit(createCliStreamEvent(CliStreamEventType.ERROR, this.sessionId, {
-      error: createProtocolError(code, message, options)
-    }));
-  }
-  emitDone(exitCode) {
-    if (this.done)
-      return;
-    this.done = true;
-    this.ensureStarted();
-    const stats = this.statsTracker.finalize();
-    this.emit(createCliStreamEvent(CliStreamEventType.DONE, this.sessionId, {
-      exitCode,
-      duration: stats.duration,
-      toolsUsed: stats.toolsUsed.length > 0 ? stats.toolsUsed : undefined,
-      tokensUsed: stats.tokensUsed,
-      success: exitCode === 0
-    }));
-  }
-  emitFatalError(code, message, options) {
-    this.statsTracker.setError(message);
-    this.emitError(code, message, {
-      ...options,
-      recoverable: false
-    });
-    this.emitDone(1);
-  }
-  isDone() {
-    return this.done;
-  }
-  ensureStarted() {
-    if (!this.started) {
-      this.emitStart();
-    }
-  }
-  emit(event) {
-    process.stdout.write(`${JSON.stringify(event)}
+    renderer.finalize();
+  } catch (error48) {
+    renderer.finalize();
+    console.error(`
+  ${c.error("✖")} ${c.red("Failed to start discussion:")} ${error48 instanceof Error ? error48.message : String(error48)}
 `);
+    process.exit(1);
   }
-}
-
-// src/commands/exec.ts
-init_progress_renderer();
-init_settings_manager();
-init_utils3();
-
-// src/commands/exec-sessions.ts
-init_index_node();
-function formatRelativeTime(timestamp) {
-  const now = Date.now();
-  const diff = now - timestamp;
-  const seconds = Math.floor(diff / 1000);
-  const minutes = Math.floor(seconds / 60);
-  const hours = Math.floor(minutes / 60);
-  const days = Math.floor(hours / 24);
-  if (days > 0) {
-    return days === 1 ? "yesterday" : `${days} days ago`;
-  }
-  if (hours > 0) {
-    return hours === 1 ? "1 hour ago" : `${hours} hours ago`;
-  }
-  if (minutes > 0) {
-    return minutes === 1 ? "1 minute ago" : `${minutes} minutes ago`;
-  }
-  return "just now";
-}
-
-class SessionCommands {
-  historyManager;
-  constructor(projectPath) {
-    this.historyManager = new HistoryManager(projectPath);
-  }
-  async list() {
-    const sessions = this.historyManager.listSessions();
-    if (sessions.length === 0) {
-      console.log(`
-  ${c.dim("No exec sessions found.")}
+  console.log(`  ${c.dim("Type your response, or 'help' for commands.")}`);
+  console.log(`  ${c.dim("Enter to send, Shift+Enter for newline. Use 'exit' or Ctrl+D to quit.")}
 `);
-      return;
+  let isProcessing = false;
+  let interrupted = false;
+  const shutdown = () => {
+    if (isProcessing) {
+      aiRunner.abort();
     }
     console.log(`
-  ${c.primary("Recent Exec Sessions:")}
-`);
-    for (const session2 of sessions.slice(0, 10)) {
-      const shortId = this.getShortId(session2.id);
-      const age = formatRelativeTime(session2.updatedAt);
-      const msgCount = session2.messages.length;
-      const firstUserMsg = session2.messages.find((m) => m.role === "user");
-      const preview = firstUserMsg ? firstUserMsg.content.slice(0, 50).replace(/\n/g, " ") : "(empty session)";
-      console.log(`  ${c.cyan(shortId)} ${c.gray("-")} ${preview}${firstUserMsg && firstUserMsg.content.length > 50 ? "..." : ""}`);
-      console.log(`    ${c.dim(`${msgCount} messages • ${age}`)}`);
-      console.log();
-    }
-    if (sessions.length > 10) {
-      console.log(c.dim(`  ... and ${sessions.length - 10} more sessions
+  ${c.dim("Discussion saved.")} ${c.dim("ID:")} ${c.cyan(discussionId)}`);
+    console.log(c.dim(`
+  Goodbye!
 `));
+    inputHandler.stop();
+    process.exit(0);
+  };
+  const handleSubmit = async (input) => {
+    interrupted = false;
+    const trimmed = input.trim();
+    if (trimmed === "") {
+      inputHandler.showPrompt();
+      return;
     }
-  }
-  async show(sessionId) {
-    if (!sessionId) {
-      console.error(`
-  ${c.error("Error:")} Session ID is required
+    if (!trimmed.includes(`
+`)) {
+      const lowerInput = trimmed.toLowerCase();
+      if (lowerInput === "help") {
+        showReplHelp();
+        inputHandler.showPrompt();
+        return;
+      }
+      if (lowerInput === "exit" || lowerInput === "quit") {
+        shutdown();
+        return;
+      }
+      if (lowerInput === "insights") {
+        showCurrentInsights(discussionManager, discussionId);
+        inputHandler.showPrompt();
+        return;
+      }
+      if (lowerInput === "summary") {
+        isProcessing = true;
+        const summaryRenderer = new ProgressRenderer;
+        try {
+          summaryRenderer.showThinkingStarted();
+          const summary = await facilitator.summarizeDiscussion(discussionId);
+          summaryRenderer.showThinkingStopped();
+          process.stdout.write(`
 `);
-      console.log(`  ${c.dim("Usage: locus exec sessions show <session-id>")}
+          process.stdout.write(summary);
+          process.stdout.write(`
 `);
-      return;
-    }
-    const session2 = this.historyManager.findSessionByPartialId(sessionId);
-    if (!session2) {
-      console.error(`
-  ${c.error("Error:")} Session ${c.cyan(sessionId)} not found
+          summaryRenderer.finalize();
+          const discussion2 = discussionManager.load(discussionId);
+          if (discussion2) {
+            console.log(`
+  ${c.success("✔")} ${c.success("Discussion completed!")}
 `);
-      console.log(`  ${c.dim("Use 'locus exec sessions list' to see available sessions")}
+            console.log(`  ${c.dim("Messages:")} ${discussion2.messages.length}  ${c.dim("Insights:")} ${discussion2.insights.length}
 `);
-      return;
-    }
-    console.log(`
-  ${c.primary("Session:")} ${c.cyan(session2.id)}`);
-    console.log(`  ${c.dim(`Created: ${new Date(session2.createdAt).toLocaleString()}`)}`);
-    console.log(`  ${c.dim(`Model: ${session2.metadata.model} (${session2.metadata.provider})`)}
+          }
+          console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
+          console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
 `);
-    if (session2.messages.length === 0) {
-      console.log(`  ${c.dim("(No messages in this session)")}
+        } catch (error48) {
+          summaryRenderer.finalize();
+          console.error(`
+  ${c.error("✖")} ${c.red("Failed to summarize:")} ${error48 instanceof Error ? error48.message : String(error48)}
 `);
-      return;
+        }
+        inputHandler.stop();
+        process.exit(0);
+        return;
+      }
     }
-    console.log(c.dim("  ─".repeat(30)));
-    console.log();
-    for (const message of session2.messages) {
-      const role = message.role === "user" ? c.cyan("You") : c.green("AI");
-      const content = message.content;
-      console.log(`  ${role}:`);
-      const lines = content.split(`
+    const images = detectImages(trimmed);
+    if (images.length > 0) {
+      for (const img of images) {
+        const status = img.exists ? c.success("attached") : c.warning("not found");
+        process.stdout.write(`  ${c.cyan(`[Image: ${imageDisplayName(img.path)}]`)} ${status}\r
+`);
+      }
+    }
+    const cleanedInput = stripImagePaths(trimmed, images);
+    const effectiveInput = cleanedInput + buildImageContext(images);
+    isProcessing = true;
+    const chunkRenderer = new ProgressRenderer;
+    try {
+      chunkRenderer.showThinkingStarted();
+      const stream4 = facilitator.continueDiscussionStream(discussionId, effectiveInput);
+      let result = {
+        response: "",
+        insights: []
+      };
+      let iterResult = await stream4.next();
+      while (!iterResult.done) {
+        chunkRenderer.renderChunk(iterResult.value);
+        iterResult = await stream4.next();
+      }
+      result = iterResult.value;
+      chunkRenderer.finalize();
+      if (result.insights.length > 0) {
+        console.log("");
+        for (const insight of result.insights) {
+          const tag = formatInsightTag(insight.type);
+          console.log(`  ${tag} ${c.bold(insight.title)}`);
+          console.log(`  ${c.dim(insight.content)}
 `);
-      for (const line of lines) {
-        console.log(`    ${line}`);
+        }
       }
-      console.log();
-    }
-  }
-  async delete(sessionId) {
-    if (!sessionId) {
-      console.error(`
-  ${c.error("Error:")} Session ID is required
-`);
-      console.log(`  ${c.dim("Usage: locus exec sessions delete <session-id>")}
-`);
-      return;
-    }
-    const session2 = this.historyManager.findSessionByPartialId(sessionId);
-    if (!session2) {
+    } catch (error48) {
+      chunkRenderer.finalize();
       console.error(`
-  ${c.error("Error:")} Session ${c.cyan(sessionId)} not found
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
 `);
-      return;
     }
-    const deleted = this.historyManager.deleteSession(session2.id);
-    if (deleted) {
-      console.log(`
-  ${c.success("✔")} Deleted session ${c.cyan(this.getShortId(session2.id))}
-`);
-    } else {
-      console.error(`
-  ${c.error("Error:")} Failed to delete session
-`);
+    isProcessing = false;
+    if (!interrupted) {
+      inputHandler.showPrompt();
     }
-  }
-  async clear() {
-    const count = this.historyManager.getSessionCount();
-    if (count === 0) {
-      console.log(`
-  ${c.dim("No sessions to clear.")}
+  };
+  const inputHandler = new InputHandler({
+    prompt: c.cyan("> "),
+    continuationPrompt: c.dim("… "),
+    onSubmit: (input) => {
+      handleSubmit(input).catch((err) => {
+        console.error(`
+  ${c.error("✖")} ${c.red(err instanceof Error ? err.message : String(err))}
 `);
-      return;
-    }
-    const deleted = this.historyManager.clearAllSessions();
+        inputHandler.showPrompt();
+      });
+    },
+    onInterrupt: () => {
+      if (isProcessing) {
+        interrupted = true;
+        aiRunner.abort();
+        isProcessing = false;
+        console.log(c.dim(`
+[Interrupted]`));
+        inputHandler.showPrompt();
+      } else {
+        shutdown();
+      }
+    },
+    onClose: () => shutdown()
+  });
+  inputHandler.start();
+  inputHandler.showPrompt();
+}
+function listDiscussions(discussionManager) {
+  const discussions = discussionManager.list();
+  if (discussions.length === 0) {
     console.log(`
-  ${c.success("✔")} Cleared ${deleted} exec session${deleted === 1 ? "" : "s"}
+  ${c.dim("No discussions found.")}
 `);
-  }
-  getShortId(sessionId) {
-    const parts = sessionId.split("-");
-    if (parts.length >= 3) {
-      return parts.slice(-1)[0].slice(0, 8);
-    }
-    return sessionId.slice(0, 8);
-  }
-}
-function showSessionsHelp() {
-  console.log(`
-  ${c.primary("Session Commands")}
-
-  ${c.success("list")}                 List recent exec sessions
-  ${c.success("show")} ${c.dim("<id>")}            Show all messages in a session
-  ${c.success("delete")} ${c.dim("<id>")}          Delete a specific session
-  ${c.success("clear")}                Clear all exec sessions
-
-  ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} locus exec sessions list
-    ${c.dim("$")} locus exec sessions show e7f3a2b1
-    ${c.dim("$")} locus exec sessions delete e7f3a2b1
-    ${c.dim("$")} locus exec sessions clear
-
-  ${c.dim("Session IDs can be partial (first 8 characters).")}
+    console.log(`  ${c.dim("Start one with:")} ${c.cyan('locus discuss "your topic"')}
 `);
-}
-
-// src/commands/exec.ts
-async function execCommand(args) {
-  const { values, positionals } = parseArgs5({
-    args,
-    options: {
-      model: { type: "string" },
-      provider: { type: "string" },
-      "reasoning-effort": { type: "string" },
-      dir: { type: "string" },
-      "no-stream": { type: "boolean" },
-      "no-status": { type: "boolean" },
-      interactive: { type: "boolean", short: "i" },
-      session: { type: "string", short: "s" },
-      "session-id": { type: "string" },
-      "json-stream": { type: "boolean" }
-    },
-    strict: false
-  });
-  const jsonStream = values["json-stream"];
-  const projectPath = values.dir || process.cwd();
-  if (jsonStream) {
-    await execJsonStream(values, positionals, projectPath);
     return;
   }
-  requireInitialization(projectPath, "exec");
-  if (positionals[0] === "sessions") {
-    const sessionAction = positionals[1];
-    const sessionArg = positionals[2];
-    const cmds = new SessionCommands(projectPath);
-    switch (sessionAction) {
-      case "list":
-        await cmds.list();
-        return;
-      case "show":
-        await cmds.show(sessionArg);
-        return;
-      case "delete":
-        await cmds.delete(sessionArg);
-        return;
-      case "clear":
-        await cmds.clear();
-        return;
-      default:
-        showSessionsHelp();
-        return;
-    }
-  }
-  const execSettings = new SettingsManager(projectPath).load();
-  const provider = resolveProvider3(values.provider || execSettings.provider);
-  const model = values.model || execSettings.model || DEFAULT_MODEL[provider];
-  const isInteractive = values.interactive;
-  const sessionId = values.session;
-  if (isInteractive) {
-    const { InteractiveSession: InteractiveSession2 } = await Promise.resolve().then(() => (init_interactive_session(), exports_interactive_session));
-    const session2 = new InteractiveSession2({
-      projectPath,
-      provider,
-      model,
-      sessionId
-    });
-    await session2.start();
-    return;
+  console.log(`
+  ${c.header(" DISCUSSIONS ")} ${c.dim(`(${discussions.length})`)}
+`);
+  for (const disc of discussions) {
+    const statusIcon = disc.status === "active" ? c.warning("◯") : disc.status === "completed" ? c.success("✔") : c.dim("⊘");
+    console.log(`  ${statusIcon} ${c.bold(disc.title)} ${c.dim(`[${disc.status}]`)} ${c.dim(`— ${disc.messages.length} messages, ${disc.insights.length} insights`)}`);
+    console.log(`    ${c.dim("ID:")} ${disc.id}`);
+    console.log(`    ${c.dim("Created:")} ${disc.createdAt}`);
+    console.log("");
   }
-  const promptInput = positionals.join(" ");
-  if (!promptInput) {
-    console.error(c.error('Error: Prompt is required. Usage: locus exec "your prompt" or locus exec --interactive'));
+}
+function showDiscussion(discussionManager, id) {
+  const md = discussionManager.getMarkdown(id);
+  if (!md) {
+    console.error(`
+  ${c.error("✖")} ${c.red(`Discussion not found: ${id}`)}
+`);
     process.exit(1);
   }
-  const useStreaming = !values["no-stream"];
-  const reasoningEffort = values["reasoning-effort"];
-  const aiRunner = createAiRunner(provider, {
-    projectPath,
-    model,
-    reasoningEffort
-  });
-  const builder = new PromptBuilder(projectPath);
-  const fullPrompt = await builder.buildGenericPrompt(promptInput);
-  console.log("");
-  console.log(`${c.primary("\uD83D\uDE80")} ${c.bold("Executing prompt with repository context...")}`);
-  console.log("");
-  let responseContent = "";
-  try {
-    if (useStreaming) {
-      const renderer = new ProgressRenderer;
-      const statsTracker = new ExecutionStatsTracker;
-      const stream4 = aiRunner.runStream(fullPrompt);
-      renderer.showThinkingStarted();
-      for await (const chunk of stream4) {
-        switch (chunk.type) {
-          case "text_delta":
-            renderer.renderTextDelta(chunk.content);
-            responseContent += chunk.content;
-            break;
-          case "tool_use":
-            statsTracker.toolStarted(chunk.tool, chunk.id);
-            renderer.showToolStarted(chunk.tool, chunk.id);
-            break;
-          case "thinking":
-            renderer.showThinkingStarted();
-            break;
-          case "tool_result":
-            if (chunk.success) {
-              statsTracker.toolCompleted(chunk.tool, chunk.id);
-              renderer.showToolCompleted(chunk.tool, undefined, chunk.id);
-            } else {
-              statsTracker.toolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
-              renderer.showToolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
-            }
-            break;
-          case "result":
-            break;
-          case "error": {
-            statsTracker.setError(chunk.error);
-            renderer.renderError(chunk.error);
-            renderer.finalize();
-            const errorStats = statsTracker.finalize();
-            renderer.showSummary(errorStats);
-            console.error(`
-  ${c.error("✖")} ${c.error("Execution failed!")}
+  console.log(`
+${md}
 `);
-            process.exit(1);
-          }
-        }
-      }
-      renderer.finalize();
-      const stats = statsTracker.finalize();
-      renderer.showSummary(stats);
-    } else {
-      responseContent = await aiRunner.run(fullPrompt);
-      console.log(responseContent);
-    }
+}
+function archiveDiscussion(discussionManager, id) {
+  try {
+    discussionManager.archive(id);
     console.log(`
-  ${c.success("✔")} ${c.success("Execution finished!")}
+  ${c.success("✔")} ${c.dim("Discussion archived.")}
 `);
   } catch (error48) {
     console.error(`
-  ${c.error("✖")} ${c.error("Execution failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
 `);
     process.exit(1);
   }
 }
-async function execJsonStream(values, positionals, projectPath) {
-  const sessionId = values["session-id"] ?? values.session ?? randomUUID2();
-  const execSettings = new SettingsManager(projectPath).load();
-  const provider = resolveProvider3(values.provider || execSettings.provider);
-  const model = values.model || execSettings.model || DEFAULT_MODEL[provider];
-  const renderer = new JsonStreamRenderer({
-    sessionId,
-    command: "exec",
-    model,
-    provider,
-    cwd: projectPath
-  });
-  const handleSignal = () => {
-    if (renderer.isDone()) {
-      return;
-    }
-    renderer.emitFatalError("PROCESS_CRASHED", "Process terminated by signal");
-    if (process.stdout.writableNeedDrain) {
-      process.stdout.once("drain", () => process.exit(1));
-    } else {
-      process.exit(1);
-    }
-  };
-  process.on("SIGINT", handleSignal);
-  process.on("SIGTERM", handleSignal);
+function deleteDiscussion(discussionManager, id) {
   try {
-    try {
-      requireInitialization(projectPath, "exec");
-    } catch (initError) {
-      renderer.emitFatalError("CLI_NOT_FOUND", initError instanceof Error ? initError.message : String(initError));
-      process.exit(1);
-    }
-    const promptInput = positionals.join(" ");
-    if (!promptInput) {
-      renderer.emitFatalError("UNKNOWN", 'Prompt is required. Usage: locus exec --json-stream "your prompt"');
-      process.exit(1);
-    }
-    renderer.emitStart();
-    renderer.emitStatus("running", "Building prompt context");
-    const aiRunner = createAiRunner(provider, {
-      projectPath,
-      model
-    });
-    const builder = new PromptBuilder(projectPath);
-    const fullPrompt = await builder.buildGenericPrompt(promptInput);
-    renderer.emitStatus("streaming", "Streaming AI response");
-    const stream4 = aiRunner.runStream(fullPrompt);
-    for await (const chunk of stream4) {
-      renderer.handleChunk(chunk);
-    }
-    renderer.emitDone(0);
-    process.removeListener("SIGINT", handleSignal);
-    process.removeListener("SIGTERM", handleSignal);
+    discussionManager.delete(id);
+    console.log(`
+  ${c.success("✔")} ${c.dim("Discussion deleted.")}
+`);
   } catch (error48) {
-    const message = error48 instanceof Error ? error48.message : String(error48);
-    if (!renderer.isDone()) {
-      renderer.emitFatalError("UNKNOWN", message);
-    }
+    console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
     process.exit(1);
   }
 }
-// src/commands/help.ts
-init_index_node();
-function showHelp2() {
+function showCurrentInsights(discussionManager, discussionId) {
+  const discussion2 = discussionManager.load(discussionId);
+  if (!discussion2 || discussion2.insights.length === 0) {
+    console.log(`
+  ${c.dim("No insights extracted yet.")}
+`);
+    return;
+  }
   console.log(`
-  ${c.header(" USAGE ")}
-    ${c.primary("locus")} ${c.dim("<command> [options]")}
-
-  ${c.header(" COMMANDS ")}
-    ${c.success("init")}      Initialize Locus in the current directory
-    ${c.success("config")}    Manage settings (API key, provider, model)
-              ${c.dim("setup         Interactive one-time setup")}
-              ${c.dim("show          Show current settings")}
-              ${c.dim("set <k> <v>   Update a setting")}
-              ${c.dim("remove        Remove all settings")}
-    ${c.success("index")}     Index the codebase for AI context
-    ${c.success("run")}       Start agent to work on tasks sequentially
-    ${c.success("discuss")}   Start an interactive AI discussion on a topic
-              ${c.dim("--list         List all discussions")}
-              ${c.dim("--show <id>    Show discussion details")}
-              ${c.dim("--archive <id> Archive a discussion")}
-              ${c.dim("--delete <id>  Delete a discussion")}
-    ${c.success("plan")}      Run async planning meeting to create sprint plans
-    ${c.success("docs")}      Manage workspace docs
-              ${c.dim("sync          Sync docs from API to .locus/documents")}
-    ${c.success("review")}    Review open Locus PRs on GitHub with AI
-              ${c.dim("local         Review staged changes locally (no GitHub)")}
-    ${c.success("telegram")}  Configure the Telegram bot
-              ${c.dim("setup         Interactive bot token and chat ID setup")}
-              ${c.dim("config        Show current configuration")}
-              ${c.dim("set <k> <v>   Update a config value")}
-              ${c.dim("remove        Remove Telegram configuration")}
-    ${c.success("exec")}      Run a prompt with repository context
-              ${c.dim("--interactive, -i  Start interactive REPL mode")}
-              ${c.dim("--session, -s <id> Resume a previous session")}
-              ${c.dim("sessions list      List recent sessions")}
-              ${c.dim("sessions show <id> Show session messages")}
-              ${c.dim("sessions delete <id> Delete a session")}
-              ${c.dim("sessions clear     Clear all sessions")}
-    ${c.success("service")}   Manage the Locus system service
-              ${c.dim("install           Install as systemd/launchd service")}
-              ${c.dim("uninstall         Remove the system service")}
-              ${c.dim("status            Check if service is running")}
-    ${c.success("artifacts")} List and manage knowledge artifacts
-              ${c.dim("show <name>        Show artifact content")}
-              ${c.dim("plan <name>        Convert artifact to a plan")}
-    ${c.success("version")}   Show installed package versions
-    ${c.success("upgrade")}   Update CLI and Telegram to the latest version
+  ${c.header(" INSIGHTS ")} ${c.dim(`(${discussion2.insights.length})`)}
+`);
+  for (const insight of discussion2.insights) {
+    const tag = formatInsightTag(insight.type);
+    console.log(`  ${tag} ${c.bold(insight.title)}`);
+    console.log(`  ${c.dim(insight.content)}`);
+    if (insight.tags.length > 0) {
+      console.log(`  ${c.dim(`Tags: ${insight.tags.join(", ")}`)}`);
+    }
+    console.log("");
+  }
+}
+function formatInsightTag(type) {
+  switch (type) {
+    case "decision":
+      return c.green("[DECISION]");
+    case "requirement":
+      return c.blue("[REQUIREMENT]");
+    case "idea":
+      return c.yellow("[IDEA]");
+    case "concern":
+      return c.red("[CONCERN]");
+    case "learning":
+      return c.cyan("[LEARNING]");
+  }
+}
+function showReplHelp() {
+  console.log(`
+  ${c.header(" DISCUSSION COMMANDS ")}
 
-  ${c.header(" OPTIONS ")}
-    ${c.secondary("--help")}           Show this help message
-    ${c.secondary("--provider")} <name>  AI provider: ${c.dim("claude")} or ${c.dim("codex")} (default: ${c.dim("claude")})
-    ${c.secondary("--model")} <name>     AI model (claude: ${c.dim("opus, sonnet, haiku")} | codex: ${c.dim("gpt-5.3-codex, gpt-5-codex-mini")})
-    ${c.secondary("--reasoning-effort")} <level>  Codex reasoning effort: ${c.dim("low, medium, high")} (default: model default)
+    ${c.cyan("summary")}     Generate a final summary and end the discussion
+    ${c.cyan("insights")}    Show all insights extracted so far
+    ${c.cyan("exit")}        Save and exit without generating a summary
+    ${c.cyan("help")}        Show this help message
 
-  ${c.header(" GETTING STARTED ")}
-    ${c.dim("$")} ${c.primary("locus init")}
-    ${c.dim("$")} ${c.primary("locus config setup")}
-    ${c.dim("$")} ${c.primary("locus telegram setup")}
-    ${c.dim("$")} ${c.primary("locus service install")}
+  ${c.header(" KEY BINDINGS ")}
 
-  ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus run")}
-    ${c.dim("$")} ${c.primary("locus docs sync")}
-    ${c.dim("$")} ${c.primary("locus review")}
-    ${c.dim("$")} ${c.primary("locus review local")}
-    ${c.dim("$")} ${c.primary("locus telegram setup")}
-    ${c.dim("$")} ${c.primary('locus discuss "how should we design the auth system?"')}
-    ${c.dim("$")} ${c.primary("locus exec sessions list")}
-    ${c.dim("$")} ${c.primary("locus artifacts")}
-    ${c.dim("$")} ${c.primary("locus service install")}
+    ${c.cyan("Enter")}              Send message
+    ${c.cyan("Shift+Enter")}        Insert newline (also: Alt+Enter, Ctrl+J)
+    ${c.cyan("Ctrl+C")}             Interrupt / clear input / exit
+    ${c.cyan("Ctrl+U")}             Clear current input
+    ${c.cyan("Ctrl+W")}             Delete last word
 
-  For more information, visit: ${c.underline("https://docs.locusai.dev")}
+  ${c.dim("Type anything else to continue the discussion.")}
 `);
 }
-// src/commands/index-codebase.ts
-init_index_node();
-init_config_manager();
-import { parseArgs as parseArgs6 } from "node:util";
+function showDiscussHelp() {
+  console.log(`
+  ${c.header(" LOCUS DISCUSS ")} ${c.dim("— Interactive AI Discussion")}
 
-// src/tree-summarizer.ts
-init_index_node();
+  ${c.bold("Usage:")}
+    ${c.cyan('locus discuss "topic"')}              Start a discussion on a topic
+    ${c.cyan("locus discuss --list")}                List all discussions
+    ${c.cyan("locus discuss --show <id>")}           Show discussion details
+    ${c.cyan("locus discuss --archive <id>")}        Archive a discussion
+    ${c.cyan("locus discuss --delete <id>")}         Delete a discussion
 
-class TreeSummarizer {
-  aiRunner;
-  constructor(aiRunner) {
-    this.aiRunner = aiRunner;
-  }
-  async summarize(tree) {
-    const prompt = `Analyze this file tree and generate a JSON index.
-Return ONLY a JSON object with this structure:
-{
-  "symbols": {},
-  "responsibilities": { "path": "Description" }
-}
+  ${c.bold("Options:")}
+    ${c.dim("--model <model>")}    AI model (claude: opus, sonnet, haiku | codex: gpt-5.3-codex, gpt-5-codex-mini)
+    ${c.dim("--provider <p>")}     AI provider (claude, codex)
+    ${c.dim("--reasoning-effort <level>")}  Reasoning effort (low, medium, high)
+    ${c.dim("--dir <path>")}       Project directory
 
-File Tree:
-${tree}`;
-    const output = await this.aiRunner.run(prompt);
-    const jsonStr = extractJsonFromLLMOutput(output);
-    return JSON.parse(jsonStr);
-  }
-}
+  ${c.bold("REPL Commands:")}
+    ${c.dim("summary")}     Generate final summary and end the discussion
+    ${c.dim("insights")}    Show all insights extracted so far
+    ${c.dim("exit")}        Save and exit without generating a summary
+    ${c.dim("help")}        Show available commands
 
-// src/commands/index-codebase.ts
+  ${c.bold("Examples:")}
+    ${c.dim("# Start a discussion about architecture")}
+    ${c.cyan('locus discuss "how should we structure the auth system?"')}
+
+    ${c.dim("# Review a past discussion")}
+    ${c.cyan("locus discuss --show disc-1234567890")}
+
+    ${c.dim("# List all discussions")}
+    ${c.cyan("locus discuss --list")}
+`);
+}
+// src/commands/docs.ts
+init_index_node();
+init_config_manager();
+init_settings_manager();
 init_utils3();
-async function indexCommand(args) {
-  const { values } = parseArgs6({
+init_workspace_resolver();
+import { parseArgs as parseArgs4 } from "node:util";
+async function docsCommand(args) {
+  const subcommand = args[0];
+  const subArgs = args.slice(1);
+  switch (subcommand) {
+    case "sync":
+      await docsSyncCommand(subArgs);
+      break;
+    default:
+      showDocsHelp();
+      break;
+  }
+}
+async function docsSyncCommand(args) {
+  const { values } = parseArgs4({
     args,
     options: {
+      "api-key": { type: "string" },
+      "api-url": { type: "string" },
+      workspace: { type: "string" },
       dir: { type: "string" },
-      model: { type: "string" },
-      provider: { type: "string" }
+      help: { type: "boolean" }
     },
     strict: false
   });
+  if (values.help) {
+    showDocsSyncHelp();
+    return;
+  }
   const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "index");
-  new ConfigManager(projectPath).updateVersion(VERSION2);
-  const provider = resolveProvider3(values.provider);
-  const model = values.model || DEFAULT_MODEL[provider];
-  const aiRunner = createAiRunner(provider, {
+  requireInitialization(projectPath, "docs sync");
+  const configManager = new ConfigManager(projectPath);
+  configManager.updateVersion(VERSION2);
+  const settingsManager = new SettingsManager(projectPath);
+  const settings = settingsManager.load();
+  const apiKey = values["api-key"] || settings.apiKey;
+  if (!apiKey) {
+    console.error(`
+  ${c.error("✖")} ${c.red("API key is required")}
+` + `  ${c.dim(`Configure with: locus config setup --api-key <key>
+  Or pass --api-key flag`)}
+`);
+    process.exit(1);
+  }
+  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
+  const resolver = new WorkspaceResolver({
+    apiKey,
+    apiBase,
+    workspaceId: values.workspace
+  });
+  let workspaceId;
+  try {
+    workspaceId = await resolver.resolve();
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    process.exit(1);
+  }
+  const client = new LocusClient({
+    baseUrl: apiBase,
+    token: apiKey
+  });
+  const fetcher = new DocumentFetcher({
+    client,
+    workspaceId,
     projectPath,
-    model
+    log: (message, level) => {
+      if (level === "error") {
+        console.log(`  ${c.error("✖")} ${message}`);
+        return;
+      }
+      if (level === "warn") {
+        console.log(`  ${c.warning("!")} ${message}`);
+        return;
+      }
+      if (level === "success") {
+        console.log(`  ${c.success("✔")} ${message}`);
+        return;
+      }
+      console.log(`  ${c.info("●")} ${message}`);
+    }
   });
-  const summarizer = new TreeSummarizer(aiRunner);
-  const indexer = new CodebaseIndexer(projectPath);
   console.log(`
-  ${c.step(" INDEX ")} ${c.primary("Analyzing codebase in")} ${c.bold(projectPath)}...`);
+  ${c.info("●")} ${c.bold("Syncing docs from API...")}
+`);
   try {
-    const index = await indexer.index((msg) => console.log(`  ${c.dim(msg)}`), (tree) => summarizer.summarize(tree));
-    if (index) {
-      indexer.saveIndex(index);
-    }
+    await fetcher.fetch();
+    console.log(`
+  ${c.success("✔")} ${c.success("Docs sync complete.")} ${c.dim("Local docs: .locus/documents")}
+`);
   } catch (error48) {
     console.error(`
-  ${c.error("✖")} ${c.error("Indexing failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}`);
-    console.error(c.dim(`  The agent might have limited context until indexing succeeds.
-`));
+  ${c.error("✖")} ${c.red(`Docs sync failed: ${error48 instanceof Error ? error48.message : String(error48)}`)}
+`);
+    process.exit(1);
   }
+}
+function showDocsHelp() {
   console.log(`
-  ${c.success("✔")} ${c.success("Indexing complete!")}
+  ${c.header(" DOCS ")}
+    ${c.primary("locus docs")} ${c.dim("<command> [options]")}
+
+  ${c.header(" COMMANDS ")}
+    ${c.success("sync")}      Sync workspace docs from API to .locus/documents
+
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus docs sync")}
+    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
 `);
 }
-// src/commands/init.ts
-init_index_node();
-init_config_manager();
-init_utils3();
-async function initCommand() {
-  const projectPath = process.cwd();
-  const configManager = new ConfigManager(projectPath);
-  if (isProjectInitialized(projectPath)) {
-    console.log(`
-  ${c.info("ℹ️")}  ${c.bold("Locus is already initialized. Updating configuration...")}
-`);
-    const result = await configManager.reinit(VERSION2);
-    const updates = [];
-    if (result.versionUpdated) {
-      updates.push(`Version updated: ${c.dim(result.previousVersion || "unknown")} → ${c.primary(VERSION2)}`);
-    }
-    if (result.directoriesCreated.length > 0) {
-      updates.push(`Directories created: ${result.directoriesCreated.map((d) => c.dim(d)).join(", ")}`);
-    }
-    if (result.gitignoreUpdated) {
-      updates.push(`Gitignore updated with Locus patterns`);
-    }
-    if (updates.length === 0) {
-      console.log(`  ${c.success("✔")} ${c.success("Configuration is already up to date!")}
+function showDocsSyncHelp() {
+  console.log(`
+  ${c.header(" DOCS SYNC ")}
+    ${c.primary("locus docs sync")} ${c.dim("[options]")}
 
-  ${c.dim(`Version: ${VERSION2}`)}`);
-    } else {
-      console.log(`  ${c.success("✔")} ${c.success("Configuration updated successfully!")}
+  ${c.header(" OPTIONS ")}
+    ${c.secondary("--api-key")} <key>     API key override (reads from settings.json)
+    ${c.secondary("--api-url")} <url>     API base URL (default: https://api.locusai.dev/api)
+    ${c.secondary("--workspace")} <id>    Workspace ID (optional if persisted or resolvable)
+    ${c.secondary("--dir")} <path>        Project directory (default: current)
+    ${c.secondary("--help")}              Show docs sync help
 
-  ${c.bold("Changes:")}
-    ${updates.map((u) => `${c.primary("•")} ${u}`).join(`
-    `)}
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus docs sync")}
+    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
 `);
+}
+// src/commands/exec.ts
+init_index_node();
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { parseArgs as parseArgs5 } from "node:util";
+
+// src/display/json-stream-renderer.ts
+init_src();
+
+class JsonStreamRenderer {
+  sessionId;
+  command;
+  model;
+  provider;
+  cwd;
+  statsTracker;
+  started = false;
+  done = false;
+  constructor(options) {
+    this.sessionId = options.sessionId;
+    this.command = options.command;
+    this.model = options.model;
+    this.provider = options.provider;
+    this.cwd = options.cwd;
+    this.statsTracker = new ExecutionStatsTracker;
+  }
+  emitStart() {
+    if (this.started)
+      return;
+    this.started = true;
+    this.emit(createCliStreamEvent(CliStreamEventType.START, this.sessionId, {
+      command: this.command,
+      model: this.model,
+      provider: this.provider,
+      cwd: this.cwd
+    }));
+  }
+  handleChunk(chunk) {
+    this.ensureStarted();
+    switch (chunk.type) {
+      case "text_delta":
+        this.emit(createCliStreamEvent(CliStreamEventType.TEXT_DELTA, this.sessionId, {
+          content: chunk.content
+        }));
+        break;
+      case "thinking":
+        this.emit(createCliStreamEvent(CliStreamEventType.THINKING, this.sessionId, {
+          content: chunk.content
+        }));
+        break;
+      case "tool_use":
+        this.statsTracker.toolStarted(chunk.tool, chunk.id);
+        this.emit(createCliStreamEvent(CliStreamEventType.TOOL_STARTED, this.sessionId, {
+          tool: chunk.tool,
+          toolId: chunk.id,
+          parameters: chunk.parameters
+        }));
+        break;
+      case "tool_result":
+        if (chunk.success) {
+          this.statsTracker.toolCompleted(chunk.tool, chunk.id);
+        } else {
+          this.statsTracker.toolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
+        }
+        this.emit(createCliStreamEvent(CliStreamEventType.TOOL_COMPLETED, this.sessionId, {
+          tool: chunk.tool,
+          toolId: chunk.id,
+          success: chunk.success,
+          duration: chunk.duration,
+          error: chunk.error
+        }));
+        break;
+      case "tool_parameters":
+        break;
+      case "result":
+        break;
+      case "error":
+        this.statsTracker.setError(chunk.error);
+        this.emitError("UNKNOWN", chunk.error);
+        break;
+    }
+  }
+  emitStatus(status, message) {
+    this.ensureStarted();
+    this.emit(createCliStreamEvent(CliStreamEventType.STATUS, this.sessionId, {
+      status,
+      message
+    }));
+  }
+  emitError(code, message, options) {
+    this.ensureStarted();
+    this.emit(createCliStreamEvent(CliStreamEventType.ERROR, this.sessionId, {
+      error: createProtocolError(code, message, options)
+    }));
+  }
+  emitDone(exitCode) {
+    if (this.done)
+      return;
+    this.done = true;
+    this.ensureStarted();
+    const stats = this.statsTracker.finalize();
+    this.emit(createCliStreamEvent(CliStreamEventType.DONE, this.sessionId, {
+      exitCode,
+      duration: stats.duration,
+      toolsUsed: stats.toolsUsed.length > 0 ? stats.toolsUsed : undefined,
+      tokensUsed: stats.tokensUsed,
+      success: exitCode === 0
+    }));
+  }
+  emitFatalError(code, message, options) {
+    this.statsTracker.setError(message);
+    this.emitError(code, message, {
+      ...options,
+      recoverable: false
+    });
+    this.emitDone(1);
+  }
+  isDone() {
+    return this.done;
+  }
+  ensureStarted() {
+    if (!this.started) {
+      this.emitStart();
     }
-    console.log(`  ${c.bold("Next steps:")}
-    1. Run '${c.primary("locus config setup")}' to configure your API key
-    2. Run '${c.primary("locus index")}' to index your codebase
-    3. Run '${c.primary("locus run")}' to start an agent
-
-  For more information, visit: ${c.underline("https://docs.locusai.dev")}
-`);
-    return;
   }
-  await configManager.init(VERSION2);
-  console.log(`
-  ${c.success("✨ Locus initialized successfully!")}
-
-  ${c.bold("Created:")}
-    ${c.primary("\uD83D\uDCC1")} ${c.bold(".locus/")}                     ${c.dim("Configuration directory")}
-    ${c.primary("\uD83D\uDCC4")} ${c.bold(".locus/config.json")}          ${c.dim("Project settings")}
-    ${c.primary("\uD83D\uDCDD")} ${c.bold(".locus/LOCUS.md")}             ${c.dim("AI agent instructions")}
-    ${c.primary("\uD83D\uDCDD")} ${c.bold(".locus/LEARNINGS.md")}         ${c.dim("Continuous learning log")}
-
-  ${c.bold("Next steps:")}
-    1. Run '${c.primary("locus config setup")}' to configure your API key
-    2. Run '${c.primary("locus index")}' to index your codebase
-    3. Run '${c.primary("locus run")}' to start an agent
-
-  For more information, visit: ${c.underline("https://docs.locusai.dev")}
+  emit(event) {
+    process.stdout.write(`${JSON.stringify(event)}
 `);
+  }
 }
 
-// src/commands/index.ts
-init_plan();
-
-// src/commands/review.ts
-init_index_node();
-init_config_manager();
+// src/commands/exec.ts
+init_progress_renderer();
 init_settings_manager();
 init_utils3();
-init_workspace_resolver();
-import { existsSync as existsSync19, mkdirSync as mkdirSync9, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join19 } from "node:path";
-import { parseArgs as parseArgs7 } from "node:util";
-async function reviewCommand(args) {
-  const subcommand = args[0];
-  if (subcommand === "local") {
-    return reviewLocalCommand(args.slice(1));
+
+// src/commands/exec-sessions.ts
+init_index_node();
+function formatRelativeTime(timestamp) {
+  const now = Date.now();
+  const diff = now - timestamp;
+  const seconds = Math.floor(diff / 1000);
+  const minutes = Math.floor(seconds / 60);
+  const hours = Math.floor(minutes / 60);
+  const days = Math.floor(hours / 24);
+  if (days > 0) {
+    return days === 1 ? "yesterday" : `${days} days ago`;
   }
-  return reviewPrsCommand(args);
-}
-async function reviewPrsCommand(args) {
-  const { values } = parseArgs7({
-    args,
-    options: {
-      "api-key": { type: "string" },
-      workspace: { type: "string" },
-      model: { type: "string" },
-      provider: { type: "string" },
-      "api-url": { type: "string" },
-      dir: { type: "string" }
-    },
-    strict: false
-  });
-  const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "review");
-  const configManager = new ConfigManager(projectPath);
-  configManager.updateVersion(VERSION2);
-  const settingsManager = new SettingsManager(projectPath);
-  const settings = settingsManager.load();
-  const apiKey = values["api-key"] || settings.apiKey;
-  if (!apiKey) {
-    console.error(c.error("Error: API key is required for PR review"));
-    console.error(c.dim(`Configure with: locus config setup --api-key <key>
-  Or pass --api-key flag`));
-    console.error(c.dim("For local staged-changes review, use: locus review local"));
-    process.exit(1);
+  if (hours > 0) {
+    return hours === 1 ? "1 hour ago" : `${hours} hours ago`;
   }
-  const provider = resolveProvider3(values.provider || settings.provider);
-  const model = values.model || settings.model || DEFAULT_MODEL[provider];
-  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
-  let workspaceId;
-  try {
-    const resolver = new WorkspaceResolver({
-      apiKey,
-      apiBase,
-      workspaceId: values.workspace
-    });
-    workspaceId = await resolver.resolve();
-  } catch (error48) {
-    console.error(c.error(error48 instanceof Error ? error48.message : String(error48)));
-    process.exit(1);
+  if (minutes > 0) {
+    return minutes === 1 ? "1 minute ago" : `${minutes} minutes ago`;
   }
-  const log = (msg, level = "info") => {
-    const colorFn = {
-      info: c.cyan,
-      success: c.green,
-      warn: c.yellow,
-      error: c.red
-    }[level];
-    const prefix = { info: "ℹ", success: "✓", warn: "⚠", error: "✗" }[level];
-    console.log(`  ${colorFn(`${prefix} ${msg}`)}`);
-  };
-  const prService = new PrService(projectPath, log);
-  const unreviewedPrs = prService.listUnreviewedLocusPrs();
-  if (unreviewedPrs.length === 0) {
+  return "just now";
+}
+
+class SessionCommands {
+  historyManager;
+  constructor(projectPath) {
+    this.historyManager = new HistoryManager(projectPath);
+  }
+  async list() {
+    const sessions = this.historyManager.listSessions();
+    if (sessions.length === 0) {
+      console.log(`
+  ${c.dim("No exec sessions found.")}
+`);
+      return;
+    }
     console.log(`
-  ${c.dim("No unreviewed Locus PRs found.")}
+  ${c.primary("Recent Exec Sessions:")}
 `);
-    return;
+    for (const session2 of sessions.slice(0, 10)) {
+      const shortId = this.getShortId(session2.id);
+      const age = formatRelativeTime(session2.updatedAt);
+      const msgCount = session2.messages.length;
+      const firstUserMsg = session2.messages.find((m) => m.role === "user");
+      const preview = firstUserMsg ? firstUserMsg.content.slice(0, 50).replace(/\n/g, " ") : "(empty session)";
+      console.log(`  ${c.cyan(shortId)} ${c.gray("-")} ${preview}${firstUserMsg && firstUserMsg.content.length > 50 ? "..." : ""}`);
+      console.log(`    ${c.dim(`${msgCount} messages • ${age}`)}`);
+      console.log();
+    }
+    if (sessions.length > 10) {
+      console.log(c.dim(`  ... and ${sessions.length - 10} more sessions
+`));
+    }
   }
-  console.log(`
-  ${c.primary("\uD83D\uDD0D")} ${c.bold(`Found ${unreviewedPrs.length} unreviewed PR(s). Starting reviewer...`)}
+  async show(sessionId) {
+    if (!sessionId) {
+      console.error(`
+  ${c.error("Error:")} Session ID is required
+`);
+      console.log(`  ${c.dim("Usage: locus exec sessions show <session-id>")}
 `);
-  const agentId = `reviewer-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
-  const reviewer = new ReviewerWorker({
-    agentId,
-    workspaceId,
-    apiBase,
-    projectPath,
-    apiKey,
-    model,
-    provider
-  });
-  let isShuttingDown = false;
-  const handleSignal = () => {
-    if (isShuttingDown)
       return;
-    isShuttingDown = true;
+    }
+    const session2 = this.historyManager.findSessionByPartialId(sessionId);
+    if (!session2) {
+      console.error(`
+  ${c.error("Error:")} Session ${c.cyan(sessionId)} not found
+`);
+      console.log(`  ${c.dim("Use 'locus exec sessions list' to see available sessions")}
+`);
+      return;
+    }
     console.log(`
-${c.info("Received shutdown signal. Stopping reviewer...")}`);
-    process.exit(0);
-  };
-  process.on("SIGINT", handleSignal);
-  process.on("SIGTERM", handleSignal);
-  await reviewer.run();
-}
-async function reviewLocalCommand(args) {
-  const { values } = parseArgs7({
-    args,
-    options: {
-      model: { type: "string" },
-      provider: { type: "string" },
-      dir: { type: "string" }
-    },
-    strict: false
-  });
-  const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "review local");
-  const localSettings = new SettingsManager(projectPath).load();
-  const provider = resolveProvider3(values.provider || localSettings.provider);
-  const model = values.model || localSettings.model || DEFAULT_MODEL[provider];
-  const aiRunner = createAiRunner(provider, {
-    projectPath,
-    model
-  });
-  const reviewService = new ReviewService({
-    aiRunner,
-    projectPath,
-    log: (msg, level) => {
-      switch (level) {
-        case "error":
-          console.log(`  ${c.error("✖")} ${msg}`);
-          break;
-        case "success":
-          console.log(`  ${c.success("✔")} ${msg}`);
-          break;
-        default:
-          console.log(`  ${c.dim(msg)}`);
+  ${c.primary("Session:")} ${c.cyan(session2.id)}`);
+    console.log(`  ${c.dim(`Created: ${new Date(session2.createdAt).toLocaleString()}`)}`);
+    console.log(`  ${c.dim(`Model: ${session2.metadata.model} (${session2.metadata.provider})`)}
+`);
+    if (session2.messages.length === 0) {
+      console.log(`  ${c.dim("(No messages in this session)")}
+`);
+      return;
+    }
+    console.log(c.dim("  ─".repeat(30)));
+    console.log();
+    for (const message of session2.messages) {
+      const role = message.role === "user" ? c.cyan("You") : c.green("AI");
+      const content = message.content;
+      console.log(`  ${role}:`);
+      const lines = content.split(`
+`);
+      for (const line of lines) {
+        console.log(`    ${line}`);
       }
+      console.log();
+    }
+  }
+  async delete(sessionId) {
+    if (!sessionId) {
+      console.error(`
+  ${c.error("Error:")} Session ID is required
+`);
+      console.log(`  ${c.dim("Usage: locus exec sessions delete <session-id>")}
+`);
+      return;
+    }
+    const session2 = this.historyManager.findSessionByPartialId(sessionId);
+    if (!session2) {
+      console.error(`
+  ${c.error("Error:")} Session ${c.cyan(sessionId)} not found
+`);
+      return;
     }
-  });
-  console.log(`
-  ${c.primary("\uD83D\uDD0D")} ${c.bold("Reviewing staged changes...")}
+    const deleted = this.historyManager.deleteSession(session2.id);
+    if (deleted) {
+      console.log(`
+  ${c.success("✔")} Deleted session ${c.cyan(this.getShortId(session2.id))}
 `);
-  const report = await reviewService.reviewStagedChanges(null);
-  if (!report) {
-    console.log(`  ${c.dim("No changes to review.")}
+    } else {
+      console.error(`
+  ${c.error("Error:")} Failed to delete session
 `);
-    return;
+    }
   }
-  const reviewsDir = join19(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
-  if (!existsSync19(reviewsDir)) {
-    mkdirSync9(reviewsDir, { recursive: true });
+  async clear() {
+    const count = this.historyManager.getSessionCount();
+    if (count === 0) {
+      console.log(`
+  ${c.dim("No sessions to clear.")}
+`);
+      return;
+    }
+    const deleted = this.historyManager.clearAllSessions();
+    console.log(`
+  ${c.success("✔")} Cleared ${deleted} exec session${deleted === 1 ? "" : "s"}
+`);
   }
-  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const reportPath = join19(reviewsDir, `review-${timestamp}.md`);
-  writeFileSync8(reportPath, report, "utf-8");
+  getShortId(sessionId) {
+    const parts = sessionId.split("-");
+    if (parts.length >= 3) {
+      return parts.slice(-1)[0].slice(0, 8);
+    }
+    return sessionId.slice(0, 8);
+  }
+}
+function showSessionsHelp() {
   console.log(`
-  ${c.success("✔")} ${c.success("Review complete!")}`);
-  console.log(`  ${c.dim("Report saved to:")} ${c.primary(reportPath)}
+  ${c.primary("Session Commands")}
+
+  ${c.success("list")}                 List recent exec sessions
+  ${c.success("show")} ${c.dim("<id>")}            Show all messages in a session
+  ${c.success("delete")} ${c.dim("<id>")}          Delete a specific session
+  ${c.success("clear")}                Clear all exec sessions
+
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} locus exec sessions list
+    ${c.dim("$")} locus exec sessions show e7f3a2b1
+    ${c.dim("$")} locus exec sessions delete e7f3a2b1
+    ${c.dim("$")} locus exec sessions clear
+
+  ${c.dim("Session IDs can be partial (first 8 characters).")}
 `);
 }
-// src/commands/run.ts
-init_index_node();
-init_config_manager();
-init_settings_manager();
-init_utils3();
-init_workspace_resolver();
-import { parseArgs as parseArgs8 } from "node:util";
-async function runCommand(args) {
-  const { values } = parseArgs8({
+
+// src/commands/exec.ts
+async function execCommand(args) {
+  const { values, positionals } = parseArgs5({
     args,
     options: {
-      "api-key": { type: "string" },
-      workspace: { type: "string" },
-      sprint: { type: "string" },
       model: { type: "string" },
       provider: { type: "string" },
       "reasoning-effort": { type: "string" },
-      "skip-planning": { type: "boolean" },
-      "api-url": { type: "string" },
-      dir: { type: "string" }
+      dir: { type: "string" },
+      "no-stream": { type: "boolean" },
+      "no-status": { type: "boolean" },
+      interactive: { type: "boolean", short: "i" },
+      session: { type: "string", short: "s" },
+      "session-id": { type: "string" },
+      "json-stream": { type: "boolean" }
     },
     strict: false
   });
+  const jsonStream = values["json-stream"];
   const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "run");
-  const configManager = new ConfigManager(projectPath);
-  configManager.updateVersion(VERSION2);
-  const settingsManager = new SettingsManager(projectPath);
-  const settings = settingsManager.load();
-  const apiKey = values["api-key"] || settings.apiKey;
-  if (!apiKey) {
-    console.error(c.error("Error: API key is required"));
-    console.error(c.dim(`Configure with: locus config setup --api-key <key>
-  Or pass --api-key flag`));
-    process.exit(1);
+  if (jsonStream) {
+    await execJsonStream(values, positionals, projectPath);
+    return;
   }
-  let workspaceId = values.workspace;
-  const provider = resolveProvider3(values.provider || settings.provider);
-  const model = values.model || settings.model || DEFAULT_MODEL[provider];
-  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
-  try {
-    const resolver = new WorkspaceResolver({
-      apiKey,
-      apiBase,
-      workspaceId: values.workspace
+  requireInitialization(projectPath, "exec");
+  if (positionals[0] === "sessions") {
+    const sessionAction = positionals[1];
+    const sessionArg = positionals[2];
+    const cmds = new SessionCommands(projectPath);
+    switch (sessionAction) {
+      case "list":
+        await cmds.list();
+        return;
+      case "show":
+        await cmds.show(sessionArg);
+        return;
+      case "delete":
+        await cmds.delete(sessionArg);
+        return;
+      case "clear":
+        await cmds.clear();
+        return;
+      default:
+        showSessionsHelp();
+        return;
+    }
+  }
+  const execSettings = new SettingsManager(projectPath).load();
+  const provider = resolveProvider3(values.provider || execSettings.provider);
+  const model = values.model || execSettings.model || DEFAULT_MODEL[provider];
+  const isInteractive = values.interactive;
+  const sessionId = values.session;
+  if (isInteractive) {
+    const { InteractiveSession: InteractiveSession2 } = await Promise.resolve().then(() => (init_interactive_session(), exports_interactive_session));
+    const session2 = new InteractiveSession2({
+      projectPath,
+      provider,
+      model,
+      sessionId
     });
-    workspaceId = await resolver.resolve();
-  } catch (error48) {
-    console.error(c.error(error48 instanceof Error ? error48.message : String(error48)));
+    await session2.start();
+    return;
+  }
+  const promptInput = positionals.join(" ");
+  if (!promptInput) {
+    console.error(c.error('Error: Prompt is required. Usage: locus exec "your prompt" or locus exec --interactive'));
     process.exit(1);
   }
+  const useStreaming = !values["no-stream"];
   const reasoningEffort = values["reasoning-effort"];
-  const orchestrator = new AgentOrchestrator({
-    workspaceId,
-    sprintId: values.sprint || "",
-    model,
-    provider,
-    reasoningEffort,
-    apiBase,
-    maxIterations: 100,
+  const aiRunner = createAiRunner(provider, {
     projectPath,
-    apiKey
+    model,
+    reasoningEffort
   });
-  orchestrator.on("agent:spawned", (data) => console.log(`  ${c.info("●")} ${c.bold("Agent spawned:")} ${data.agentId}`));
-  orchestrator.on("task:assigned", (data) => console.log(`  ${c.info("●")} ${c.bold("Claimed:")} ${data.title}`));
-  orchestrator.on("task:completed", (data) => console.log(`  ${c.success("✔")} ${c.success("Completed:")} ${c.dim(data.taskId)}`));
-  orchestrator.on("task:failed", (data) => console.log(`  ${c.error("✖")} ${c.error("Failed:")} ${c.bold(data.taskId)}: ${data.error}`));
-  orchestrator.on("agent:stale", (data) => console.log(`  ${c.error("⚠")} ${c.error("Stale agent killed:")} ${data.agentId}`));
-  let isShuttingDown = false;
-  const handleSignal = async (signal) => {
-    if (isShuttingDown)
-      return;
-    isShuttingDown = true;
-    console.log(`
-${c.info(`Received ${signal}. Stopping agent and cleaning up...`)}`);
-    await orchestrator.stop();
-    process.exit(0);
-  };
-  process.on("SIGINT", () => handleSignal("SIGINT"));
-  process.on("SIGTERM", () => handleSignal("SIGTERM"));
-  console.log(`
-  ${c.primary("\uD83D\uDE80")} ${c.bold("Starting agent in")} ${c.primary(projectPath)}...`);
-  console.log(`  ${c.dim("Tasks will be executed sequentially on a single branch")}`);
-  console.log(`  ${c.dim("Changes will be committed and pushed after each task")}`);
-  console.log(`  ${c.dim("A PR will be opened when all tasks are done")}`);
-  await orchestrator.start();
-}
-// src/commands/service.ts
-init_index_node();
-init_settings_manager();
-init_utils3();
-import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync20, readdirSync as readdirSync6, readFileSync as readFileSync15, writeFileSync as writeFileSync9 } from "node:fs";
-import { homedir as homedir3 } from "node:os";
-import { dirname as dirname4, join as join20 } from "node:path";
-async function findBinary() {
-  const result = await runShell("which", ["locus-telegram"]);
-  const p = result.stdout.trim();
-  return p?.startsWith?.("/") ? p : null;
-}
-async function findBinDir(binary) {
-  const result = await runShell("which", [binary]);
-  const p = result.stdout.trim();
-  if (p?.startsWith?.("/"))
-    return dirname4(p);
-  return null;
+  const builder = new PromptBuilder(projectPath);
+  const fullPrompt = await builder.buildGenericPrompt(promptInput);
+  console.log("");
+  console.log(`${c.primary("\uD83D\uDE80")} ${c.bold("Executing prompt with repository context...")}`);
+  console.log("");
+  let responseContent = "";
+  try {
+    if (useStreaming) {
+      const renderer = new ProgressRenderer;
+      const statsTracker = new ExecutionStatsTracker;
+      const stream4 = aiRunner.runStream(fullPrompt);
+      renderer.showThinkingStarted();
+      for await (const chunk of stream4) {
+        switch (chunk.type) {
+          case "text_delta":
+            renderer.renderTextDelta(chunk.content);
+            responseContent += chunk.content;
+            break;
+          case "tool_use":
+            statsTracker.toolStarted(chunk.tool, chunk.id);
+            renderer.showToolStarted(chunk.tool, chunk.id);
+            break;
+          case "thinking":
+            renderer.showThinkingStarted();
+            break;
+          case "tool_result":
+            if (chunk.success) {
+              statsTracker.toolCompleted(chunk.tool, chunk.id);
+              renderer.showToolCompleted(chunk.tool, undefined, chunk.id);
+            } else {
+              statsTracker.toolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
+              renderer.showToolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
+            }
+            break;
+          case "result":
+            break;
+          case "error": {
+            statsTracker.setError(chunk.error);
+            renderer.renderError(chunk.error);
+            renderer.finalize();
+            const errorStats = statsTracker.finalize();
+            renderer.showSummary(errorStats);
+            console.error(`
+  ${c.error("✖")} ${c.error("Execution failed!")}
+`);
+            process.exit(1);
+          }
+        }
+      }
+      renderer.finalize();
+      const stats = statsTracker.finalize();
+      renderer.showSummary(stats);
+    } else {
+      responseContent = await aiRunner.run(fullPrompt);
+      console.log(responseContent);
+    }
+    console.log(`
+  ${c.success("✔")} ${c.success("Execution finished!")}
+`);
+  } catch (error48) {
+    console.error(`
+  ${c.error("✖")} ${c.error("Execution failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    process.exit(1);
+  }
 }
-function resolveNvmBinDir() {
-  const nvmDir = process.env.NVM_DIR || join20(homedir3(), ".nvm");
-  const versionsDir = join20(nvmDir, "versions", "node");
-  if (!existsSync20(versionsDir))
-    return null;
-  let versions2;
+async function execJsonStream(values, positionals, projectPath) {
+  const sessionId = values["session-id"] ?? values.session ?? randomUUID2();
+  const execSettings = new SettingsManager(projectPath).load();
+  const provider = resolveProvider3(values.provider || execSettings.provider);
+  const model = values.model || execSettings.model || DEFAULT_MODEL[provider];
+  const renderer = new JsonStreamRenderer({
+    sessionId,
+    command: "exec",
+    model,
+    provider,
+    cwd: projectPath
+  });
+  const handleSignal = () => {
+    if (renderer.isDone()) {
+      return;
+    }
+    renderer.emitFatalError("PROCESS_CRASHED", "Process terminated by signal");
+    if (process.stdout.writableNeedDrain) {
+      process.stdout.once("drain", () => process.exit(1));
+    } else {
+      process.exit(1);
+    }
+  };
+  process.on("SIGINT", handleSignal);
+  process.on("SIGTERM", handleSignal);
   try {
-    versions2 = readdirSync6(versionsDir).filter((d) => d.startsWith("v"));
-  } catch {
-    return null;
-  }
-  if (versions2.length === 0)
-    return null;
-  const currentNodeVersion = `v${process.versions.node}`;
-  const currentBin = join20(versionsDir, currentNodeVersion, "bin");
-  if (versions2.includes(currentNodeVersion) && existsSync20(currentBin)) {
-    return currentBin;
-  }
-  const aliasPath = join20(nvmDir, "alias", "default");
-  if (existsSync20(aliasPath)) {
     try {
-      const alias = readFileSync15(aliasPath, "utf-8").trim();
-      const match = versions2.find((v) => v === `v${alias}` || v.startsWith(`v${alias}.`));
-      if (match) {
-        const bin2 = join20(versionsDir, match, "bin");
-        if (existsSync20(bin2))
-          return bin2;
-      }
-    } catch {}
-  }
-  const sorted = versions2.sort((a, b) => {
-    const pa = a.slice(1).split(".").map(Number);
-    const pb = b.slice(1).split(".").map(Number);
-    for (let i = 0;i < 3; i++) {
-      if ((pa[i] || 0) !== (pb[i] || 0))
-        return (pb[i] || 0) - (pa[i] || 0);
+      requireInitialization(projectPath, "exec");
+    } catch (initError) {
+      renderer.emitFatalError("CLI_NOT_FOUND", initError instanceof Error ? initError.message : String(initError));
+      process.exit(1);
     }
-    return 0;
-  });
-  const bin = join20(versionsDir, sorted[0], "bin");
-  return existsSync20(bin) ? bin : null;
-}
-async function buildServicePath() {
-  const home = homedir3();
-  const dirs = new Set;
-  dirs.add("/usr/local/bin");
-  dirs.add("/usr/bin");
-  dirs.add("/bin");
-  const candidates = [
-    join20(home, ".bun", "bin"),
-    join20(home, ".local", "bin"),
-    join20(home, ".npm", "bin"),
-    join20(home, ".npm-global", "bin"),
-    join20(home, ".yarn", "bin")
-  ];
-  for (const d of candidates) {
-    if (existsSync20(d))
-      dirs.add(d);
-  }
-  const nvmBin = resolveNvmBinDir();
-  if (nvmBin)
-    dirs.add(nvmBin);
-  const fnmCurrent = join20(home, ".fnm", "current", "bin");
-  if (existsSync20(fnmCurrent))
-    dirs.add(fnmCurrent);
-  for (const bin of ["claude", "codex"]) {
-    const dir = await findBinDir(bin);
-    if (dir)
-      dirs.add(dir);
+    const promptInput = positionals.join(" ");
+    if (!promptInput) {
+      renderer.emitFatalError("UNKNOWN", 'Prompt is required. Usage: locus exec --json-stream "your prompt"');
+      process.exit(1);
+    }
+    renderer.emitStart();
+    renderer.emitStatus("running", "Building prompt context");
+    const aiRunner = createAiRunner(provider, {
+      projectPath,
+      model
+    });
+    const builder = new PromptBuilder(projectPath);
+    const fullPrompt = await builder.buildGenericPrompt(promptInput);
+    renderer.emitStatus("streaming", "Streaming AI response");
+    const stream4 = aiRunner.runStream(fullPrompt);
+    for await (const chunk of stream4) {
+      renderer.handleChunk(chunk);
+    }
+    renderer.emitDone(0);
+    process.removeListener("SIGINT", handleSignal);
+    process.removeListener("SIGTERM", handleSignal);
+  } catch (error48) {
+    const message = error48 instanceof Error ? error48.message : String(error48);
+    if (!renderer.isDone()) {
+      renderer.emitFatalError("UNKNOWN", message);
+    }
+    process.exit(1);
   }
-  return Array.from(dirs).join(":");
-}
-var SERVICE_NAME = "locus";
-var SYSTEMD_UNIT_PATH = `/etc/systemd/system/${SERVICE_NAME}.service`;
-var PLIST_LABEL = "com.locus.agent";
-function getPlistPath() {
-  return join20(homedir3(), "Library/LaunchAgents", `${PLIST_LABEL}.plist`);
 }
-function showServiceHelp() {
+// src/commands/help.ts
+init_index_node();
+function showHelp2() {
   console.log(`
-  ${c.header(" SERVICE ")}
-    ${c.primary("locus service")} ${c.dim("<subcommand>")}
+  ${c.header(" USAGE ")}
+    ${c.primary("locus")} ${c.dim("<command> [options]")}
 
-  ${c.header(" SUBCOMMANDS ")}
-    ${c.success("install")}           Install Locus as a system service
-                      ${c.dim("Sets up systemd (Linux) or launchd (macOS)")}
-                      ${c.dim("to run the Telegram bot + proposal scheduler")}
-    ${c.success("uninstall")}         Remove the system service
-    ${c.success("status")}            Check if the service is running
+  ${c.header(" COMMANDS ")}
+    ${c.success("init")}      Initialize Locus in the current directory
+    ${c.success("config")}    Manage settings (API key, provider, model)
+              ${c.dim("setup         Interactive one-time setup")}
+              ${c.dim("show          Show current settings")}
+              ${c.dim("set <k> <v>   Update a setting")}
+              ${c.dim("remove        Remove all settings")}
+    ${c.success("index")}     Index the codebase for AI context
+    ${c.success("run")}       Start agent to work on tasks sequentially
+    ${c.success("discuss")}   Start an interactive AI discussion on a topic
+              ${c.dim("--list         List all discussions")}
+              ${c.dim("--show <id>    Show discussion details")}
+              ${c.dim("--archive <id> Archive a discussion")}
+              ${c.dim("--delete <id>  Delete a discussion")}
+    ${c.success("plan")}      Run async planning meeting to create sprint plans
+    ${c.success("docs")}      Manage workspace docs
+              ${c.dim("sync          Sync docs from API to .locus/documents")}
+    ${c.success("review")}    Review open Locus PRs on GitHub with AI
+              ${c.dim("local         Review staged changes locally (no GitHub)")}
+    ${c.success("telegram")}  Manage the Telegram bot
+              ${c.dim("start         Start the Telegram bot")}
+              ${c.dim("setup         Interactive bot token and chat ID setup")}
+              ${c.dim("config        Show current configuration")}
+              ${c.dim("set <k> <v>   Update a config value")}
+              ${c.dim("remove        Remove Telegram configuration")}
+    ${c.success("daemon")}    Manage the Locus background service
+              ${c.dim("start         Install and start the daemon")}
+              ${c.dim("stop          Stop and remove the daemon")}
+              ${c.dim("restart       Restart the daemon")}
+              ${c.dim("status        Check if the daemon is running")}
+    ${c.success("exec")}      Run a prompt with repository context
+              ${c.dim("--interactive, -i  Start interactive REPL mode")}
+              ${c.dim("--session, -s <id> Resume a previous session")}
+              ${c.dim("sessions list      List recent sessions")}
+              ${c.dim("sessions show <id> Show session messages")}
+              ${c.dim("sessions delete <id> Delete a session")}
+              ${c.dim("sessions clear     Clear all sessions")}
+    ${c.success("artifacts")} List and manage knowledge artifacts
+              ${c.dim("show <name>        Show artifact content")}
+              ${c.dim("plan <name>        Convert artifact to a plan")}
+    ${c.success("version")}   Show installed package versions
+    ${c.success("upgrade")}   Update CLI and Telegram to the latest version
+
+  ${c.header(" OPTIONS ")}
+    ${c.secondary("--help")}           Show this help message
+    ${c.secondary("--provider")} <name>  AI provider: ${c.dim("claude")} or ${c.dim("codex")} (default: ${c.dim("claude")})
+    ${c.secondary("--model")} <name>     AI model (claude: ${c.dim("opus, sonnet, haiku")} | codex: ${c.dim("gpt-5.3-codex, gpt-5-codex-mini")})
+    ${c.secondary("--reasoning-effort")} <level>  Codex reasoning effort: ${c.dim("low, medium, high")} (default: model default)
+
+  ${c.header(" GETTING STARTED ")}
+    ${c.dim("$")} ${c.primary("locus init")}
+    ${c.dim("$")} ${c.primary("locus config setup")}
+    ${c.dim("$")} ${c.primary("locus telegram setup")}
+    ${c.dim("$")} ${c.primary("locus daemon start")}
 
   ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus service install")}
-    ${c.dim("$")} ${c.primary("locus service status")}
-    ${c.dim("$")} ${c.primary("locus service uninstall")}
+    ${c.dim("$")} ${c.primary("locus run")}
+    ${c.dim("$")} ${c.primary("locus docs sync")}
+    ${c.dim("$")} ${c.primary("locus review")}
+    ${c.dim("$")} ${c.primary("locus review local")}
+    ${c.dim("$")} ${c.primary("locus telegram start")}
+    ${c.dim("$")} ${c.primary('locus discuss "how should we design the auth system?"')}
+    ${c.dim("$")} ${c.primary("locus exec sessions list")}
+    ${c.dim("$")} ${c.primary("locus artifacts")}
+    ${c.dim("$")} ${c.primary("locus daemon start")}
+
+  For more information, visit: ${c.underline("https://docs.locusai.dev")}
 `);
 }
-function runShell(cmd, args) {
-  return new Promise((resolve2) => {
-    const proc = spawn4(cmd, args, { stdio: ["pipe", "pipe", "pipe"] });
-    let stdout = "";
-    let stderr = "";
-    proc.stdout?.on("data", (d) => {
-      stdout += d.toString();
-    });
-    proc.stderr?.on("data", (d) => {
-      stderr += d.toString();
-    });
-    proc.on("close", (exitCode) => resolve2({ exitCode, stdout, stderr }));
-    proc.on("error", (err) => resolve2({ exitCode: 1, stdout, stderr: err.message }));
-  });
-}
-async function killOrphanedProcesses() {
-  const result = await runShell("pgrep", ["-f", "locus-telegram"]);
-  const pids = result.stdout.trim().split(`
-`).filter((p) => p.length > 0);
-  if (pids.length === 0)
-    return;
-  console.log(`  ${c.info("▶")} Killing ${pids.length} orphaned locus-telegram process${pids.length > 1 ? "es" : ""}...`);
-  await runShell("pkill", ["-f", "locus-telegram"]);
-  await new Promise((resolve2) => setTimeout(resolve2, 2000));
-  const check2 = await runShell("pgrep", ["-f", "locus-telegram"]);
-  if (check2.stdout.trim().length > 0) {
-    await runShell("pkill", ["-9", "-f", "locus-telegram"]);
-  }
-}
-function generateSystemdUnit(projectPath, user2, binaryPath, servicePath) {
-  return `[Unit]
-Description=Locus AI Agent (Telegram bot + proposal scheduler)
-After=network-online.target
-Wants=network-online.target
+// src/commands/index-codebase.ts
+init_index_node();
+init_config_manager();
+import { parseArgs as parseArgs6 } from "node:util";
 
-[Service]
-Type=simple
-User=${user2}
-WorkingDirectory=${projectPath}
-ExecStart=${binaryPath}
-Restart=on-failure
-RestartSec=10
-Environment=PATH=${servicePath}
-Environment=HOME=${homedir3()}
+// src/tree-summarizer.ts
+init_index_node();
 
-[Install]
-WantedBy=multi-user.target
-`;
-}
-async function installSystemd(projectPath) {
-  const user2 = process.env.USER || "root";
-  const binaryPath = await findBinary();
-  if (!binaryPath) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("Could not find locus-telegram binary.")}
-` + `  Install with: ${c.primary("npm install -g @locusai/telegram")}
-`);
-    process.exit(1);
-  }
-  if (!await findBinDir("claude")) {
-    console.warn(`
-  ${c.secondary("⚠")} ${c.bold("Could not find 'claude' CLI in PATH.")}
-` + `  The service needs the Claude Code CLI to execute tasks.
-` + `  Install with: ${c.primary("npm install -g @anthropic-ai/claude-code")}
-`);
+class TreeSummarizer {
+  aiRunner;
+  constructor(aiRunner) {
+    this.aiRunner = aiRunner;
   }
-  if (!await findBinDir("codex")) {
-    console.warn(`
-  ${c.secondary("⚠")} ${c.bold("Could not find 'codex' CLI in PATH.")}
-` + `  The service needs the Codex CLI if using the Codex provider.
-` + `  Install with: ${c.primary("npm install -g @openai/codex")}
-`);
+  async summarize(tree) {
+    const prompt = `Analyze this file tree and generate a JSON index.
+Return ONLY a JSON object with this structure:
+{
+  "symbols": {},
+  "responsibilities": { "path": "Description" }
+}
+
+File Tree:
+${tree}`;
+    const output = await this.aiRunner.run(prompt);
+    const jsonStr = extractJsonFromLLMOutput(output);
+    return JSON.parse(jsonStr);
   }
-  const servicePath = await buildServicePath();
-  const unit = generateSystemdUnit(projectPath, user2, binaryPath, servicePath);
+}
+
+// src/commands/index-codebase.ts
+init_utils3();
+async function indexCommand(args) {
+  const { values } = parseArgs6({
+    args,
+    options: {
+      dir: { type: "string" },
+      model: { type: "string" },
+      provider: { type: "string" }
+    },
+    strict: false
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "index");
+  new ConfigManager(projectPath).updateVersion(VERSION2);
+  const provider = resolveProvider3(values.provider);
+  const model = values.model || DEFAULT_MODEL[provider];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model
+  });
+  const summarizer = new TreeSummarizer(aiRunner);
+  const indexer = new CodebaseIndexer(projectPath);
   console.log(`
-  ${c.info("▶")} Writing systemd unit to ${c.dim(SYSTEMD_UNIT_PATH)}`);
-  writeFileSync9(SYSTEMD_UNIT_PATH, unit, "utf-8");
-  console.log(`  ${c.info("▶")} Reloading systemd daemon...`);
-  await runShell("systemctl", ["daemon-reload"]);
-  console.log(`  ${c.info("▶")} Enabling and starting ${SERVICE_NAME}...`);
-  await runShell("systemctl", ["enable", SERVICE_NAME]);
-  const startResult = await runShell("systemctl", ["start", SERVICE_NAME]);
-  if (startResult.exitCode !== 0) {
+  ${c.step(" INDEX ")} ${c.primary("Analyzing codebase in")} ${c.bold(projectPath)}...`);
+  try {
+    const index = await indexer.index((msg) => console.log(`  ${c.dim(msg)}`), (tree) => summarizer.summarize(tree));
+    if (index) {
+      indexer.saveIndex(index);
+    }
+  } catch (error48) {
     console.error(`
-  ${c.error("✖")} Failed to start service: ${startResult.stderr.trim()}`);
-    console.error(`  ${c.dim("Check logs with:")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}`);
-    return;
-  }
-  console.log(`
-  ${c.success("✔")} ${c.bold("Locus service installed and running!")}
-
-  ${c.bold("Service:")} ${SERVICE_NAME}
-  ${c.bold("Unit file:")} ${SYSTEMD_UNIT_PATH}
-
-  ${c.bold("Useful commands:")}
-    ${c.dim("$")} ${c.primary(`sudo systemctl status ${SERVICE_NAME}`)}
-    ${c.dim("$")} ${c.primary(`sudo systemctl restart ${SERVICE_NAME}`)}
-    ${c.dim("$")} ${c.primary(`journalctl -u ${SERVICE_NAME} -f`)}
-`);
-}
-async function uninstallSystemd() {
-  if (!existsSync20(SYSTEMD_UNIT_PATH)) {
-    console.log(`
-  ${c.dim("No systemd service found. Nothing to remove.")}
-`);
-    await killOrphanedProcesses();
-    return;
+  ${c.error("✖")} ${c.error("Indexing failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}`);
+    console.error(c.dim(`  The agent might have limited context until indexing succeeds.
+`));
   }
-  console.log(`  ${c.info("▶")} Stopping and disabling ${SERVICE_NAME}...`);
-  await runShell("systemctl", ["stop", SERVICE_NAME]);
-  await runShell("systemctl", ["disable", SERVICE_NAME]);
-  const { unlinkSync: unlinkSync6 } = await import("node:fs");
-  unlinkSync6(SYSTEMD_UNIT_PATH);
-  await runShell("systemctl", ["daemon-reload"]);
-  await killOrphanedProcesses();
   console.log(`
-  ${c.success("✔")} ${c.bold("Locus service removed.")}
+  ${c.success("✔")} ${c.success("Indexing complete!")}
 `);
 }
-async function statusSystemd() {
-  const result = await runShell("systemctl", ["is-active", SERVICE_NAME]);
-  const state = result.stdout.trim();
-  if (state === "active") {
-    console.log(`
-  ${c.success("●")} ${c.bold("Locus service is running")} ${c.dim("(systemd)")}
-`);
-  } else if (existsSync20(SYSTEMD_UNIT_PATH)) {
-    console.log(`
-  ${c.secondary("●")} ${c.bold(`Locus service is ${state}`)} ${c.dim("(systemd)")}
-`);
-    console.log(`  ${c.dim("Start with:")} ${c.primary(`sudo systemctl start ${SERVICE_NAME}`)}
-`);
-  } else {
+// src/commands/init.ts
+init_index_node();
+init_config_manager();
+init_utils3();
+async function initCommand() {
+  const projectPath = process.cwd();
+  const configManager = new ConfigManager(projectPath);
+  if (isProjectInitialized(projectPath)) {
     console.log(`
-  ${c.secondary("●")} ${c.bold("Locus service is not installed")}
-`);
-    console.log(`  ${c.dim("Install with:")} ${c.primary("locus service install")}
-`);
-  }
-}
-function generatePlist(projectPath, binaryPath, binaryArgs, servicePath) {
-  const argsXml = [binaryPath, ...binaryArgs].map((a) => `    <string>${a}</string>`).join(`
-`);
-  const logDir = join20(homedir3(), "Library/Logs/Locus");
-  return `<?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>${PLIST_LABEL}</string>
-  <key>ProgramArguments</key>
-  <array>
-${argsXml}
-  </array>
-  <key>WorkingDirectory</key>
-  <string>${projectPath}</string>
-  <key>RunAtLoad</key>
-  <true/>
-  <key>KeepAlive</key>
-  <true/>
-  <key>StandardOutPath</key>
-  <string>${join20(logDir, "locus.log")}</string>
-  <key>StandardErrorPath</key>
-  <string>${join20(logDir, "locus-error.log")}</string>
-  <key>EnvironmentVariables</key>
-  <dict>
-    <key>PATH</key>
-    <string>${servicePath}</string>
-  </dict>
-</dict>
-</plist>
-`;
-}
-async function installLaunchd(projectPath) {
-  const plistPath = getPlistPath();
-  if (existsSync20(plistPath)) {
-    await runShell("launchctl", ["unload", plistPath]);
-  }
-  const binaryPath = await findBinary();
-  if (!binaryPath) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("Could not find locus-telegram binary.")}
-  Install with: ${c.primary("npm install -g @locusai/telegram")}
+  ${c.info("ℹ️")}  ${c.bold("Locus is already initialized. Updating configuration...")}
 `);
-    process.exit(1);
-  }
-  const binaryArgs = [];
-  if (!await findBinDir("claude")) {
-    console.warn(`
-  ${c.secondary("⚠")} ${c.bold("Could not find 'claude' CLI in PATH.")}
-  The service needs the Claude Code CLI to execute tasks.
-  Install with: ${c.primary("npm install -g @anthropic-ai/claude-code")}
+    const result = await configManager.reinit(VERSION2);
+    const updates = [];
+    if (result.versionUpdated) {
+      updates.push(`Version updated: ${c.dim(result.previousVersion || "unknown")} → ${c.primary(VERSION2)}`);
+    }
+    if (result.directoriesCreated.length > 0) {
+      updates.push(`Directories created: ${result.directoriesCreated.map((d) => c.dim(d)).join(", ")}`);
+    }
+    if (result.gitignoreUpdated) {
+      updates.push(`Gitignore updated with Locus patterns`);
+    }
+    if (updates.length === 0) {
+      console.log(`  ${c.success("✔")} ${c.success("Configuration is already up to date!")}
+
+  ${c.dim(`Version: ${VERSION2}`)}`);
+    } else {
+      console.log(`  ${c.success("✔")} ${c.success("Configuration updated successfully!")}
+
+  ${c.bold("Changes:")}
+    ${updates.map((u) => `${c.primary("•")} ${u}`).join(`
+    `)}
 `);
-  }
-  if (!await findBinDir("codex")) {
-    console.warn(`
-  ${c.secondary("⚠")} ${c.bold("Could not find 'codex' CLI in PATH.")}
-  The service needs the Codex CLI if using the Codex provider.
-  Install with: ${c.primary("npm install -g @openai/codex")}
+    }
+    console.log(`  ${c.bold("Next steps:")}
+    1. Run '${c.primary("locus config setup")}' to configure your API key
+    2. Run '${c.primary("locus index")}' to index your codebase
+    3. Run '${c.primary("locus run")}' to start an agent
+
+  For more information, visit: ${c.underline("https://docs.locusai.dev")}
 `);
-  }
-  const logDir = join20(homedir3(), "Library/Logs/Locus");
-  const { mkdirSync: mkdirSync10 } = await import("node:fs");
-  mkdirSync10(logDir, { recursive: true });
-  const launchAgentsDir = join20(homedir3(), "Library/LaunchAgents");
-  mkdirSync10(launchAgentsDir, { recursive: true });
-  const servicePath = await buildServicePath();
-  const plist = generatePlist(projectPath, binaryPath, binaryArgs, servicePath);
-  console.log(`
-  ${c.info("▶")} Writing plist to ${c.dim(plistPath)}`);
-  writeFileSync9(plistPath, plist, "utf-8");
-  console.log(`  ${c.info("▶")} Loading service...`);
-  const loadResult = await runShell("launchctl", ["load", plistPath]);
-  if (loadResult.exitCode !== 0) {
-    console.error(`
-  ${c.error("✖")} Failed to load service: ${loadResult.stderr.trim()}`);
     return;
   }
-  const logPath = join20(logDir, "locus.log");
+  await configManager.init(VERSION2);
   console.log(`
-  ${c.success("✔")} ${c.bold("Locus service installed and running!")}
+  ${c.success("✨ Locus initialized successfully!")}
 
-  ${c.bold("Plist:")} ${plistPath}
-  ${c.bold("Logs:")}  ${logPath}
+  ${c.bold("Created:")}
+    ${c.primary("\uD83D\uDCC1")} ${c.bold(".locus/")}                     ${c.dim("Configuration directory")}
+    ${c.primary("\uD83D\uDCC4")} ${c.bold(".locus/config.json")}          ${c.dim("Project settings")}
+    ${c.primary("\uD83D\uDCDD")} ${c.bold(".locus/LOCUS.md")}             ${c.dim("AI agent instructions")}
+    ${c.primary("\uD83D\uDCDD")} ${c.bold(".locus/LEARNINGS.md")}         ${c.dim("Continuous learning log")}
 
-  ${c.bold("Useful commands:")}
-    ${c.dim("$")} ${c.primary(`launchctl list | grep ${PLIST_LABEL}`)}
-    ${c.dim("$")} ${c.primary(`tail -f ${logPath}`)}
+  ${c.bold("Next steps:")}
+    1. Run '${c.primary("locus config setup")}' to configure your API key
+    2. Run '${c.primary("locus index")}' to index your codebase
+    3. Run '${c.primary("locus run")}' to start an agent
+
+  For more information, visit: ${c.underline("https://docs.locusai.dev")}
 `);
 }
-async function uninstallLaunchd() {
-  const plistPath = getPlistPath();
-  if (!existsSync20(plistPath)) {
-    console.log(`
-  ${c.dim("No launchd service found. Nothing to remove.")}
-`);
-    await killOrphanedProcesses();
-    return;
+
+// src/commands/index.ts
+init_plan();
+
+// src/commands/review.ts
+init_index_node();
+init_config_manager();
+init_settings_manager();
+init_utils3();
+init_workspace_resolver();
+import { existsSync as existsSync21, mkdirSync as mkdirSync10, writeFileSync as writeFileSync9 } from "node:fs";
+import { join as join21 } from "node:path";
+import { parseArgs as parseArgs7 } from "node:util";
+async function reviewCommand(args) {
+  const subcommand = args[0];
+  if (subcommand === "local") {
+    return reviewLocalCommand(args.slice(1));
   }
-  console.log(`  ${c.info("▶")} Unloading service...`);
-  await runShell("launchctl", ["unload", plistPath]);
-  const { unlinkSync: unlinkSync6 } = await import("node:fs");
-  unlinkSync6(plistPath);
-  await killOrphanedProcesses();
-  console.log(`
-  ${c.success("✔")} ${c.bold("Locus service removed.")}
-`);
+  return reviewPrsCommand(args);
 }
-async function statusLaunchd() {
-  const plistPath = getPlistPath();
-  if (!existsSync20(plistPath)) {
+async function reviewPrsCommand(args) {
+  const { values } = parseArgs7({
+    args,
+    options: {
+      "api-key": { type: "string" },
+      workspace: { type: "string" },
+      model: { type: "string" },
+      provider: { type: "string" },
+      "api-url": { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "review");
+  const configManager = new ConfigManager(projectPath);
+  configManager.updateVersion(VERSION2);
+  const settingsManager = new SettingsManager(projectPath);
+  const settings = settingsManager.load();
+  const apiKey = values["api-key"] || settings.apiKey;
+  if (!apiKey) {
+    console.error(c.error("Error: API key is required for PR review"));
+    console.error(c.dim(`Configure with: locus config setup --api-key <key>
+  Or pass --api-key flag`));
+    console.error(c.dim("For local staged-changes review, use: locus review local"));
+    process.exit(1);
+  }
+  const provider = resolveProvider3(values.provider || settings.provider);
+  const model = values.model || settings.model || DEFAULT_MODEL[provider];
+  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
+  let workspaceId;
+  try {
+    const resolver = new WorkspaceResolver({
+      apiKey,
+      apiBase,
+      workspaceId: values.workspace
+    });
+    workspaceId = await resolver.resolve();
+  } catch (error48) {
+    console.error(c.error(error48 instanceof Error ? error48.message : String(error48)));
+    process.exit(1);
+  }
+  const log = (msg, level = "info") => {
+    const colorFn = {
+      info: c.cyan,
+      success: c.green,
+      warn: c.yellow,
+      error: c.red
+    }[level];
+    const prefix = { info: "ℹ", success: "✓", warn: "⚠", error: "✗" }[level];
+    console.log(`  ${colorFn(`${prefix} ${msg}`)}`);
+  };
+  const prService = new PrService(projectPath, log);
+  const unreviewedPrs = prService.listUnreviewedLocusPrs();
+  if (unreviewedPrs.length === 0) {
     console.log(`
-  ${c.secondary("●")} ${c.bold("Locus service is not installed")}
-`);
-    console.log(`  ${c.dim("Install with:")} ${c.primary("locus service install")}
+  ${c.dim("No unreviewed Locus PRs found.")}
 `);
     return;
   }
-  const result = await runShell("launchctl", ["list"]);
-  const lines = result.stdout.split(`
-`);
-  const match = lines.find((l) => l.includes(PLIST_LABEL));
-  if (match) {
-    const parts = match.trim().split(/\s+/);
-    const pid = parts[0] === "-" ? null : parts[0];
-    if (pid) {
-      console.log(`
-  ${c.success("●")} ${c.bold("Locus service is running")} ${c.dim(`(PID ${pid}, launchd)`)}
-`);
-    } else {
-      console.log(`
-  ${c.secondary("●")} ${c.bold("Locus service is stopped")} ${c.dim("(launchd)")}
-`);
-      console.log(`  ${c.dim("Start with:")} ${c.primary(`launchctl load ${plistPath}`)}
+  console.log(`
+  ${c.primary("\uD83D\uDD0D")} ${c.bold(`Found ${unreviewedPrs.length} unreviewed PR(s). Starting reviewer...`)}
 `);
-    }
-  } else {
+  const agentId = `reviewer-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+  const reviewer = new ReviewerWorker({
+    agentId,
+    workspaceId,
+    apiBase,
+    projectPath,
+    apiKey,
+    model,
+    provider
+  });
+  let isShuttingDown = false;
+  const handleSignal = () => {
+    if (isShuttingDown)
+      return;
+    isShuttingDown = true;
     console.log(`
-  ${c.secondary("●")} ${c.bold("Locus service is not loaded")} ${c.dim("(plist exists but not loaded)")}
-`);
-    console.log(`  ${c.dim("Load with:")} ${c.primary(`launchctl load ${plistPath}`)}
-`);
-  }
-}
-function getPlatform() {
-  if (process.platform === "linux")
-    return "linux";
-  if (process.platform === "darwin")
-    return "darwin";
-  return null;
+${c.info("Received shutdown signal. Stopping reviewer...")}`);
+    process.exit(0);
+  };
+  process.on("SIGINT", handleSignal);
+  process.on("SIGTERM", handleSignal);
+  await reviewer.run();
 }
-async function installCommand(projectPath) {
-  const platform = getPlatform();
-  if (!platform) {
-    console.error(`
-  ${c.error("✖")} ${c.bold(`Unsupported platform: ${process.platform}`)}
-  Service management is supported on Linux (systemd) and macOS (launchd).
-`);
-    process.exit(1);
-  }
-  const manager = new SettingsManager(projectPath);
-  const settings = manager.load();
-  if (!settings.telegram?.botToken || !settings.telegram?.chatId) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("Telegram is not configured.")}
-  Run ${c.primary("locus telegram setup")} first.
+async function reviewLocalCommand(args) {
+  const { values } = parseArgs7({
+    args,
+    options: {
+      model: { type: "string" },
+      provider: { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "review local");
+  const localSettings = new SettingsManager(projectPath).load();
+  const provider = resolveProvider3(values.provider || localSettings.provider);
+  const model = values.model || localSettings.model || DEFAULT_MODEL[provider];
+  const aiRunner = createAiRunner(provider, {
+    projectPath,
+    model
+  });
+  const reviewService = new ReviewService({
+    aiRunner,
+    projectPath,
+    log: (msg, level) => {
+      switch (level) {
+        case "error":
+          console.log(`  ${c.error("✖")} ${msg}`);
+          break;
+        case "success":
+          console.log(`  ${c.success("✔")} ${msg}`);
+          break;
+        default:
+          console.log(`  ${c.dim(msg)}`);
+      }
+    }
+  });
+  console.log(`
+  ${c.primary("\uD83D\uDD0D")} ${c.bold("Reviewing staged changes...")}
 `);
-    process.exit(1);
-  }
-  if (!settings.apiKey) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("API key is not configured.")}
-  Run ${c.primary("locus config setup --api-key <key>")} first.
+  const report = await reviewService.reviewStagedChanges(null);
+  if (!report) {
+    console.log(`  ${c.dim("No changes to review.")}
 `);
-    process.exit(1);
+    return;
   }
-  if (platform === "linux") {
-    await installSystemd(projectPath);
-  } else {
-    await installLaunchd(projectPath);
+  const reviewsDir = join21(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
+  if (!existsSync21(reviewsDir)) {
+    mkdirSync10(reviewsDir, { recursive: true });
   }
-}
-async function uninstallCommand() {
-  const platform = getPlatform();
-  if (!platform) {
-    console.error(`
-  ${c.error("✖")} Unsupported platform: ${process.platform}
+  const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+  const reportPath = join21(reviewsDir, `review-${timestamp}.md`);
+  writeFileSync9(reportPath, report, "utf-8");
+  console.log(`
+  ${c.success("✔")} ${c.success("Review complete!")}`);
+  console.log(`  ${c.dim("Report saved to:")} ${c.primary(reportPath)}
 `);
-    process.exit(1);
-  }
-  if (platform === "linux") {
-    await uninstallSystemd();
-  } else {
-    await uninstallLaunchd();
-  }
 }
-async function statusCommandHandler() {
-  const platform = getPlatform();
-  if (!platform) {
-    console.error(`
-  ${c.error("✖")} Unsupported platform: ${process.platform}
-`);
+// src/commands/run.ts
+init_index_node();
+init_config_manager();
+init_settings_manager();
+init_utils3();
+init_workspace_resolver();
+import { parseArgs as parseArgs8 } from "node:util";
+async function runCommand(args) {
+  const { values } = parseArgs8({
+    args,
+    options: {
+      "api-key": { type: "string" },
+      workspace: { type: "string" },
+      sprint: { type: "string" },
+      model: { type: "string" },
+      provider: { type: "string" },
+      "reasoning-effort": { type: "string" },
+      "skip-planning": { type: "boolean" },
+      "api-url": { type: "string" },
+      dir: { type: "string" }
+    },
+    strict: false
+  });
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "run");
+  const configManager = new ConfigManager(projectPath);
+  configManager.updateVersion(VERSION2);
+  const settingsManager = new SettingsManager(projectPath);
+  const settings = settingsManager.load();
+  const apiKey = values["api-key"] || settings.apiKey;
+  if (!apiKey) {
+    console.error(c.error("Error: API key is required"));
+    console.error(c.dim(`Configure with: locus config setup --api-key <key>
+  Or pass --api-key flag`));
     process.exit(1);
   }
-  if (platform === "linux") {
-    await statusSystemd();
-  } else {
-    await statusLaunchd();
+  let workspaceId = values.workspace;
+  const provider = resolveProvider3(values.provider || settings.provider);
+  const model = values.model || settings.model || DEFAULT_MODEL[provider];
+  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
+  try {
+    const resolver = new WorkspaceResolver({
+      apiKey,
+      apiBase,
+      workspaceId: values.workspace
+    });
+    workspaceId = await resolver.resolve();
+  } catch (error48) {
+    console.error(c.error(error48 instanceof Error ? error48.message : String(error48)));
+    process.exit(1);
   }
+  const reasoningEffort = values["reasoning-effort"];
+  const orchestrator = new AgentOrchestrator({
+    workspaceId,
+    sprintId: values.sprint || "",
+    model,
+    provider,
+    reasoningEffort,
+    apiBase,
+    maxIterations: 100,
+    projectPath,
+    apiKey
+  });
+  orchestrator.on("agent:spawned", (data) => console.log(`  ${c.info("●")} ${c.bold("Agent spawned:")} ${data.agentId}`));
+  orchestrator.on("task:assigned", (data) => console.log(`  ${c.info("●")} ${c.bold("Claimed:")} ${data.title}`));
+  orchestrator.on("task:completed", (data) => console.log(`  ${c.success("✔")} ${c.success("Completed:")} ${c.dim(data.taskId)}`));
+  orchestrator.on("task:failed", (data) => console.log(`  ${c.error("✖")} ${c.error("Failed:")} ${c.bold(data.taskId)}: ${data.error}`));
+  orchestrator.on("agent:stale", (data) => console.log(`  ${c.error("⚠")} ${c.error("Stale agent killed:")} ${data.agentId}`));
+  let isShuttingDown = false;
+  const handleSignal = async (signal) => {
+    if (isShuttingDown)
+      return;
+    isShuttingDown = true;
+    console.log(`
+${c.info(`Received ${signal}. Stopping agent and cleaning up...`)}`);
+    await orchestrator.stop();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => handleSignal("SIGINT"));
+  process.on("SIGTERM", () => handleSignal("SIGTERM"));
+  console.log(`
+  ${c.primary("\uD83D\uDE80")} ${c.bold("Starting agent in")} ${c.primary(projectPath)}...`);
+  console.log(`  ${c.dim("Tasks will be executed sequentially on a single branch")}`);
+  console.log(`  ${c.dim("Changes will be committed and pushed after each task")}`);
+  console.log(`  ${c.dim("A PR will be opened when all tasks are done")}`);
+  await orchestrator.start();
 }
+// src/commands/service.ts
+init_index_node();
 async function serviceCommand(args) {
-  const projectPath = process.cwd();
-  requireInitialization(projectPath, "service");
   const subcommand = args[0];
-  switch (subcommand) {
-    case "install":
-      await installCommand(projectPath);
-      break;
-    case "uninstall":
-      await uninstallCommand();
-      break;
-    case "status":
-      await statusCommandHandler();
-      break;
-    default:
-      showServiceHelp();
+  const mapping = {
+    install: "start",
+    uninstall: "stop",
+    status: "status"
+  };
+  const mapped = subcommand ? mapping[subcommand] : undefined;
+  if (mapped) {
+    console.log(`  ${c.dim(`Hint: 'locus service ${subcommand}' is now 'locus daemon ${mapped}'`)}
+`);
+    await daemonCommand([mapped, ...args.slice(1)]);
+  } else {
+    await daemonCommand(args);
   }
 }
 // src/commands/telegram.ts
 init_index_node();
 init_settings_manager();
 import { spawn as spawn5 } from "node:child_process";
-import { existsSync as existsSync21 } from "node:fs";
-import { join as join21 } from "node:path";
+import { existsSync as existsSync22 } from "node:fs";
+import { join as join22 } from "node:path";
 import { createInterface as createInterface2 } from "node:readline";
 function ask2(question) {
   const rl = createInterface2({
@@ -46774,7 +46836,7 @@ function showTelegramHelp() {
     ${c.primary("locus telegram")} ${c.dim("<subcommand> [options]")}
 
   ${c.header(" SUBCOMMANDS ")}
-    ${c.success("run")}       Start the Telegram bot
+    ${c.success("start")}     Start the Telegram bot
     ${c.success("setup")}     Interactive Telegram bot setup (or pass flags below)
     ${c.success("config")}    Show current Telegram configuration
     ${c.success("set")}       Set a config value
@@ -46783,7 +46845,7 @@ function showTelegramHelp() {
     ${c.success("remove")}    Remove Telegram configuration
 
   ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus telegram run")}
+    ${c.dim("$")} ${c.primary("locus telegram start")}
     ${c.dim("$")} ${c.primary('locus telegram setup --token "123:ABC" --chat-id 987654')}
     ${c.dim("$")} ${c.primary("locus telegram config")}
     ${c.dim("$")} ${c.primary("locus telegram remove")}
@@ -46794,7 +46856,7 @@ function showTelegramHelp() {
     ${c.primary("locus config set <key> <value>")}
 `);
 }
-async function setupCommand2(args, projectPath) {
+async function setup(args, projectPath) {
   let token;
   let chatId;
   for (let i = 0;i < args.length; i++) {
@@ -46866,11 +46928,11 @@ async function setupCommand2(args, projectPath) {
     ${c.primary("Chat ID:")}  ${parsedChatId}
 
   ${c.bold("Next steps:")}
-    Install as service: ${c.primary("locus service install")}
-    Or run manually:    ${c.primary("locus telegram run")}
+    Start as daemon:  ${c.primary("locus daemon start")}
+    Or run manually:  ${c.primary("locus telegram start")}
 `);
 }
-function configCommand2(projectPath) {
+function showConfig(projectPath) {
   const manager = new SettingsManager(projectPath);
   const settings = manager.load();
   const tg = settings.telegram;
@@ -46886,36 +46948,28 @@ function configCommand2(projectPath) {
   console.log(`  ${c.dim("File: .locus/settings.json (telegram section)")}
 `);
   const entries = [];
-  if (tg.botToken) {
+  if (tg.botToken)
     entries.push(["botToken", maskToken(tg.botToken)]);
-  }
-  if (tg.chatId) {
+  if (tg.chatId)
     entries.push(["chatId", String(tg.chatId)]);
-  }
-  if (tg.testMode !== undefined) {
+  if (tg.testMode !== undefined)
     entries.push(["testMode", String(tg.testMode)]);
-  }
-  if (settings.apiKey) {
+  if (settings.apiKey)
     entries.push(["apiKey (shared)", maskToken(settings.apiKey)]);
-  }
-  if (settings.apiUrl) {
+  if (settings.apiUrl)
     entries.push(["apiUrl (shared)", settings.apiUrl]);
-  }
-  if (settings.provider) {
+  if (settings.provider)
     entries.push(["provider (shared)", settings.provider]);
-  }
-  if (settings.model) {
+  if (settings.model)
     entries.push(["model (shared)", settings.model]);
-  }
-  if (settings.workspaceId) {
+  if (settings.workspaceId)
     entries.push(["workspaceId (shared)", settings.workspaceId]);
-  }
   for (const [key, value] of entries) {
     console.log(`    ${c.primary(`${key}:`)}  ${value}`);
   }
   console.log("");
 }
-function setCommand2(args, projectPath) {
+function setValue(args, projectPath) {
   const key = args[0]?.trim();
   const value = args.slice(1).join(" ").trim();
   if (!key || !value) {
@@ -46958,7 +47012,7 @@ function setCommand2(args, projectPath) {
   ${c.success("✔")} Set ${c.primary(key)} = ${displayValue}
 `);
 }
-function removeCommand2(projectPath) {
+function removeConfig(projectPath) {
   const manager = new SettingsManager(projectPath);
   const settings = manager.load();
   if (!settings.telegram) {
@@ -46973,7 +47027,7 @@ function removeCommand2(projectPath) {
   ${c.success("✔")} ${c.bold("Telegram configuration removed.")}
 `);
 }
-function runBotCommand(projectPath) {
+function startBot(projectPath) {
   const manager = new SettingsManager(projectPath);
   const settings = manager.load();
   if (!settings.telegram?.botToken || !settings.telegram?.chatId) {
@@ -46983,22 +47037,14 @@ function runBotCommand(projectPath) {
 `);
     process.exit(1);
   }
-  const monorepoTelegramEntry = join21(projectPath, "packages/telegram/src/index.ts");
-  const isMonorepo = existsSync21(monorepoTelegramEntry);
-  let cmd;
-  let args;
-  if (isMonorepo) {
-    cmd = "bun";
-    args = ["run", monorepoTelegramEntry];
-  } else {
-    cmd = "locus-telegram";
-    args = [];
-  }
-  const env = { ...process.env };
-  const child = spawn5(cmd, args, {
+  const monorepoEntry = join22(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync22(monorepoEntry);
+  const cmd = isMonorepo ? "bun" : "locus-telegram";
+  const cmdArgs = isMonorepo ? ["run", monorepoEntry] : [];
+  const child = spawn5(cmd, cmdArgs, {
     cwd: projectPath,
     stdio: "inherit",
-    env
+    env: { ...process.env }
   });
   child.on("error", (err) => {
     if (err.code === "ENOENT" && !isMonorepo) {
@@ -47019,22 +47065,23 @@ function runBotCommand(projectPath) {
 }
 async function telegramCommand(args) {
   const projectPath = process.cwd();
-  const subcommand = args[0];
+  const [subcommand, ...subArgs] = args;
   switch (subcommand) {
+    case "start":
     case "run":
-      runBotCommand(projectPath);
+      startBot(projectPath);
       break;
     case "setup":
-      await setupCommand2(args, projectPath);
+      await setup(subArgs, projectPath);
       break;
     case "config":
-      configCommand2(projectPath);
+      showConfig(projectPath);
       break;
     case "set":
-      setCommand2(args, projectPath);
+      setValue(subArgs, projectPath);
       break;
     case "remove":
-      removeCommand2(projectPath);
+      removeConfig(projectPath);
       break;
     default:
       showTelegramHelp();
@@ -47043,10 +47090,7 @@ async function telegramCommand(args) {
 // src/commands/upgrade.ts
 init_index_node();
 import { execSync as execSync3 } from "node:child_process";
-import { existsSync as existsSync22 } from "node:fs";
 var PACKAGES = ["@locusai/cli", "@locusai/telegram"];
-var SYSTEMD_UNIT_PATH2 = "/etc/systemd/system/locus.service";
-var SYSTEMD_TELEGRAM_UNIT_PATH = "/etc/systemd/system/locus-telegram.service";
 function getInstalledVersion(pkg) {
   try {
     const output = execSync3(`npm list -g ${pkg} --depth=0 --json`, {
@@ -47073,6 +47117,7 @@ async function upgradeCommand() {
   console.log(`
   ${c.header(" UPGRADE ")}
 `);
+  const daemonWasRunning = await isDaemonRunning();
   try {
     console.log(`  ${c.dim("◌")} Cleaning npm cache...`);
     execSync3("npm cache clean --force", {
@@ -47084,6 +47129,7 @@ async function upgradeCommand() {
     console.log(`  ${c.dim("⚠")} Could not clean npm cache, continuing...
 `);
   }
+  let anyUpdated = false;
   for (const pkg of PACKAGES) {
     const current = getInstalledVersion(pkg);
     const latest = getLatestVersion(pkg);
@@ -47106,33 +47152,26 @@ async function upgradeCommand() {
       });
       console.log(`  ${c.success("✔")} ${c.bold(pkg)} updated to ${c.primary(`v${latest}`)}
 `);
+      anyUpdated = true;
     } catch {
       console.error(`  ${c.error("✖")} Failed to update ${c.bold(pkg)}. Try manually:
 ` + `    ${c.primary(`npm install -g ${pkg}@latest`)}
 `);
     }
   }
-  if (process.platform === "linux") {
-    for (const unit of [SYSTEMD_UNIT_PATH2, SYSTEMD_TELEGRAM_UNIT_PATH]) {
-      if (!existsSync22(unit))
-        continue;
-      const split = unit.split("/").pop();
-      if (!split) {
-        throw "PATH NOTH FOUND";
-      }
-      const name = split.replace(".service", "");
-      try {
-        console.log(`  ${c.info("▶")} Restarting ${name} service...`);
-        execSync3(`systemctl restart ${name}`, {
-          stdio: ["pipe", "pipe", "pipe"]
-        });
-        console.log(`  ${c.success("✔")} ${name} service restarted
+  if (daemonWasRunning && anyUpdated) {
+    console.log(`  ${c.info("▶")} Restarting locus daemon...`);
+    const restarted = await restartDaemonIfRunning();
+    if (restarted) {
+      console.log(`  ${c.success("✔")} Locus daemon restarted
 `);
-      } catch {
-        console.log(`  ${c.dim("⚠")} Could not restart ${name} service (may need sudo)
+    } else {
+      console.log(`  ${c.dim("⚠")} Could not restart daemon (may need sudo)
 `);
-      }
     }
+  } else if (daemonWasRunning && !anyUpdated) {
+    console.log(`  ${c.dim("No updates — daemon left running")}
+`);
   }
   console.log("");
 }
@@ -47205,6 +47244,9 @@ async function main() {
     case "config":
       await configCommand(args);
       break;
+    case "daemon":
+      await daemonCommand(args);
+      break;
     case "service":
       await serviceCommand(args);
       break;