@locusai/cli 0.14.2 → 0.14.3

package/bin/locus.js

@@ -41904,133 +41904,446 @@ var init_index_node = __esm(() => {
   init_planning();
 });
 
-// src/display/tool-display.ts
-import * as path2 from "node:path";
-
-class ToolDisplay {
-  formatToolStart(tool) {
-    const lines = [];
-    switch (tool.name) {
-      case "Read":
-        lines.push(...this.formatReadTool(tool));
-        break;
-      case "Write":
-        lines.push(...this.formatWriteTool(tool));
-        break;
-      case "Edit":
-        lines.push(...this.formatEditTool(tool));
-        break;
-      case "Bash":
-        lines.push(...this.formatBashTool(tool));
-        break;
-      case "Grep":
-        lines.push(...this.formatGrepTool(tool));
-        break;
-      case "Glob":
-        lines.push(...this.formatGlobTool(tool));
-        break;
-      case "WebFetch":
-        lines.push(...this.formatWebFetchTool(tool));
-        break;
-      case "Task":
-        lines.push(...this.formatTaskTool(tool));
-        break;
-      default:
-        lines.push(...this.formatGenericTool(tool));
+// src/utils/version.ts
+import { existsSync as existsSync12, readFileSync as readFileSync11 } from "node:fs";
+import { dirname as dirname3, join as join12 } from "node:path";
+import { fileURLToPath as fileURLToPath3 } from "node:url";
+function getVersion() {
+  try {
+    const __filename2 = fileURLToPath3(import.meta.url);
+    const __dirname2 = dirname3(__filename2);
+    const bundledPath = join12(__dirname2, "..", "package.json");
+    const sourcePath = join12(__dirname2, "..", "..", "package.json");
+    if (existsSync12(bundledPath)) {
+      const pkg = JSON.parse(readFileSync11(bundledPath, "utf-8"));
+      if (pkg.name === "@locusai/cli") {
+        return pkg.version || "0.0.0";
+      }
     }
-    return lines;
-  }
-  formatToolResult(tool, result) {
-    const lines = [];
-    if (result.success) {
-      const durationStr = result.duration ? ` (${result.duration}ms)` : "";
-      lines.push(c.green(`   ✓ Completed${durationStr}`));
-      const resultDetails = this.formatResultDetails(tool.name, result.data);
-      if (resultDetails) {
-        lines.push(c.dim(`   ${resultDetails}`));
+    if (existsSync12(sourcePath)) {
+      const pkg = JSON.parse(readFileSync11(sourcePath, "utf-8"));
+      if (pkg.name === "@locusai/cli") {
+        return pkg.version || "0.0.0";
       }
-    } else {
-      const errorMsg = result.error ? this.truncate(result.error, 60) : "Unknown error";
-      lines.push(c.red(`   ✗ Failed: ${errorMsg}`));
     }
-    return lines;
+  } catch {}
+  return "0.0.0";
+}
+var VERSION2;
+var init_version = __esm(() => {
+  VERSION2 = getVersion();
+});
+
+// src/utils/banner.ts
+function printBanner() {
+  console.log(c.primary(`
+ _      ____   ____ _   _  ____
+| |    / __ \\ / ___| | | |/ ___|
+| |   | |  | | |   | | | |\\___ \\
+| |___| |__| | |___| |_| |___) |
+|_____|\\____/ \\____|\\___/|____/  ${c.dim(`v${VERSION2}`)}
+    `));
+}
+var init_banner = __esm(() => {
+  init_index_node();
+  init_version();
+});
+
+// src/utils/helpers.ts
+import { existsSync as existsSync13 } from "node:fs";
+import { join as join13 } from "node:path";
+function isProjectInitialized(projectPath) {
+  const locusDir = join13(projectPath, LOCUS_CONFIG.dir);
+  const configPath = join13(locusDir, LOCUS_CONFIG.configFile);
+  return existsSync13(locusDir) && existsSync13(configPath);
+}
+function requireInitialization(projectPath, command) {
+  if (!isProjectInitialized(projectPath)) {
+    console.error(`
+  ${c.error("✖ Error")} ${c.red(`Locus is not initialized in this directory.`)}
+
+  The '${c.bold(command)}' command requires a Locus project to be initialized.
+
+  To initialize Locus in this directory, run:
+    ${c.primary("locus init")}
+
+  This will create a ${c.dim(".locus")} directory with the necessary configuration.
+`);
+    process.exit(1);
   }
-  formatReadTool(tool) {
-    const params = tool.parameters;
-    const lines = [];
-    if (params?.file_path) {
-      const fileName = path2.basename(params.file_path);
-      const dirPath = this.formatPath(params.file_path);
-      lines.push(c.cyan(`\uD83D\uDCD6 Reading ${c.bold(fileName)}`));
-      lines.push(c.dim(`   ${dirPath}`));
-      if (params.offset !== undefined || params.limit !== undefined) {
-        const rangeInfo = [];
-        if (params.offset !== undefined)
-          rangeInfo.push(`offset: ${params.offset}`);
-        if (params.limit !== undefined)
-          rangeInfo.push(`limit: ${params.limit}`);
-        lines.push(c.dim(`   (${rangeInfo.join(", ")})`));
+}
+function resolveProvider3(input) {
+  if (!input)
+    return PROVIDER.CLAUDE;
+  if (input === PROVIDER.CLAUDE || input === PROVIDER.CODEX)
+    return input;
+  console.error(c.error(`Error: invalid provider '${input}'. Use 'claude' or 'codex'.`));
+  process.exit(1);
+}
+var init_helpers2 = __esm(() => {
+  init_index_node();
+});
+
+// src/utils/index.ts
+var init_utils3 = __esm(() => {
+  init_banner();
+  init_helpers2();
+  init_version();
+});
+
+// src/display/execution-stats.ts
+class ExecutionStatsTracker {
+  startTime;
+  endTime = null;
+  toolTimings = new Map;
+  toolOrder = [];
+  tokensUsed = null;
+  error = null;
+  constructor() {
+    this.startTime = Date.now();
+  }
+  toolStarted(toolName, toolId) {
+    const key = toolId ?? `${toolName}-${Date.now()}`;
+    this.toolTimings.set(key, {
+      name: toolName,
+      id: toolId,
+      startTime: Date.now()
+    });
+    this.toolOrder.push(key);
+  }
+  toolCompleted(toolName, toolId) {
+    const key = this.findToolKey(toolName, toolId);
+    if (key) {
+      const timing = this.toolTimings.get(key);
+      if (timing) {
+        timing.endTime = Date.now();
+        timing.duration = timing.endTime - timing.startTime;
+        timing.success = true;
       }
-    } else {
-      lines.push(c.cyan("\uD83D\uDCD6 Reading file"));
     }
-    return lines;
   }
-  formatWriteTool(tool) {
-    const params = tool.parameters;
-    const lines = [];
-    if (params?.file_path) {
-      const fileName = path2.basename(params.file_path);
-      const dirPath = this.formatPath(params.file_path);
-      const size = params.content?.length ?? 0;
-      lines.push(c.cyan(`✍️  Writing ${c.bold(fileName)}`));
-      lines.push(c.dim(`   ${dirPath} (${this.formatBytes(size)})`));
-    } else {
-      lines.push(c.cyan("✍️  Writing file"));
+  toolFailed(toolName, error48, toolId) {
+    const key = this.findToolKey(toolName, toolId);
+    if (key) {
+      const timing = this.toolTimings.get(key);
+      if (timing) {
+        timing.endTime = Date.now();
+        timing.duration = timing.endTime - timing.startTime;
+        timing.success = false;
+        timing.error = error48;
+      }
     }
-    return lines;
   }
-  formatEditTool(tool) {
-    const params = tool.parameters;
-    const lines = [];
-    if (params?.file_path) {
-      const fileName = path2.basename(params.file_path);
-      const dirPath = this.formatPath(params.file_path);
-      lines.push(c.cyan(`✏️  Editing ${c.bold(fileName)}`));
-      lines.push(c.dim(`   ${dirPath}`));
-      if (params.replace_all) {
-        lines.push(c.dim("   (replace all occurrences)"));
+  setTokensUsed(tokens) {
+    this.tokensUsed = tokens;
+  }
+  setError(error48) {
+    this.error = error48;
+  }
+  finalize() {
+    this.endTime = Date.now();
+    const toolsUsed = [];
+    const seenTools = new Set;
+    for (const key of this.toolOrder) {
+      const timing = this.toolTimings.get(key);
+      if (timing && !seenTools.has(timing.name)) {
+        seenTools.add(timing.name);
+        toolsUsed.push(timing.name);
       }
-    } else {
-      lines.push(c.cyan("✏️  Editing file"));
     }
-    return lines;
+    const toolTimings = this.toolOrder.map((key) => this.toolTimings.get(key)).filter((t) => t !== undefined);
+    const stats = {
+      duration: this.endTime - this.startTime,
+      toolsUsed,
+      toolTimings,
+      success: this.error === null
+    };
+    if (this.tokensUsed !== null) {
+      stats.tokensUsed = this.tokensUsed;
+    }
+    if (this.error !== null) {
+      stats.error = this.error;
+    }
+    return stats;
   }
-  formatBashTool(tool) {
-    const params = tool.parameters;
-    const lines = [];
-    if (params) {
-      const description = params.description || "Running command";
-      lines.push(c.cyan(`⚡ ${description}`));
-      if (params.command) {
-        const truncatedCmd = this.truncate(params.command, 80);
-        lines.push(c.dim(`   $ ${truncatedCmd}`));
+  getCurrentDuration() {
+    return Date.now() - this.startTime;
+  }
+  findToolKey(toolName, toolId) {
+    if (toolId && this.toolTimings.has(toolId)) {
+      return toolId;
+    }
+    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
+      const key = this.toolOrder[i];
+      const timing = this.toolTimings.get(key);
+      if (timing && timing.name === toolName && timing.endTime === undefined) {
+        return key;
       }
-      if (params.timeout) {
-        lines.push(c.dim(`   (timeout: ${params.timeout}ms)`));
+    }
+    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
+      const key = this.toolOrder[i];
+      const timing = this.toolTimings.get(key);
+      if (timing && timing.name === toolName) {
+        return key;
       }
-    } else {
-      lines.push(c.cyan("⚡ Running command"));
     }
-    return lines;
+    return null;
   }
-  formatGrepTool(tool) {
-    const params = tool.parameters;
-    const lines = [];
-    if (params?.pattern) {
-      const truncatedPattern = this.truncate(params.pattern, 40);
-      lines.push(c.cyan(`\uD83D\uDD0D Searching for "${truncatedPattern}"`));
-      const searchScope = [];
+}
+
+// src/display/json-stream-renderer.ts
+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)}
+`);
+  }
+}
+var init_json_stream_renderer = __esm(() => {
+  init_src();
+});
+
+// src/display/tool-display.ts
+import * as path2 from "node:path";
+
+class ToolDisplay {
+  formatToolStart(tool) {
+    const lines = [];
+    switch (tool.name) {
+      case "Read":
+        lines.push(...this.formatReadTool(tool));
+        break;
+      case "Write":
+        lines.push(...this.formatWriteTool(tool));
+        break;
+      case "Edit":
+        lines.push(...this.formatEditTool(tool));
+        break;
+      case "Bash":
+        lines.push(...this.formatBashTool(tool));
+        break;
+      case "Grep":
+        lines.push(...this.formatGrepTool(tool));
+        break;
+      case "Glob":
+        lines.push(...this.formatGlobTool(tool));
+        break;
+      case "WebFetch":
+        lines.push(...this.formatWebFetchTool(tool));
+        break;
+      case "Task":
+        lines.push(...this.formatTaskTool(tool));
+        break;
+      default:
+        lines.push(...this.formatGenericTool(tool));
+    }
+    return lines;
+  }
+  formatToolResult(tool, result) {
+    const lines = [];
+    if (result.success) {
+      const durationStr = result.duration ? ` (${result.duration}ms)` : "";
+      lines.push(c.green(`   ✓ Completed${durationStr}`));
+      const resultDetails = this.formatResultDetails(tool.name, result.data);
+      if (resultDetails) {
+        lines.push(c.dim(`   ${resultDetails}`));
+      }
+    } else {
+      const errorMsg = result.error ? this.truncate(result.error, 60) : "Unknown error";
+      lines.push(c.red(`   ✗ Failed: ${errorMsg}`));
+    }
+    return lines;
+  }
+  formatReadTool(tool) {
+    const params = tool.parameters;
+    const lines = [];
+    if (params?.file_path) {
+      const fileName = path2.basename(params.file_path);
+      const dirPath = this.formatPath(params.file_path);
+      lines.push(c.cyan(`\uD83D\uDCD6 Reading ${c.bold(fileName)}`));
+      lines.push(c.dim(`   ${dirPath}`));
+      if (params.offset !== undefined || params.limit !== undefined) {
+        const rangeInfo = [];
+        if (params.offset !== undefined)
+          rangeInfo.push(`offset: ${params.offset}`);
+        if (params.limit !== undefined)
+          rangeInfo.push(`limit: ${params.limit}`);
+        lines.push(c.dim(`   (${rangeInfo.join(", ")})`));
+      }
+    } else {
+      lines.push(c.cyan("\uD83D\uDCD6 Reading file"));
+    }
+    return lines;
+  }
+  formatWriteTool(tool) {
+    const params = tool.parameters;
+    const lines = [];
+    if (params?.file_path) {
+      const fileName = path2.basename(params.file_path);
+      const dirPath = this.formatPath(params.file_path);
+      const size = params.content?.length ?? 0;
+      lines.push(c.cyan(`✍️  Writing ${c.bold(fileName)}`));
+      lines.push(c.dim(`   ${dirPath} (${this.formatBytes(size)})`));
+    } else {
+      lines.push(c.cyan("✍️  Writing file"));
+    }
+    return lines;
+  }
+  formatEditTool(tool) {
+    const params = tool.parameters;
+    const lines = [];
+    if (params?.file_path) {
+      const fileName = path2.basename(params.file_path);
+      const dirPath = this.formatPath(params.file_path);
+      lines.push(c.cyan(`✏️  Editing ${c.bold(fileName)}`));
+      lines.push(c.dim(`   ${dirPath}`));
+      if (params.replace_all) {
+        lines.push(c.dim("   (replace all occurrences)"));
+      }
+    } else {
+      lines.push(c.cyan("✏️  Editing file"));
+    }
+    return lines;
+  }
+  formatBashTool(tool) {
+    const params = tool.parameters;
+    const lines = [];
+    if (params) {
+      const description = params.description || "Running command";
+      lines.push(c.cyan(`⚡ ${description}`));
+      if (params.command) {
+        const truncatedCmd = this.truncate(params.command, 80);
+        lines.push(c.dim(`   $ ${truncatedCmd}`));
+      }
+      if (params.timeout) {
+        lines.push(c.dim(`   (timeout: ${params.timeout}ms)`));
+      }
+    } else {
+      lines.push(c.cyan("⚡ Running command"));
+    }
+    return lines;
+  }
+  formatGrepTool(tool) {
+    const params = tool.parameters;
+    const lines = [];
+    if (params?.pattern) {
+      const truncatedPattern = this.truncate(params.pattern, 40);
+      lines.push(c.cyan(`\uD83D\uDD0D Searching for "${truncatedPattern}"`));
+      const searchScope = [];
       if (params.path)
         searchScope.push(`in ${this.formatPath(params.path)}`);
       if (params.glob)
@@ -42494,208 +42807,318 @@ var init_progress_renderer = __esm(() => {
   SPINNER_FRAMES = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"];
 });
 
-// src/display/execution-stats.ts
-class ExecutionStatsTracker {
-  startTime;
-  endTime = null;
-  toolTimings = new Map;
-  toolOrder = [];
-  tokensUsed = null;
-  error = null;
-  constructor() {
-    this.startTime = Date.now();
-  }
-  toolStarted(toolName, toolId) {
-    const key = toolId ?? `${toolName}-${Date.now()}`;
-    this.toolTimings.set(key, {
-      name: toolName,
-      id: toolId,
-      startTime: Date.now()
-    });
-    this.toolOrder.push(key);
+// src/settings-manager.ts
+import { existsSync as existsSync14, readFileSync as readFileSync12, unlinkSync as unlinkSync4, writeFileSync as writeFileSync6 } from "node:fs";
+import { join as join14 } from "node:path";
+function getSettingsPath(projectPath) {
+  return join14(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
+}
+
+class SettingsManager {
+  projectPath;
+  constructor(projectPath) {
+    this.projectPath = projectPath;
   }
-  toolCompleted(toolName, toolId) {
-    const key = this.findToolKey(toolName, toolId);
-    if (key) {
-      const timing = this.toolTimings.get(key);
-      if (timing) {
-        timing.endTime = Date.now();
-        timing.duration = timing.endTime - timing.startTime;
-        timing.success = true;
-      }
+  load() {
+    const settingsPath = getSettingsPath(this.projectPath);
+    if (!existsSync14(settingsPath)) {
+      return {};
     }
+    return JSON.parse(readFileSync12(settingsPath, "utf-8"));
   }
-  toolFailed(toolName, error48, toolId) {
-    const key = this.findToolKey(toolName, toolId);
-    if (key) {
-      const timing = this.toolTimings.get(key);
-      if (timing) {
-        timing.endTime = Date.now();
-        timing.duration = timing.endTime - timing.startTime;
-        timing.success = false;
-        timing.error = error48;
-      }
-    }
+  save(settings) {
+    const { $schema: _2, ...rest } = settings;
+    const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
+    const settingsPath = getSettingsPath(this.projectPath);
+    writeFileSync6(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
   }
-  setTokensUsed(tokens) {
-    this.tokensUsed = tokens;
+  get(key) {
+    return this.load()[key];
   }
-  setError(error48) {
-    this.error = error48;
+  set(key, value) {
+    const settings = this.load();
+    settings[key] = value;
+    this.save(settings);
   }
-  finalize() {
-    this.endTime = Date.now();
-    const toolsUsed = [];
-    const seenTools = new Set;
-    for (const key of this.toolOrder) {
-      const timing = this.toolTimings.get(key);
-      if (timing && !seenTools.has(timing.name)) {
-        seenTools.add(timing.name);
-        toolsUsed.push(timing.name);
-      }
-    }
-    const toolTimings = this.toolOrder.map((key) => this.toolTimings.get(key)).filter((t) => t !== undefined);
-    const stats = {
-      duration: this.endTime - this.startTime,
-      toolsUsed,
-      toolTimings,
-      success: this.error === null
-    };
-    if (this.tokensUsed !== null) {
-      stats.tokensUsed = this.tokensUsed;
-    }
-    if (this.error !== null) {
-      stats.error = this.error;
+  remove() {
+    const settingsPath = getSettingsPath(this.projectPath);
+    if (existsSync14(settingsPath)) {
+      unlinkSync4(settingsPath);
     }
-    return stats;
-  }
-  getCurrentDuration() {
-    return Date.now() - this.startTime;
   }
-  findToolKey(toolName, toolId) {
-    if (toolId && this.toolTimings.has(toolId)) {
-      return toolId;
-    }
-    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
-      const key = this.toolOrder[i];
-      const timing = this.toolTimings.get(key);
-      if (timing && timing.name === toolName && timing.endTime === undefined) {
-        return key;
-      }
-    }
-    for (let i = this.toolOrder.length - 1;i >= 0; i--) {
-      const key = this.toolOrder[i];
-      const timing = this.toolTimings.get(key);
-      if (timing && timing.name === toolName) {
-        return key;
-      }
-    }
-    return null;
+  exists() {
+    return existsSync14(getSettingsPath(this.projectPath));
   }
 }
+var init_settings_manager = __esm(() => {
+  init_index_node();
+});
 
-// src/repl/commands.ts
-function parseCommand(input) {
-  const lowerInput = input.toLowerCase();
-  for (const cmd of REPL_COMMANDS) {
-    if (lowerInput === cmd.name || cmd.aliases.includes(lowerInput)) {
-      return cmd;
-    }
+// src/commands/exec-sessions.ts
+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 null;
+  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";
 }
-function showHelp() {
-  console.log(`
-  ${c.primary("Available Commands")}
 
-  ${c.success("exit")} / ${c.dim("quit, q")}       Exit interactive mode
-  ${c.success("clear")} / ${c.dim("cls")}          Clear the screen
-  ${c.success("help")} / ${c.dim("?, h")}          Show this help message
-  ${c.success("reset")} / ${c.dim("r")}            Reset conversation context
-  ${c.success("history")} / ${c.dim("hist")}       List recent sessions
-  ${c.success("session")} / ${c.dim("sid")}        Show current session ID
-
-  ${c.dim("Any other input will be sent as a prompt to the AI.")}
+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.")}
 `);
-}
-function showHistory(session2, args) {
-  const historyManager = session2.getHistoryManager();
-  const limit = args ? parseInt(args, 10) : 10;
-  const sessions = historyManager.listSessions({
-    limit: Number.isNaN(limit) ? 10 : limit
-  });
-  if (sessions.length === 0) {
+      return;
+    }
     console.log(`
-  ${c.dim("No sessions found.")}
-`);
-    return;
-  }
-  console.log(`
-  ${c.primary("Recent Sessions")}
+  ${c.primary("Recent Exec Sessions:")}
 `);
-  for (const sess of sessions) {
-    const date5 = new Date(sess.updatedAt);
-    const dateStr = date5.toLocaleDateString();
-    const timeStr = date5.toLocaleTimeString();
-    const msgCount = sess.messages.length;
-    const isCurrent = sess.id === session2.getSessionId();
-    const marker = isCurrent ? c.success("*") : " ";
-    console.log(`  ${marker} ${c.cyan(sess.id)} ${c.dim(`- ${dateStr} ${timeStr} (${msgCount} messages)`)}`);
-    if (sess.messages.length > 0) {
-      const lastMsg = sess.messages[sess.messages.length - 1];
-      const preview = lastMsg.content.slice(0, 60).replace(/\n/g, " ");
-      console.log(`      ${c.dim(preview + (lastMsg.content.length > 60 ? "..." : ""))}`);
+    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.dim("Use --session <id> to resume a session")}
+  async show(sessionId) {
+    if (!sessionId) {
+      console.error(`
+  ${c.error("Error:")} Session ID is required
 `);
-}
-var REPL_COMMANDS;
-var init_commands = __esm(() => {
-  init_index_node();
-  REPL_COMMANDS = [
-    {
-      name: "exit",
-      aliases: ["quit", "q"],
-      description: "Exit interactive mode",
-      execute: (session2) => session2.shutdown()
-    },
-    {
-      name: "clear",
-      aliases: ["cls"],
-      description: "Clear the screen",
-      execute: () => console.clear()
-    },
-    {
-      name: "help",
-      aliases: ["?", "h"],
-      description: "Show available commands",
-      execute: () => showHelp()
-    },
-    {
-      name: "reset",
-      aliases: ["r"],
-      description: "Reset conversation context",
-      execute: (session2) => session2.resetContext()
-    },
-    {
-      name: "history",
-      aliases: ["hist"],
-      description: "List recent sessions",
-      execute: (session2, args) => showHistory(session2, args)
-    },
-    {
-      name: "session",
-      aliases: ["sid"],
-      description: "Show current session ID",
-      execute: (session2) => {
-        console.log(`
-  ${c.dim("Session ID:")} ${c.cyan(session2.getSessionId())}
+      console.log(`  ${c.dim("Usage: locus exec sessions show <session-id>")}
 `);
-      }
+      return;
     }
-  ];
+    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.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;
+    }
+    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
+`);
+    }
+  }
+  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"}
+`);
+  }
+  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).")}
+`);
+}
+var init_exec_sessions = __esm(() => {
+  init_index_node();
+});
+
+// src/repl/commands.ts
+function parseCommand(input) {
+  const lowerInput = input.toLowerCase();
+  for (const cmd of REPL_COMMANDS) {
+    if (lowerInput === cmd.name || cmd.aliases.includes(lowerInput)) {
+      return cmd;
+    }
+  }
+  return null;
+}
+function showHelp() {
+  console.log(`
+  ${c.primary("Available Commands")}
+
+  ${c.success("exit")} / ${c.dim("quit, q")}       Exit interactive mode
+  ${c.success("clear")} / ${c.dim("cls")}          Clear the screen
+  ${c.success("help")} / ${c.dim("?, h")}          Show this help message
+  ${c.success("reset")} / ${c.dim("r")}            Reset conversation context
+  ${c.success("history")} / ${c.dim("hist")}       List recent sessions
+  ${c.success("session")} / ${c.dim("sid")}        Show current session ID
+
+  ${c.dim("Any other input will be sent as a prompt to the AI.")}
+`);
+}
+function showHistory(session2, args) {
+  const historyManager = session2.getHistoryManager();
+  const limit = args ? parseInt(args, 10) : 10;
+  const sessions = historyManager.listSessions({
+    limit: Number.isNaN(limit) ? 10 : limit
+  });
+  if (sessions.length === 0) {
+    console.log(`
+  ${c.dim("No sessions found.")}
+`);
+    return;
+  }
+  console.log(`
+  ${c.primary("Recent Sessions")}
+`);
+  for (const sess of sessions) {
+    const date5 = new Date(sess.updatedAt);
+    const dateStr = date5.toLocaleDateString();
+    const timeStr = date5.toLocaleTimeString();
+    const msgCount = sess.messages.length;
+    const isCurrent = sess.id === session2.getSessionId();
+    const marker = isCurrent ? c.success("*") : " ";
+    console.log(`  ${marker} ${c.cyan(sess.id)} ${c.dim(`- ${dateStr} ${timeStr} (${msgCount} messages)`)}`);
+    if (sess.messages.length > 0) {
+      const lastMsg = sess.messages[sess.messages.length - 1];
+      const preview = lastMsg.content.slice(0, 60).replace(/\n/g, " ");
+      console.log(`      ${c.dim(preview + (lastMsg.content.length > 60 ? "..." : ""))}`);
+    }
+  }
+  console.log(`
+  ${c.dim("Use --session <id> to resume a session")}
+`);
+}
+var REPL_COMMANDS;
+var init_commands = __esm(() => {
+  init_index_node();
+  REPL_COMMANDS = [
+    {
+      name: "exit",
+      aliases: ["quit", "q"],
+      description: "Exit interactive mode",
+      execute: (session2) => session2.shutdown()
+    },
+    {
+      name: "clear",
+      aliases: ["cls"],
+      description: "Clear the screen",
+      execute: () => console.clear()
+    },
+    {
+      name: "help",
+      aliases: ["?", "h"],
+      description: "Show available commands",
+      execute: () => showHelp()
+    },
+    {
+      name: "reset",
+      aliases: ["r"],
+      description: "Reset conversation context",
+      execute: (session2) => session2.resetContext()
+    },
+    {
+      name: "history",
+      aliases: ["hist"],
+      description: "List recent sessions",
+      execute: (session2, args) => showHistory(session2, args)
+    },
+    {
+      name: "session",
+      aliases: ["sid"],
+      description: "Show current session ID",
+      execute: (session2) => {
+        console.log(`
+  ${c.dim("Session ID:")} ${c.cyan(session2.getSessionId())}
+`);
+      }
+    }
+  ];
 });
 
 // src/repl/interactive-session.ts
@@ -42703,7 +43126,7 @@ var exports_interactive_session = {};
 __export(exports_interactive_session, {
   InteractiveSession: () => InteractiveSession
 });
-import * as readline2 from "node:readline";
+import * as readline from "node:readline";
 
 class InteractiveSession {
   readline = null;
@@ -42749,7 +43172,7 @@ class InteractiveSession {
   }
   async start() {
     this.printWelcome();
-    this.readline = readline2.createInterface({
+    this.readline = readline.createInterface({
       input: process.stdin,
       output: process.stdout,
       terminal: true
@@ -42937,1700 +43360,1519 @@ var init_interactive_session = __esm(() => {
   init_commands();
 });
 
-// src/cli.ts
-init_index_node();
-
-// src/commands/config.ts
-init_index_node();
-import { createInterface } from "node:readline";
-
-// src/settings-manager.ts
-init_index_node();
-import { existsSync as existsSync12, readFileSync as readFileSync11, unlinkSync as unlinkSync4, writeFileSync as writeFileSync6 } from "node:fs";
-import { join as join12 } from "node:path";
-function getSettingsPath(projectPath) {
-  return join12(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
-}
-
-class SettingsManager {
-  projectPath;
-  constructor(projectPath) {
-    this.projectPath = projectPath;
-  }
-  load() {
-    const settingsPath = getSettingsPath(this.projectPath);
-    if (!existsSync12(settingsPath)) {
-      return {};
-    }
-    return JSON.parse(readFileSync11(settingsPath, "utf-8"));
+// src/commands/exec.ts
+var exports_exec = {};
+__export(exports_exec, {
+  execCommand: () => execCommand
+});
+import { randomUUID as randomUUID2 } from "node:crypto";
+import { parseArgs } from "node:util";
+async function execCommand(args) {
+  const { values, positionals } = parseArgs({
+    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;
   }
-  save(settings) {
-    const { $schema: _2, ...rest } = settings;
-    const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
-    const settingsPath = getSettingsPath(this.projectPath);
-    writeFileSync6(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
-  }
-  get(key) {
-    return this.load()[key];
-  }
-  set(key, value) {
-    const settings = this.load();
-    settings[key] = value;
-    this.save(settings);
-  }
-  remove() {
-    const settingsPath = getSettingsPath(this.projectPath);
-    if (existsSync12(settingsPath)) {
-      unlinkSync4(settingsPath);
-    }
-  }
-  exists() {
-    return existsSync12(getSettingsPath(this.projectPath));
-  }
-}
-
-// src/commands/config.ts
-function ask(question) {
-  const rl = createInterface({
-    input: process.stdin,
-    output: process.stdout
-  });
-  return new Promise((resolve2) => {
-    rl.question(question, (answer) => {
-      rl.close();
-      resolve2(answer.trim());
-    });
-  });
-}
-var TOP_LEVEL_KEYS = [
-  "apiKey",
-  "apiUrl",
-  "provider",
-  "model",
-  "workspaceId"
-];
-var TELEGRAM_KEYS = [
-  "telegram.botToken",
-  "telegram.chatId",
-  "telegram.testMode"
-];
-var ALL_KEYS = [...TOP_LEVEL_KEYS, ...TELEGRAM_KEYS];
-function maskSecret(value) {
-  if (value.length <= 8)
-    return "****";
-  return `${value.slice(0, 4)}...${value.slice(-4)}`;
-}
-function showConfigHelp() {
-  console.log(`
-  ${c.header(" CONFIG ")}
-    ${c.primary("locus config")} ${c.dim("<subcommand> [options]")}
-
-  ${c.header(" SUBCOMMANDS ")}
-    ${c.success("setup")}     Interactive configuration (or pass flags below)
-              ${c.dim("--api-key <KEY>   Locus API key (required)")}
-              ${c.dim("--api-url <URL>   API base URL (optional)")}
-              ${c.dim("--provider <P>    AI provider (optional)")}
-              ${c.dim("--model <M>       AI model (optional)")}
-    ${c.success("show")}      Show current settings
-    ${c.success("set")}       Set a config value
-              ${c.dim("locus config set <key> <value>")}
-              ${c.dim(`Keys: ${ALL_KEYS.join(", ")}`)}
-    ${c.success("remove")}    Remove all settings
-
-  ${c.header(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus config setup")}
-    ${c.dim("$")} ${c.primary("locus config setup --api-key sk-xxx")}
-    ${c.dim("$")} ${c.primary("locus config show")}
-    ${c.dim("$")} ${c.primary("locus config set apiKey sk-new-key")}
-    ${c.dim("$")} ${c.primary("locus config set provider codex")}
-    ${c.dim("$")} ${c.primary("locus config set telegram.botToken 123:ABC")}
-    ${c.dim("$")} ${c.primary("locus config remove")}
-`);
-}
-async function setupCommand(args, projectPath) {
-  let apiKey;
-  let apiUrl;
-  let provider;
-  let model;
-  for (let i = 0;i < args.length; i++) {
-    if (args[i] === "--api-key" && args[i + 1]) {
-      apiKey = args[++i]?.trim();
-    } else if (args[i] === "--api-url" && args[i + 1]) {
-      apiUrl = args[++i]?.trim();
-    } else if (args[i] === "--provider" && args[i + 1]) {
-      provider = args[++i]?.trim();
-    } else if (args[i] === "--model" && args[i + 1]) {
-      model = args[++i]?.trim();
-    }
-  }
-  if (!apiKey && !apiUrl && !provider && !model) {
-    console.log(`
-  ${c.header(" LOCUS SETUP ")}
-`);
-    console.log(`  ${c.dim("Configure your Locus settings. Press Enter to skip optional fields.")}
-`);
-    while (!apiKey) {
-      apiKey = await ask(`  ${c.primary("API Key")} ${c.dim("(required)")}: `);
-      if (!apiKey) {
-        console.log(`  ${c.error("✖")} API key is required. Get one from ${c.underline("Workspace Settings > API Keys")}`);
-      }
-    }
-    provider = await ask(`  ${c.primary("Provider")} ${c.dim("(optional, e.g. claude, codex)")}: `);
-    model = await ask(`  ${c.primary("Model")} ${c.dim("(optional, e.g. opus, sonnet)")}: `);
-    if (!provider)
-      provider = undefined;
-    if (!model)
-      model = undefined;
-  }
-  if (!apiKey) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("Missing --api-key flag.")}
-` + `  Get an API key from ${c.underline("Workspace Settings > API Keys")}
-`);
-    process.exit(1);
-  }
-  const manager = new SettingsManager(projectPath);
-  const existing = manager.load();
-  const settings = {
-    ...existing,
-    apiKey
-  };
-  if (apiUrl)
-    settings.apiUrl = apiUrl;
-  if (provider)
-    settings.provider = provider;
-  if (model)
-    settings.model = model;
-  manager.save(settings);
-  console.log(`
-  ${c.success("✔")} ${c.bold("Settings configured successfully!")}
-
-  ${c.bold("Saved to:")} ${c.dim(".locus/settings.json")}
-
-  ${c.bold("Configuration:")}
-    ${c.primary("API Key:")}   ${maskSecret(apiKey)}${apiUrl ? `
-    ${c.primary("API URL:")}   ${apiUrl}` : ""}${provider ? `
-    ${c.primary("Provider:")}  ${provider}` : ""}${model ? `
-    ${c.primary("Model:")}     ${model}` : ""}
-
-  ${c.bold("Next steps:")}
-    Run agents:  ${c.primary("locus run")}
-    Setup Telegram: ${c.primary("locus telegram setup")}
-`);
-}
-function showCommand(projectPath) {
-  const manager = new SettingsManager(projectPath);
-  const settings = manager.load();
-  if (Object.keys(settings).length === 0) {
-    console.log(`
-  ${c.dim("No settings found.")}
-` + `  Run ${c.primary("locus config setup")} to configure.
-`);
-    return;
-  }
-  console.log(`
-  ${c.header(" SETTINGS ")}`);
-  console.log(`  ${c.dim("File: .locus/settings.json")}
-`);
-  if (settings.apiKey) {
-    console.log(`    ${c.primary("apiKey:")}       ${maskSecret(settings.apiKey)}`);
-  }
-  if (settings.apiUrl) {
-    console.log(`    ${c.primary("apiUrl:")}       ${settings.apiUrl}`);
-  }
-  if (settings.provider) {
-    console.log(`    ${c.primary("provider:")}     ${settings.provider}`);
-  }
-  if (settings.model) {
-    console.log(`    ${c.primary("model:")}        ${settings.model}`);
-  }
-  if (settings.workspaceId) {
-    console.log(`    ${c.primary("workspaceId:")}  ${settings.workspaceId}`);
-  }
-  if (settings.telegram) {
-    const tg = settings.telegram;
-    console.log(`
-    ${c.header(" TELEGRAM ")}`);
-    if (tg.botToken) {
-      console.log(`    ${c.primary("botToken:")}     ${maskSecret(tg.botToken)}`);
-    }
-    if (tg.chatId) {
-      console.log(`    ${c.primary("chatId:")}       ${tg.chatId}`);
-    }
-    if (tg.testMode !== undefined) {
-      console.log(`    ${c.primary("testMode:")}     ${tg.testMode}`);
-    }
-  }
-  console.log("");
-}
-function setCommand(args, projectPath) {
-  const key = args[0]?.trim();
-  const value = args.slice(1).join(" ").trim();
-  if (!key || !value) {
-    console.error(`
-  ${c.error("✖")} ${c.bold("Usage:")} locus config set <key> <value>
-` + `  ${c.dim(`Available keys: ${ALL_KEYS.join(", ")}`)}
-`);
-    process.exit(1);
-  }
-  if (!ALL_KEYS.includes(key)) {
-    console.error(`
-  ${c.error("✖")} ${c.bold(`Unknown key: ${key}`)}
-` + `  ${c.dim(`Available keys: ${ALL_KEYS.join(", ")}`)}
-`);
-    process.exit(1);
-  }
-  const manager = new SettingsManager(projectPath);
-  const settings = manager.load();
-  if (key.startsWith("telegram.")) {
-    const telegramKey = key.replace("telegram.", "");
-    if (!settings.telegram) {
-      settings.telegram = {};
-    }
-    if (telegramKey === "chatId") {
-      const num = Number(value);
-      if (Number.isNaN(num)) {
-        console.error(`
-  ${c.error("✖")} ${c.bold(`${key} must be a number.`)}
-`);
-        process.exit(1);
-      }
-      settings.telegram[telegramKey] = num;
-    } else if (telegramKey === "testMode") {
-      settings.telegram[telegramKey] = value === "true" || value === "1";
-    } else {
-      settings.telegram[telegramKey] = value;
-    }
-  } else {
-    settings[key] = value;
-  }
-  manager.save(settings);
-  const displayValue = key === "apiKey" || key === "telegram.botToken" ? maskSecret(value) : value;
-  console.log(`
-  ${c.success("✔")} Set ${c.primary(key)} = ${displayValue}
-`);
-}
-function removeCommand(projectPath) {
-  const manager = new SettingsManager(projectPath);
-  if (!manager.exists()) {
-    console.log(`
-  ${c.dim("No settings found. Nothing to remove.")}
-`);
-    return;
-  }
-  manager.remove();
-  console.log(`
-  ${c.success("✔")} ${c.bold("Settings removed.")}
-`);
-}
-async function configCommand(args) {
-  const projectPath = process.cwd();
-  const subcommand = args[0];
-  const subArgs = args.slice(1);
-  switch (subcommand) {
-    case "setup":
-      await setupCommand(subArgs, projectPath);
-      break;
-    case "show":
-      showCommand(projectPath);
-      break;
-    case "set":
-      setCommand(subArgs, projectPath);
-      break;
-    case "remove":
-      removeCommand(projectPath);
-      break;
-    default:
-      showConfigHelp();
-  }
-}
-// src/commands/discuss.ts
-init_index_node();
-init_progress_renderer();
-import * as readline from "node:readline";
-import { parseArgs } from "node:util";
-
-// src/utils/banner.ts
-init_index_node();
-
-// src/utils/version.ts
-import { existsSync as existsSync13, readFileSync as readFileSync12 } from "node:fs";
-import { dirname as dirname3, join as join13 } from "node:path";
-import { fileURLToPath as fileURLToPath3 } from "node:url";
-function getVersion() {
-  try {
-    const __filename2 = fileURLToPath3(import.meta.url);
-    const __dirname2 = dirname3(__filename2);
-    const bundledPath = join13(__dirname2, "..", "package.json");
-    const sourcePath = join13(__dirname2, "..", "..", "package.json");
-    if (existsSync13(bundledPath)) {
-      const pkg = JSON.parse(readFileSync12(bundledPath, "utf-8"));
-      if (pkg.name === "@locusai/cli") {
-        return pkg.version || "0.0.0";
-      }
-    }
-    if (existsSync13(sourcePath)) {
-      const pkg = JSON.parse(readFileSync12(sourcePath, "utf-8"));
-      if (pkg.name === "@locusai/cli") {
-        return pkg.version || "0.0.0";
-      }
+  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;
     }
-  } catch {}
-  return "0.0.0";
-}
-var VERSION2 = getVersion();
-
-// src/utils/banner.ts
-function printBanner() {
-  console.log(c.primary(`
- _      ____   ____ _   _  ____
-| |    / __ \\ / ___| | | |/ ___|
-| |   | |  | | |   | | | |\\___ \\
-| |___| |__| | |___| |_| |___) |
-|_____|\\____/ \\____|\\___/|____/  ${c.dim(`v${VERSION2}`)}
-    `));
-}
-// src/utils/helpers.ts
-init_index_node();
-import { existsSync as existsSync14 } from "node:fs";
-import { join as join14 } from "node:path";
-function isProjectInitialized(projectPath) {
-  const locusDir = join14(projectPath, LOCUS_CONFIG.dir);
-  const configPath = join14(locusDir, LOCUS_CONFIG.configFile);
-  return existsSync14(locusDir) && existsSync14(configPath);
-}
-function requireInitialization(projectPath, command) {
-  if (!isProjectInitialized(projectPath)) {
-    console.error(`
-  ${c.error("✖ Error")} ${c.red(`Locus is not initialized in this directory.`)}
-
-  The '${c.bold(command)}' command requires a Locus project to be initialized.
-
-  To initialize Locus in this directory, run:
-    ${c.primary("locus init")}
-
-  This will create a ${c.dim(".locus")} directory with the necessary configuration.
-`);
-    process.exit(1);
-  }
-}
-function resolveProvider3(input) {
-  if (!input)
-    return PROVIDER.CLAUDE;
-  if (input === PROVIDER.CLAUDE || input === PROVIDER.CODEX)
-    return input;
-  console.error(c.error(`Error: invalid provider '${input}'. Use 'claude' or 'codex'.`));
-  process.exit(1);
-}
-// src/commands/discuss.ts
-async function discussCommand(args) {
-  const { values, positionals } = parseArgs({
-    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
-  });
-  const projectPath = values.dir || process.cwd();
-  requireInitialization(projectPath, "discuss");
-  const discussionManager = new DiscussionManager(projectPath);
-  if (values.list) {
-    return listDiscussions(discussionManager);
-  }
-  if (values.show) {
-    return showDiscussion(discussionManager, values.show);
-  }
-  if (values.archive) {
-    return archiveDiscussion(discussionManager, values.archive);
-  }
-  if (values.delete) {
-    return deleteDiscussion(discussionManager, values.delete);
   }
-  const topic = positionals.join(" ").trim();
-  if (!topic) {
-    showDiscussHelp();
+  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;
   }
-  const settings = new SettingsManager(projectPath).load();
-  const provider = resolveProvider3(values.provider || settings.provider);
-  const model = values.model || settings.model || DEFAULT_MODEL[provider];
+  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 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
-  });
-  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({ animated: true });
-  let discussionId;
+  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 {
-    renderer.showThinkingStarted();
-    const result = await facilitator.startDiscussion(topic);
-    renderer.showThinkingStopped();
-    discussionId = result.discussion.id;
-    process.stdout.write(`
+    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.stdout.write(result.message);
-    process.stdout.write(`
-
+            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!")}
 `);
-    renderer.finalize();
   } catch (error48) {
-    renderer.finalize();
     console.error(`
-  ${c.error("✖")} ${c.red("Failed to start discussion:")} ${error48 instanceof Error ? error48.message : String(error48)}
+  ${c.error("✖")} ${c.error("Execution failed:")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
 `);
     process.exit(1);
   }
-  console.log(`  ${c.dim("Type your response, or 'help' for commands. Use 'exit' or Ctrl+C to quit.")}
-`);
-  const rl = readline.createInterface({
-    input: process.stdin,
-    output: process.stdout,
-    terminal: true
+}
+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
   });
-  rl.setPrompt(c.cyan("> "));
-  rl.prompt();
-  let isProcessing = false;
-  const shutdown = () => {
-    if (isProcessing) {
-      aiRunner.abort();
+  const handleSignal = () => {
+    if (renderer.isDone()) {
+      return;
     }
-    console.log(`
-  ${c.dim("Discussion saved.")} ${c.dim("ID:")} ${c.cyan(discussionId)}`);
-    console.log(c.dim(`
-  Goodbye!
-`));
-    rl.close();
-    process.exit(0);
-  };
-  process.on("SIGINT", () => {
-    if (isProcessing) {
-      aiRunner.abort();
-      isProcessing = false;
-      console.log(c.dim(`
-[Interrupted]`));
-      rl.prompt();
+    renderer.emitFatalError("PROCESS_CRASHED", "Process terminated by signal");
+    if (process.stdout.writableNeedDrain) {
+      process.stdout.once("drain", () => process.exit(1));
     } else {
-      shutdown();
+      process.exit(1);
     }
-  });
-  rl.on("close", () => {
-    shutdown();
-  });
-  rl.on("line", async (input) => {
-    const trimmed = input.trim();
-    if (trimmed === "" || isProcessing) {
-      rl.prompt();
-      return;
+  };
+  process.on("SIGINT", handleSignal);
+  process.on("SIGTERM", handleSignal);
+  try {
+    try {
+      requireInitialization(projectPath, "exec");
+    } catch (initError) {
+      renderer.emitFatalError("CLI_NOT_FOUND", initError instanceof Error ? initError.message : String(initError));
+      process.exit(1);
     }
-    const lowerInput = trimmed.toLowerCase();
-    if (lowerInput === "help") {
-      showReplHelp();
-      rl.prompt();
-      return;
+    const promptInput = positionals.join(" ");
+    if (!promptInput) {
+      renderer.emitFatalError("UNKNOWN", 'Prompt is required. Usage: locus exec --json-stream "your prompt"');
+      process.exit(1);
     }
-    if (lowerInput === "exit" || lowerInput === "quit") {
-      shutdown();
-      return;
+    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);
     }
-    if (lowerInput === "insights") {
-      showCurrentInsights(discussionManager, discussionId);
-      rl.prompt();
-      return;
+    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);
     }
-    if (lowerInput === "summary") {
-      isProcessing = true;
-      const summaryRenderer = new ProgressRenderer({ animated: true });
-      try {
-        summaryRenderer.showThinkingStarted();
-        const summary = await facilitator.summarizeDiscussion(discussionId);
-        summaryRenderer.showThinkingStopped();
-        process.stdout.write(`
-`);
-        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}
+    process.exit(1);
+  }
+}
+var init_exec2 = __esm(() => {
+  init_index_node();
+  init_json_stream_renderer();
+  init_progress_renderer();
+  init_settings_manager();
+  init_utils3();
+  init_exec_sessions();
+});
+
+// src/cli.ts
+init_index_node();
+
+// src/commands/artifacts.ts
+init_index_node();
+init_utils3();
+import { existsSync as existsSync15, readdirSync as readdirSync5, readFileSync as readFileSync13, statSync } from "node:fs";
+import { join as join15 } from "node:path";
+import { parseArgs as parseArgs2 } from "node:util";
+function listArtifacts(projectPath) {
+  const artifactsDir = getLocusPath(projectPath, "artifactsDir");
+  if (!existsSync15(artifactsDir)) {
+    return [];
+  }
+  const files = readdirSync5(artifactsDir).filter((f) => f.endsWith(".md"));
+  return files.map((fileName) => {
+    const filePath = join15(artifactsDir, fileName);
+    const stat = statSync(filePath);
+    const name = fileName.replace(/\.md$/, "");
+    return {
+      name,
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    };
+  }).sort((a, b) => b.createdAt.getTime() - a.createdAt.getTime());
+}
+function readArtifact(projectPath, name) {
+  const artifactsDir = getLocusPath(projectPath, "artifactsDir");
+  const fileName = name.endsWith(".md") ? name : `${name}.md`;
+  const filePath = join15(artifactsDir, fileName);
+  if (!existsSync15(filePath)) {
+    return null;
+  }
+  const stat = statSync(filePath);
+  const content = readFileSync13(filePath, "utf-8");
+  return {
+    content,
+    info: {
+      name: fileName.replace(/\.md$/, ""),
+      fileName,
+      createdAt: stat.birthtime,
+      size: stat.size
+    }
+  };
+}
+function formatSize(bytes) {
+  if (bytes < 1024)
+    return `${bytes}B`;
+  const kb = bytes / 1024;
+  if (kb < 1024)
+    return `${kb.toFixed(1)}KB`;
+  const mb = kb / 1024;
+  return `${mb.toFixed(1)}MB`;
+}
+function formatDate(date5) {
+  return date5.toLocaleDateString("en-US", {
+    year: "numeric",
+    month: "short",
+    day: "numeric",
+    hour: "2-digit",
+    minute: "2-digit"
+  });
+}
+async function artifactsCommand(args) {
+  const { positionals } = parseArgs2({
+    args,
+    options: {
+      dir: { type: "string" }
+    },
+    strict: false,
+    allowPositionals: true
+  });
+  const projectPath = process.cwd();
+  requireInitialization(projectPath, "artifacts");
+  const subcommand = positionals[0];
+  switch (subcommand) {
+    case "show":
+    case "view": {
+      const name = positionals.slice(1).join(" ");
+      if (!name) {
+        console.error(`
+  ${c.error("Error:")} Artifact name is required
 `);
-        }
-        console.log(`  ${c.dim("To review:")} ${c.cyan(`locus discuss --show ${discussionId}`)}`);
-        console.log(`  ${c.dim("To list all:")} ${c.cyan("locus discuss --list")}
+        console.log(`  ${c.dim("Usage: locus artifacts show <name>")}
 `);
-      } catch (error48) {
-        summaryRenderer.finalize();
+        return;
+      }
+      await showArtifact(projectPath, name);
+      break;
+    }
+    case "plan": {
+      const name = positionals.slice(1).join(" ");
+      if (!name) {
         console.error(`
-  ${c.error("✖")} ${c.red("Failed to summarize:")} ${error48 instanceof Error ? error48.message : String(error48)}
+  ${c.error("Error:")} Artifact name is required
+`);
+        console.log(`  ${c.dim("Usage: locus artifacts plan <name>")}
 `);
+        return;
       }
-      rl.close();
-      process.exit(0);
-      return;
+      await convertToPlan(projectPath, name);
+      break;
     }
-    isProcessing = true;
-    const chunkRenderer = new ProgressRenderer({ animated: true });
-    try {
-      chunkRenderer.showThinkingStarted();
-      const stream4 = facilitator.continueDiscussionStream(discussionId, trimmed);
-      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)}
+    default:
+      await listArtifactsCommand(projectPath);
+      break;
+  }
+}
+async function listArtifactsCommand(projectPath) {
+  const artifacts = listArtifacts(projectPath);
+  if (artifacts.length === 0) {
+    console.log(`
+  ${c.dim("No artifacts found.")}
 `);
-        }
+    return;
+  }
+  console.log(`
+  ${c.primary("Artifacts")} ${c.dim(`(${artifacts.length} total)`)}
+`);
+  for (let i = 0;i < artifacts.length; i++) {
+    const artifact = artifacts[i];
+    const index = c.dim(`${String(i + 1).padStart(2)}.`);
+    const date5 = formatDate(artifact.createdAt);
+    const size = formatSize(artifact.size);
+    console.log(`  ${index} ${c.cyan(artifact.name)}`);
+    console.log(`      ${c.dim(`${date5} • ${size}`)}`);
+  }
+  console.log(`
+  ${c.dim("Use")} ${c.primary("locus artifacts show <name>")} ${c.dim("to view content")}`);
+  console.log(`  ${c.dim("Use")} ${c.primary("locus artifacts plan <name>")} ${c.dim("to convert to a plan")}
+`);
+}
+async function showArtifact(projectPath, name) {
+  const result = readArtifact(projectPath, name);
+  if (!result) {
+    const artifacts = listArtifacts(projectPath);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+      const match = readArtifact(projectPath, matches[0].name);
+      if (match) {
+        printArtifact(match.info, match.content);
+        return;
       }
-    } catch (error48) {
-      chunkRenderer.finalize();
+    }
+    if (matches.length > 1) {
       console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+  ${c.error("Error:")} Multiple artifacts match "${name}":
 `);
+      for (const m of matches) {
+        console.log(`    ${c.cyan(m.name)}`);
+      }
+      console.log();
+      return;
     }
-    isProcessing = false;
-    rl.prompt();
-  });
-}
-function listDiscussions(discussionManager) {
-  const discussions = discussionManager.list();
-  if (discussions.length === 0) {
-    console.log(`
-  ${c.dim("No discussions found.")}
+    console.error(`
+  ${c.error("Error:")} Artifact "${name}" not found
 `);
-    console.log(`  ${c.dim("Start one with:")} ${c.cyan('locus discuss "your topic"')}
+    console.log(`  ${c.dim("Use 'locus artifacts' to see available artifacts")}
 `);
     return;
   }
+  printArtifact(result.info, result.content);
+}
+function printArtifact(info, content) {
+  const date5 = formatDate(info.createdAt);
+  const size = formatSize(info.size);
   console.log(`
-  ${c.header(" DISCUSSIONS ")} ${c.dim(`(${discussions.length})`)}
+  ${c.primary(info.name)}`);
+  console.log(`  ${c.dim(`${date5} • ${size}`)}`);
+  console.log(c.dim("  ─".repeat(30)));
+  console.log();
+  console.log(content);
+}
+async function convertToPlan(projectPath, name) {
+  const result = readArtifact(projectPath, name);
+  if (!result) {
+    const artifacts = listArtifacts(projectPath);
+    const matches = artifacts.filter((a) => a.name.toLowerCase().includes(name.toLowerCase()));
+    if (matches.length === 1) {
+      const match = readArtifact(projectPath, matches[0].name);
+      if (match) {
+        await runPlanConversion(match.info.name);
+        return;
+      }
+    }
+    console.error(`
+  ${c.error("Error:")} Artifact "${name}" not found
 `);
-  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("");
+    console.log(`  ${c.dim("Use 'locus artifacts' to see available artifacts")}
+`);
+    return;
   }
+  await runPlanConversion(result.info.name);
 }
-function showDiscussion(discussionManager, id) {
-  const md = discussionManager.getMarkdown(id);
-  if (!md) {
-    console.error(`
-  ${c.error("✖")} ${c.red(`Discussion not found: ${id}`)}
+async function runPlanConversion(artifactName) {
+  const { execCommand: execCommand2 } = await Promise.resolve().then(() => (init_exec2(), exports_exec));
+  console.log(`
+  ${c.primary("Converting artifact to plan:")} ${c.cyan(artifactName)}
 `);
-    process.exit(1);
+  const prompt = `Create a plan according to ${artifactName}`;
+  await execCommand2([prompt]);
+}
+// src/commands/config.ts
+init_index_node();
+init_settings_manager();
+import { createInterface as createInterface2 } from "node:readline";
+function ask(question) {
+  const rl = createInterface2({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve2) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve2(answer.trim());
+    });
+  });
+}
+var TOP_LEVEL_KEYS = [
+  "apiKey",
+  "apiUrl",
+  "provider",
+  "model",
+  "workspaceId"
+];
+var TELEGRAM_KEYS = [
+  "telegram.botToken",
+  "telegram.chatId",
+  "telegram.testMode"
+];
+var ALL_KEYS = [...TOP_LEVEL_KEYS, ...TELEGRAM_KEYS];
+function maskSecret(value) {
+  if (value.length <= 8)
+    return "****";
+  return `${value.slice(0, 4)}...${value.slice(-4)}`;
+}
+function showConfigHelp() {
+  console.log(`
+  ${c.header(" CONFIG ")}
+    ${c.primary("locus config")} ${c.dim("<subcommand> [options]")}
+
+  ${c.header(" SUBCOMMANDS ")}
+    ${c.success("setup")}     Interactive configuration (or pass flags below)
+              ${c.dim("--api-key <KEY>   Locus API key (required)")}
+              ${c.dim("--api-url <URL>   API base URL (optional)")}
+              ${c.dim("--provider <P>    AI provider (optional)")}
+              ${c.dim("--model <M>       AI model (optional)")}
+    ${c.success("show")}      Show current settings
+    ${c.success("set")}       Set a config value
+              ${c.dim("locus config set <key> <value>")}
+              ${c.dim(`Keys: ${ALL_KEYS.join(", ")}`)}
+    ${c.success("remove")}    Remove all settings
+
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus config setup")}
+    ${c.dim("$")} ${c.primary("locus config setup --api-key sk-xxx")}
+    ${c.dim("$")} ${c.primary("locus config show")}
+    ${c.dim("$")} ${c.primary("locus config set apiKey sk-new-key")}
+    ${c.dim("$")} ${c.primary("locus config set provider codex")}
+    ${c.dim("$")} ${c.primary("locus config set telegram.botToken 123:ABC")}
+    ${c.dim("$")} ${c.primary("locus config remove")}
+`);
+}
+async function setupCommand(args, projectPath) {
+  let apiKey;
+  let apiUrl;
+  let provider;
+  let model;
+  for (let i = 0;i < args.length; i++) {
+    if (args[i] === "--api-key" && args[i + 1]) {
+      apiKey = args[++i]?.trim();
+    } else if (args[i] === "--api-url" && args[i + 1]) {
+      apiUrl = args[++i]?.trim();
+    } else if (args[i] === "--provider" && args[i + 1]) {
+      provider = args[++i]?.trim();
+    } else if (args[i] === "--model" && args[i + 1]) {
+      model = args[++i]?.trim();
+    }
   }
-  console.log(`
-${md}
-`);
-}
-function archiveDiscussion(discussionManager, id) {
-  try {
-    discussionManager.archive(id);
+  if (!apiKey && !apiUrl && !provider && !model) {
     console.log(`
-  ${c.success("✔")} ${c.dim("Discussion archived.")}
+  ${c.header(" LOCUS SETUP ")}
 `);
-  } catch (error48) {
-    console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+    console.log(`  ${c.dim("Configure your Locus settings. Press Enter to skip optional fields.")}
 `);
-    process.exit(1);
+    while (!apiKey) {
+      apiKey = await ask(`  ${c.primary("API Key")} ${c.dim("(required)")}: `);
+      if (!apiKey) {
+        console.log(`  ${c.error("✖")} API key is required. Get one from ${c.underline("Workspace Settings > API Keys")}`);
+      }
+    }
+    provider = await ask(`  ${c.primary("Provider")} ${c.dim("(optional, e.g. claude, codex)")}: `);
+    model = await ask(`  ${c.primary("Model")} ${c.dim("(optional, e.g. opus, sonnet)")}: `);
+    if (!provider)
+      provider = undefined;
+    if (!model)
+      model = undefined;
   }
-}
-function deleteDiscussion(discussionManager, id) {
-  try {
-    discussionManager.delete(id);
-    console.log(`
-  ${c.success("✔")} ${c.dim("Discussion deleted.")}
-`);
-  } catch (error48) {
+  if (!apiKey) {
     console.error(`
-  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+  ${c.error("✖")} ${c.bold("Missing --api-key flag.")}
+` + `  Get an API key from ${c.underline("Workspace Settings > API Keys")}
 `);
     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.")}
-`);
-    return;
-  }
-  console.log(`
-  ${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.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.dim("Type anything else to continue the discussion.")}
-`);
-}
-function showDiscussHelp() {
+  const manager = new SettingsManager(projectPath);
+  const existing = manager.load();
+  const settings = {
+    ...existing,
+    apiKey
+  };
+  if (apiUrl)
+    settings.apiUrl = apiUrl;
+  if (provider)
+    settings.provider = provider;
+  if (model)
+    settings.model = model;
+  manager.save(settings);
   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")}
-`);
-}
-// src/commands/docs.ts
-init_index_node();
-import { parseArgs as parseArgs2 } from "node:util";
-
-// src/config-manager.ts
-init_index_node();
-import { execSync as execSync2 } from "node:child_process";
-import { existsSync as existsSync15, mkdirSync as mkdirSync7, readFileSync as readFileSync13, writeFileSync as writeFileSync7 } from "node:fs";
-import { join as join15 } from "node:path";
-var LOCUS_GITIGNORE_MARKER = "# Locus AI";
-var LOCUS_MD_TEMPLATE = `## Planning First
-
-Complex tasks must be planned before writing code. Create ".locus/plans/<task-name>.md" with:
-- **Goal**: What we're trying to achieve and why
-- **Approach**: Step-by-step strategy with technical decisions
-- **Affected files**: List of files to create/modify/delete
-- **Acceptance criteria**: Specific, testable conditions for completion
-- **Dependencies**: Required packages, APIs, or external services
-
-Delete the planning .md files after successful execution.
-
-## Code Quality
-
-- **Follow existing patterns**: Run formatters and linters before finishing (check "package.json" scripts or project config)
-- **Minimize changes**: Keep modifications atomic. Separate refactors from behavioral changes into different tasks
-- **Never commit secrets**: No API keys, passwords, or credentials in code. Use environment variables or secret management
-- **Test as you go**: If tests exist, run relevant ones. If breaking changes occur, update tests accordingly
-- **Comment complex logic**: Explain *why*, not *what*. Focus on business logic and non-obvious decisions
-
-## Artifacts
-
-When a task produces knowledge, analysis, or research output rather than (or in addition to) code changes, you **must** save results as Markdown in ".locus/artifacts/<descriptive-name>.md":
-
-**Always create artifacts for:**
-- Code quality audits, security reviews, vulnerability assessments
-- Architecture analyses, system design proposals, or recommendations
-- Dependency reports, performance profiling, benchmarking results
-- Research summaries, technology comparisons, or feasibility studies
-- Migration plans, deployment strategies, or rollback procedures
-- Post-mortems, incident analysis, or debugging investigations
-
-**Artifact structure:**
-- Clear title and date
-- Executive summary (2-3 sentences)
-- Detailed findings/analysis
-- Actionable recommendations (if applicable)
-
-## Git Operations
-
-- **Do NOT run**: git add, git commit, git push, git checkout, git branch, or any git commands
-- **Why**: The Locus orchestrator handles all version control automatically after execution
-- **Your role**: Focus solely on making file changes. The system commits, pushes, and creates PRs
-
-## Continuous Learning
-
-Read ".locus/LEARNINGS.md" **before starting any task** to avoid repeating mistakes.
-
-**When to update:**
-- User corrects your approach or provides guidance
-- You discover a better pattern while working
-- A decision prevents future confusion (e.g., "use X not Y because Z")
-- You encounter and solve a tricky problem
-
-**What to record:**
-- Architectural decisions and their rationale
-- Preferred libraries, tools, or patterns for this project
-- Common pitfalls and how to avoid them
-- Project-specific conventions or user preferences
-- Solutions to non-obvious problems
-
-**Format (append-only, never delete):**
-
-"""
-- **[Category]**: Concise description (1-2 lines max). *Context if needed.*
-"""
-
-**Categories:** Architecture, Dependencies, Patterns, Debugging, Performance, Security, DevOps, User Preferences
-
-## Error Handling
-
-- **Read error messages carefully**: Don't guess. Parse the actual error before proposing fixes
-- **Check dependencies first**: Missing packages, wrong versions, and environment issues are common
-- **Verify assumptions**: If something "should work," confirm it actually does in this environment
-- **Ask for context**: If you need environment details, configuration, or logs, request them explicitly
-
-## Communication
+  ${c.success("✔")} ${c.bold("Settings configured successfully!")}
 
-- **Be precise**: When uncertain, state what you know and what you're assuming
-- **Show your work**: For complex changes, briefly explain the approach before executing
-- **Highlight trade-offs**: If multiple approaches exist, note why you chose one over others
-- **Request feedback**: For ambiguous requirements, propose an approach and ask for confirmation
-`;
-var DEFAULT_LEARNINGS_MD = `# Learnings
+  ${c.bold("Saved to:")} ${c.dim(".locus/settings.json")}
 
-This file captures important lessons, decisions, and corrections made during development.
-It is read by AI agents before every task to avoid repeating mistakes and to follow established patterns.
+  ${c.bold("Configuration:")}
+    ${c.primary("API Key:")}   ${maskSecret(apiKey)}${apiUrl ? `
+    ${c.primary("API URL:")}   ${apiUrl}` : ""}${provider ? `
+    ${c.primary("Provider:")}  ${provider}` : ""}${model ? `
+    ${c.primary("Model:")}     ${model}` : ""}
 
-<!-- Add learnings below this line. Format: - **[Category]**: Description -->
-`;
-function updateGitignore(projectPath) {
-  const gitignorePath = join15(projectPath, ".gitignore");
-  let content = "";
-  const locusBlock = LOCUS_GITIGNORE_PATTERNS.join(`
-`);
-  if (existsSync15(gitignorePath)) {
-    content = readFileSync13(gitignorePath, "utf-8");
-    if (content.includes(LOCUS_GITIGNORE_MARKER)) {
-      const lines = content.split(`
-`);
-      const startIdx = lines.findIndex((l) => l.includes(LOCUS_GITIGNORE_MARKER));
-      let endIdx = startIdx;
-      for (let i = startIdx;i < lines.length; i++) {
-        if (lines[i].startsWith(LOCUS_GITIGNORE_MARKER) || lines[i].startsWith(".locus") || lines[i].trim() === "") {
-          endIdx = i;
-        } else {
-          break;
-        }
-      }
-      const before = lines.slice(0, startIdx);
-      const after = lines.slice(endIdx + 1);
-      content = [...before, locusBlock, ...after].join(`
+  ${c.bold("Next steps:")}
+    Run agents:  ${c.primary("locus run")}
+    Setup Telegram: ${c.primary("locus telegram setup")}
 `);
-      writeFileSync7(gitignorePath, content);
-      return;
-    }
-    if (content.length > 0 && !content.endsWith(`
-`)) {
-      content += `
-`;
-    }
-    if (content.trim().length > 0) {
-      content += `
-`;
-    }
-  }
-  content += `${locusBlock}
-`;
-  writeFileSync7(gitignorePath, content);
 }
-function ensureGitIdentity(projectPath) {
-  const hasName = (() => {
-    try {
-      return execSync2("git config --get user.name", {
-        cwd: projectPath,
-        stdio: ["pipe", "pipe", "pipe"]
-      }).toString().trim();
-    } catch {
-      return "";
-    }
-  })();
-  const hasEmail = (() => {
-    try {
-      return execSync2("git config --get user.email", {
-        cwd: projectPath,
-        stdio: ["pipe", "pipe", "pipe"]
-      }).toString().trim();
-    } catch {
-      return "";
-    }
-  })();
-  if (!hasName) {
-    execSync2('git config user.name "LocusAgent"', {
-      cwd: projectPath,
-      stdio: "ignore"
-    });
+function showCommand(projectPath) {
+  const manager = new SettingsManager(projectPath);
+  const settings = manager.load();
+  if (Object.keys(settings).length === 0) {
+    console.log(`
+  ${c.dim("No settings found.")}
+` + `  Run ${c.primary("locus config setup")} to configure.
+`);
+    return;
   }
-  if (!hasEmail) {
-    execSync2('git config user.email "agent@locusai.team"', {
-      cwd: projectPath,
-      stdio: "ignore"
-    });
+  console.log(`
+  ${c.header(" SETTINGS ")}`);
+  console.log(`  ${c.dim("File: .locus/settings.json")}
+`);
+  if (settings.apiKey) {
+    console.log(`    ${c.primary("apiKey:")}       ${maskSecret(settings.apiKey)}`);
   }
-  execSync2("git config --global pull.rebase true", {
-    cwd: projectPath,
-    stdio: "ignore"
-  });
-}
-
-class ConfigManager {
-  projectPath;
-  constructor(projectPath) {
-    this.projectPath = projectPath;
+  if (settings.apiUrl) {
+    console.log(`    ${c.primary("apiUrl:")}       ${settings.apiUrl}`);
   }
-  async init(version2) {
-    const locusConfigDir = join15(this.projectPath, LOCUS_CONFIG.dir);
-    const locusConfigPath = getLocusPath(this.projectPath, "configFile");
-    if (!existsSync15(locusConfigDir)) {
-      mkdirSync7(locusConfigDir, { recursive: true });
-    }
-    const locusSubdirs = [
-      LOCUS_CONFIG.artifactsDir,
-      LOCUS_CONFIG.documentsDir,
-      LOCUS_CONFIG.sessionsDir,
-      LOCUS_CONFIG.reviewsDir,
-      LOCUS_CONFIG.plansDir,
-      LOCUS_CONFIG.discussionsDir
-    ];
-    for (const subdir of locusSubdirs) {
-      const subdirPath = join15(locusConfigDir, subdir);
-      if (!existsSync15(subdirPath)) {
-        mkdirSync7(subdirPath, { recursive: true });
-      }
-    }
-    const locusMdPath = getLocusPath(this.projectPath, "contextFile");
-    if (!existsSync15(locusMdPath)) {
-      writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
-    }
-    const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync15(learningsMdPath)) {
-      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
-    }
-    if (!existsSync15(locusConfigPath)) {
-      const config2 = {
-        $schema: LOCUS_SCHEMAS.config,
-        version: version2,
-        createdAt: new Date().toISOString(),
-        projectPath: "."
-      };
-      writeFileSync7(locusConfigPath, JSON.stringify(config2, null, 2));
-    }
-    updateGitignore(this.projectPath);
-    ensureGitIdentity(this.projectPath);
+  if (settings.provider) {
+    console.log(`    ${c.primary("provider:")}     ${settings.provider}`);
   }
-  loadConfig() {
-    const path3 = getLocusPath(this.projectPath, "configFile");
-    if (existsSync15(path3)) {
-      return JSON.parse(readFileSync13(path3, "utf-8"));
-    }
-    return null;
+  if (settings.model) {
+    console.log(`    ${c.primary("model:")}        ${settings.model}`);
   }
-  updateVersion(version2) {
-    const config2 = this.loadConfig();
-    if (config2 && config2.version !== version2) {
-      config2.version = version2;
-      this.saveConfig(config2);
-    }
+  if (settings.workspaceId) {
+    console.log(`    ${c.primary("workspaceId:")}  ${settings.workspaceId}`);
   }
-  async reinit(version2) {
-    const result = {
-      versionUpdated: false,
-      previousVersion: null,
-      directoriesCreated: [],
-      gitignoreUpdated: false
-    };
-    const config2 = this.loadConfig();
-    if (config2) {
-      result.previousVersion = config2.version;
-      const needsSchemaUpdate = config2.$schema !== LOCUS_SCHEMAS.config;
-      if (config2.version !== version2) {
-        config2.version = version2;
-        result.versionUpdated = true;
-      }
-      if (result.versionUpdated || needsSchemaUpdate) {
-        this.saveConfig(config2);
-      }
-    }
-    const settingsPath = join15(this.projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
-    if (existsSync15(settingsPath)) {
-      const raw = readFileSync13(settingsPath, "utf-8");
-      const settings = JSON.parse(raw);
-      if (settings.$schema !== LOCUS_SCHEMAS.settings) {
-        const { $schema: _2, ...rest } = settings;
-        const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
-        writeFileSync7(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
-      }
-    }
-    const locusMdPath = getLocusPath(this.projectPath, "contextFile");
-    const locusMdExisted = existsSync15(locusMdPath);
-    writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
-    if (!locusMdExisted) {
-      result.directoriesCreated.push(".locus/LOCUS.md");
-    }
-    const locusSubdirs = [
-      LOCUS_CONFIG.artifactsDir,
-      LOCUS_CONFIG.documentsDir,
-      LOCUS_CONFIG.sessionsDir,
-      LOCUS_CONFIG.reviewsDir,
-      LOCUS_CONFIG.plansDir,
-      LOCUS_CONFIG.discussionsDir
-    ];
-    const locusConfigDir = join15(this.projectPath, LOCUS_CONFIG.dir);
-    for (const subdir of locusSubdirs) {
-      const subdirPath = join15(locusConfigDir, subdir);
-      if (!existsSync15(subdirPath)) {
-        mkdirSync7(subdirPath, { recursive: true });
-        result.directoriesCreated.push(`.locus/${subdir}`);
-      }
+  if (settings.telegram) {
+    const tg = settings.telegram;
+    console.log(`
+    ${c.header(" TELEGRAM ")}`);
+    if (tg.botToken) {
+      console.log(`    ${c.primary("botToken:")}     ${maskSecret(tg.botToken)}`);
     }
-    const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
-    if (!existsSync15(learningsMdPath)) {
-      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
-      result.directoriesCreated.push(".locus/LEARNINGS.md");
+    if (tg.chatId) {
+      console.log(`    ${c.primary("chatId:")}       ${tg.chatId}`);
     }
-    const gitignorePath = join15(this.projectPath, ".gitignore");
-    const gitignoreBefore = existsSync15(gitignorePath) ? readFileSync13(gitignorePath, "utf-8") : "";
-    updateGitignore(this.projectPath);
-    const gitignoreAfter = readFileSync13(gitignorePath, "utf-8");
-    if (gitignoreBefore !== gitignoreAfter) {
-      result.gitignoreUpdated = true;
+    if (tg.testMode !== undefined) {
+      console.log(`    ${c.primary("testMode:")}     ${tg.testMode}`);
     }
-    ensureGitIdentity(this.projectPath);
-    return result;
-  }
-  saveConfig(config2) {
-    const { $schema: _2, ...rest } = config2;
-    const ordered = { $schema: LOCUS_SCHEMAS.config, ...rest };
-    const path3 = getLocusPath(this.projectPath, "configFile");
-    writeFileSync7(path3, JSON.stringify(ordered, null, 2));
   }
+  console.log("");
 }
-
-// src/workspace-resolver.ts
-init_index_node();
-
-class WorkspaceResolver {
-  options;
-  constructor(options) {
-    this.options = options;
+function setCommand(args, projectPath) {
+  const key = args[0]?.trim();
+  const value = args.slice(1).join(" ").trim();
+  if (!key || !value) {
+    console.error(`
+  ${c.error("✖")} ${c.bold("Usage:")} locus config set <key> <value>
+` + `  ${c.dim(`Available keys: ${ALL_KEYS.join(", ")}`)}
+`);
+    process.exit(1);
   }
-  async resolve() {
-    if (this.options.workspaceId) {
-      return this.options.workspaceId;
+  if (!ALL_KEYS.includes(key)) {
+    console.error(`
+  ${c.error("✖")} ${c.bold(`Unknown key: ${key}`)}
+` + `  ${c.dim(`Available keys: ${ALL_KEYS.join(", ")}`)}
+`);
+    process.exit(1);
+  }
+  const manager = new SettingsManager(projectPath);
+  const settings = manager.load();
+  if (key.startsWith("telegram.")) {
+    const telegramKey = key.replace("telegram.", "");
+    if (!settings.telegram) {
+      settings.telegram = {};
     }
-    try {
-      console.log(c.dim("ℹ  Resolving workspace from API key..."));
-      const client = new LocusClient({
-        baseUrl: this.options.apiBase,
-        token: this.options.apiKey
-      });
-      const info = await client.auth.getApiKeyInfo();
-      if (info.workspaceId) {
-        console.log(c.success(`✓  Resolved workspace: ${info.workspaceId}`));
-        return info.workspaceId;
+    if (telegramKey === "chatId") {
+      const num = Number(value);
+      if (Number.isNaN(num)) {
+        console.error(`
+  ${c.error("✖")} ${c.bold(`${key} must be a number.`)}
+`);
+        process.exit(1);
       }
-      throw new Error("API key is not associated with a workspace. Please specify --workspace.");
-    } catch (error48) {
-      throw new Error(`Error resolving workspace: ${error48 instanceof Error ? error48.message : String(error48)}`);
+      settings.telegram[telegramKey] = num;
+    } else if (telegramKey === "testMode") {
+      settings.telegram[telegramKey] = value === "true" || value === "1";
+    } else {
+      settings.telegram[telegramKey] = value;
     }
+  } else {
+    settings[key] = value;
+  }
+  manager.save(settings);
+  const displayValue = key === "apiKey" || key === "telegram.botToken" ? maskSecret(value) : value;
+  console.log(`
+  ${c.success("✔")} Set ${c.primary(key)} = ${displayValue}
+`);
+}
+function removeCommand(projectPath) {
+  const manager = new SettingsManager(projectPath);
+  if (!manager.exists()) {
+    console.log(`
+  ${c.dim("No settings found. Nothing to remove.")}
+`);
+    return;
   }
+  manager.remove();
+  console.log(`
+  ${c.success("✔")} ${c.bold("Settings removed.")}
+`);
 }
-
-// src/commands/docs.ts
-async function docsCommand(args) {
+async function configCommand(args) {
+  const projectPath = process.cwd();
   const subcommand = args[0];
   const subArgs = args.slice(1);
   switch (subcommand) {
-    case "sync":
-      await docsSyncCommand(subArgs);
+    case "setup":
+      await setupCommand(subArgs, projectPath);
       break;
-    default:
-      showDocsHelp();
+    case "show":
+      showCommand(projectPath);
+      break;
+    case "set":
+      setCommand(subArgs, projectPath);
+      break;
+    case "remove":
+      removeCommand(projectPath);
       break;
+    default:
+      showConfigHelp();
   }
 }
-async function docsSyncCommand(args) {
-  const { values } = parseArgs2({
+// src/commands/discuss.ts
+init_index_node();
+init_progress_renderer();
+init_settings_manager();
+init_utils3();
+import * as readline2 from "node:readline";
+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();
+  const projectPath = values.dir || process.cwd();
+  requireInitialization(projectPath, "discuss");
+  const discussionManager = new DiscussionManager(projectPath);
+  if (values.list) {
+    return listDiscussions(discussionManager);
+  }
+  if (values.show) {
+    return showDiscussion(discussionManager, values.show);
+  }
+  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 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
+  });
+  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({ animated: true });
+  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(`
+
+`);
+    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);
+  }
+  console.log(`  ${c.dim("Type your response, or 'help' for commands. Use 'exit' or Ctrl+C to quit.")}
+`);
+  const rl = readline2.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: true
+  });
+  rl.setPrompt(c.cyan("> "));
+  rl.prompt();
+  let isProcessing = false;
+  const shutdown = () => {
+    if (isProcessing) {
+      aiRunner.abort();
+    }
+    console.log(`
+  ${c.dim("Discussion saved.")} ${c.dim("ID:")} ${c.cyan(discussionId)}`);
+    console.log(c.dim(`
+  Goodbye!
+`));
+    rl.close();
+    process.exit(0);
+  };
+  process.on("SIGINT", () => {
+    if (isProcessing) {
+      aiRunner.abort();
+      isProcessing = false;
+      console.log(c.dim(`
+[Interrupted]`));
+      rl.prompt();
+    } else {
+      shutdown();
+    }
+  });
+  rl.on("close", () => {
+    shutdown();
+  });
+  rl.on("line", async (input) => {
+    const trimmed = input.trim();
+    if (trimmed === "" || isProcessing) {
+      rl.prompt();
+      return;
+    }
+    const lowerInput = trimmed.toLowerCase();
+    if (lowerInput === "help") {
+      showReplHelp();
+      rl.prompt();
+      return;
+    }
+    if (lowerInput === "exit" || lowerInput === "quit") {
+      shutdown();
+      return;
+    }
+    if (lowerInput === "insights") {
+      showCurrentInsights(discussionManager, discussionId);
+      rl.prompt();
+      return;
+    }
+    if (lowerInput === "summary") {
+      isProcessing = true;
+      const summaryRenderer = new ProgressRenderer({ animated: true });
+      try {
+        summaryRenderer.showThinkingStarted();
+        const summary = await facilitator.summarizeDiscussion(discussionId);
+        summaryRenderer.showThinkingStopped();
+        process.stdout.write(`
+`);
+        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)}
+`);
+      }
+      rl.close();
+      process.exit(0);
+      return;
+    }
+    isProcessing = true;
+    const chunkRenderer = new ProgressRenderer({ animated: true });
+    try {
+      chunkRenderer.showThinkingStarted();
+      const stream4 = facilitator.continueDiscussionStream(discussionId, trimmed);
+      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)}
+`);
+        }
+      }
+    } catch (error48) {
+      chunkRenderer.finalize();
+      console.error(`
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
+`);
+    }
+    isProcessing = false;
+    rl.prompt();
+  });
+}
+function listDiscussions(discussionManager) {
+  const discussions = discussionManager.list();
+  if (discussions.length === 0) {
+    console.log(`
+  ${c.dim("No discussions found.")}
+`);
+    console.log(`  ${c.dim("Start one with:")} ${c.cyan('locus discuss "your topic"')}
+`);
     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.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("");
+  }
+}
+function showDiscussion(discussionManager, id) {
+  const md = discussionManager.getMarkdown(id);
+  if (!md) {
     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`)}
+  ${c.error("✖")} ${c.red(`Discussion not found: ${id}`)}
 `);
     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;
+  console.log(`
+${md}
+`);
+}
+function archiveDiscussion(discussionManager, id) {
   try {
-    workspaceId = await resolver.resolve();
+    discussionManager.archive(id);
+    console.log(`
+  ${c.success("✔")} ${c.dim("Discussion archived.")}
+`);
   } 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,
-    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}`);
-    }
-  });
-  console.log(`
-  ${c.info("●")} ${c.bold("Syncing docs from API...")}
-`);
+}
+function deleteDiscussion(discussionManager, id) {
   try {
-    await fetcher.fetch();
+    discussionManager.delete(id);
     console.log(`
-  ${c.success("✔")} ${c.success("Docs sync complete.")} ${c.dim("Local docs: .locus/documents")}
+  ${c.success("✔")} ${c.dim("Discussion deleted.")}
 `);
   } catch (error48) {
     console.error(`
-  ${c.error("✖")} ${c.red(`Docs sync failed: ${error48 instanceof Error ? error48.message : String(error48)}`)}
+  ${c.error("✖")} ${c.red(error48 instanceof Error ? error48.message : String(error48))}
 `);
     process.exit(1);
   }
 }
-function showDocsHelp() {
+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(" DOCS ")}
-    ${c.primary("locus docs")} ${c.dim("<command> [options]")}
+  ${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(" COMMANDS ")}
-    ${c.success("sync")}      Sync workspace docs from API to .locus/documents
+    ${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(" EXAMPLES ")}
-    ${c.dim("$")} ${c.primary("locus docs sync")}
-    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
+  ${c.dim("Type anything else to continue the discussion.")}
 `);
 }
-function showDocsSyncHelp() {
+function showDiscussHelp() {
   console.log(`
-  ${c.header(" DOCS SYNC ")}
-    ${c.primary("locus docs sync")} ${c.dim("[options]")}
+  ${c.header(" LOCUS DISCUSS ")} ${c.dim("— Interactive AI Discussion")}
 
-  ${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("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")}
+`);
+}
+// src/commands/docs.ts
+init_index_node();
+import { parseArgs as parseArgs4 } from "node:util";
+
+// src/config-manager.ts
+init_index_node();
+import { execSync as execSync2 } from "node:child_process";
+import { existsSync as existsSync16, mkdirSync as mkdirSync7, readFileSync as readFileSync14, writeFileSync as writeFileSync7 } from "node:fs";
+import { join as join16 } from "node:path";
+var LOCUS_GITIGNORE_MARKER = "# Locus AI";
+var LOCUS_MD_TEMPLATE = `## Planning First
+
+Complex tasks must be planned before writing code. Create ".locus/plans/<task-name>.md" with:
+- **Goal**: What we're trying to achieve and why
+- **Approach**: Step-by-step strategy with technical decisions
+- **Affected files**: List of files to create/modify/delete
+- **Acceptance criteria**: Specific, testable conditions for completion
+- **Dependencies**: Required packages, APIs, or external services
+
+Delete the planning .md files after successful execution.
+
+## Code Quality
+
+- **Follow existing patterns**: Run formatters and linters before finishing (check "package.json" scripts or project config)
+- **Minimize changes**: Keep modifications atomic. Separate refactors from behavioral changes into different tasks
+- **Never commit secrets**: No API keys, passwords, or credentials in code. Use environment variables or secret management
+- **Test as you go**: If tests exist, run relevant ones. If breaking changes occur, update tests accordingly
+- **Comment complex logic**: Explain *why*, not *what*. Focus on business logic and non-obvious decisions
+
+## Artifacts
+
+When a task produces knowledge, analysis, or research output rather than (or in addition to) code changes, you **must** save results as Markdown in ".locus/artifacts/<descriptive-name>.md":
+
+**Always create artifacts for:**
+- Code quality audits, security reviews, vulnerability assessments
+- Architecture analyses, system design proposals, or recommendations
+- Dependency reports, performance profiling, benchmarking results
+- Research summaries, technology comparisons, or feasibility studies
+- Migration plans, deployment strategies, or rollback procedures
+- Post-mortems, incident analysis, or debugging investigations
+
+**Artifact structure:**
+- Clear title and date
+- Executive summary (2-3 sentences)
+- Detailed findings/analysis
+- Actionable recommendations (if applicable)
+
+## Git Operations
+
+- **Do NOT run**: git add, git commit, git push, git checkout, git branch, or any git commands
+- **Why**: The Locus orchestrator handles all version control automatically after execution
+- **Your role**: Focus solely on making file changes. The system commits, pushes, and creates PRs
+
+## Continuous Learning
+
+Read ".locus/LEARNINGS.md" **before starting any task** to avoid repeating mistakes.
+
+**When to update:**
+- User corrects your approach or provides guidance
+- You discover a better pattern while working
+- A decision prevents future confusion (e.g., "use X not Y because Z")
+- You encounter and solve a tricky problem
+
+**What to record:**
+- Architectural decisions and their rationale
+- Preferred libraries, tools, or patterns for this project
+- Common pitfalls and how to avoid them
+- Project-specific conventions or user preferences
+- Solutions to non-obvious problems
+
+**Format (append-only, never delete):**
+
+"""
+- **[Category]**: Concise description (1-2 lines max). *Context if needed.*
+"""
+
+**Categories:** Architecture, Dependencies, Patterns, Debugging, Performance, Security, DevOps, User Preferences
+
+## Error Handling
+
+- **Read error messages carefully**: Don't guess. Parse the actual error before proposing fixes
+- **Check dependencies first**: Missing packages, wrong versions, and environment issues are common
+- **Verify assumptions**: If something "should work," confirm it actually does in this environment
+- **Ask for context**: If you need environment details, configuration, or logs, request them explicitly
 
-  ${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 parseArgs3 } from "node:util";
+## Communication
 
-// src/display/json-stream-renderer.ts
-init_src();
+- **Be precise**: When uncertain, state what you know and what you're assuming
+- **Show your work**: For complex changes, briefly explain the approach before executing
+- **Highlight trade-offs**: If multiple approaches exist, note why you chose one over others
+- **Request feedback**: For ambiguous requirements, propose an approach and ask for confirmation
+`;
+var DEFAULT_LEARNINGS_MD = `# Learnings
 
-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);
+This file captures important lessons, decisions, and corrections made during development.
+It is read by AI agents before every task to avoid repeating mistakes and to follow established patterns.
+
+<!-- Add learnings below this line. Format: - **[Category]**: Description -->
+`;
+function updateGitignore(projectPath) {
+  const gitignorePath = join16(projectPath, ".gitignore");
+  let content = "";
+  const locusBlock = LOCUS_GITIGNORE_PATTERNS.join(`
+`);
+  if (existsSync16(gitignorePath)) {
+    content = readFileSync14(gitignorePath, "utf-8");
+    if (content.includes(LOCUS_GITIGNORE_MARKER)) {
+      const lines = content.split(`
+`);
+      const startIdx = lines.findIndex((l) => l.includes(LOCUS_GITIGNORE_MARKER));
+      let endIdx = startIdx;
+      for (let i = startIdx;i < lines.length; i++) {
+        if (lines[i].startsWith(LOCUS_GITIGNORE_MARKER) || lines[i].startsWith(".locus") || lines[i].trim() === "") {
+          endIdx = i;
         } else {
-          this.statsTracker.toolFailed(chunk.tool, chunk.error ?? "Unknown error", chunk.id);
+          break;
         }
-        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)
+      }
+      const before = lines.slice(0, startIdx);
+      const after = lines.slice(endIdx + 1);
+      content = [...before, locusBlock, ...after].join(`
+`);
+      writeFileSync7(gitignorePath, content);
       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();
+    }
+    if (content.length > 0 && !content.endsWith(`
+`)) {
+      content += `
+`;
+    }
+    if (content.trim().length > 0) {
+      content += `
+`;
     }
   }
-  emit(event) {
-    process.stdout.write(`${JSON.stringify(event)}
-`);
-  }
+  content += `${locusBlock}
+`;
+  writeFileSync7(gitignorePath, content);
 }
-
-// src/commands/exec.ts
-init_progress_renderer();
-
-// 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`;
+function ensureGitIdentity(projectPath) {
+  const hasName = (() => {
+    try {
+      return execSync2("git config --get user.name", {
+        cwd: projectPath,
+        stdio: ["pipe", "pipe", "pipe"]
+      }).toString().trim();
+    } catch {
+      return "";
+    }
+  })();
+  const hasEmail = (() => {
+    try {
+      return execSync2("git config --get user.email", {
+        cwd: projectPath,
+        stdio: ["pipe", "pipe", "pipe"]
+      }).toString().trim();
+    } catch {
+      return "";
+    }
+  })();
+  if (!hasName) {
+    execSync2('git config user.name "LocusAgent"', {
+      cwd: projectPath,
+      stdio: "ignore"
+    });
   }
-  if (minutes > 0) {
-    return minutes === 1 ? "1 minute ago" : `${minutes} minutes ago`;
+  if (!hasEmail) {
+    execSync2('git config user.email "agent@locusai.team"', {
+      cwd: projectPath,
+      stdio: "ignore"
+    });
   }
-  return "just now";
+  execSync2("git config --global pull.rebase true", {
+    cwd: projectPath,
+    stdio: "ignore"
+  });
 }
 
-class SessionCommands {
-  historyManager;
+class ConfigManager {
+  projectPath;
   constructor(projectPath) {
-    this.historyManager = new HistoryManager(projectPath);
+    this.projectPath = projectPath;
   }
-  async list() {
-    const sessions = this.historyManager.listSessions();
-    if (sessions.length === 0) {
-      console.log(`
-  ${c.dim("No exec sessions found.")}
-`);
-      return;
+  async init(version2) {
+    const locusConfigDir = join16(this.projectPath, LOCUS_CONFIG.dir);
+    const locusConfigPath = getLocusPath(this.projectPath, "configFile");
+    if (!existsSync16(locusConfigDir)) {
+      mkdirSync7(locusConfigDir, { recursive: true });
+    }
+    const locusSubdirs = [
+      LOCUS_CONFIG.artifactsDir,
+      LOCUS_CONFIG.documentsDir,
+      LOCUS_CONFIG.sessionsDir,
+      LOCUS_CONFIG.reviewsDir,
+      LOCUS_CONFIG.plansDir,
+      LOCUS_CONFIG.discussionsDir
+    ];
+    for (const subdir of locusSubdirs) {
+      const subdirPath = join16(locusConfigDir, subdir);
+      if (!existsSync16(subdirPath)) {
+        mkdirSync7(subdirPath, { recursive: true });
+      }
+    }
+    const locusMdPath = getLocusPath(this.projectPath, "contextFile");
+    if (!existsSync16(locusMdPath)) {
+      writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
     }
-    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();
+    const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
+    if (!existsSync16(learningsMdPath)) {
+      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
     }
-    if (sessions.length > 10) {
-      console.log(c.dim(`  ... and ${sessions.length - 10} more sessions
-`));
+    if (!existsSync16(locusConfigPath)) {
+      const config2 = {
+        $schema: LOCUS_SCHEMAS.config,
+        version: version2,
+        createdAt: new Date().toISOString(),
+        projectPath: "."
+      };
+      writeFileSync7(locusConfigPath, JSON.stringify(config2, null, 2));
     }
+    updateGitignore(this.projectPath);
+    ensureGitIdentity(this.projectPath);
   }
-  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>")}
-`);
-      return;
+  loadConfig() {
+    const path3 = getLocusPath(this.projectPath, "configFile");
+    if (existsSync16(path3)) {
+      return JSON.parse(readFileSync14(path3, "utf-8"));
     }
-    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;
+    return null;
+  }
+  updateVersion(version2) {
+    const config2 = this.loadConfig();
+    if (config2 && config2.version !== version2) {
+      config2.version = version2;
+      this.saveConfig(config2);
     }
-    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})`)}
-`);
-    if (session2.messages.length === 0) {
-      console.log(`  ${c.dim("(No messages in this session)")}
-`);
-      return;
+  }
+  async reinit(version2) {
+    const result = {
+      versionUpdated: false,
+      previousVersion: null,
+      directoriesCreated: [],
+      gitignoreUpdated: false
+    };
+    const config2 = this.loadConfig();
+    if (config2) {
+      result.previousVersion = config2.version;
+      const needsSchemaUpdate = config2.$schema !== LOCUS_SCHEMAS.config;
+      if (config2.version !== version2) {
+        config2.version = version2;
+        result.versionUpdated = true;
+      }
+      if (result.versionUpdated || needsSchemaUpdate) {
+        this.saveConfig(config2);
+      }
     }
-    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}`);
+    const settingsPath = join16(this.projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.settingsFile);
+    if (existsSync16(settingsPath)) {
+      const raw = readFileSync14(settingsPath, "utf-8");
+      const settings = JSON.parse(raw);
+      if (settings.$schema !== LOCUS_SCHEMAS.settings) {
+        const { $schema: _2, ...rest } = settings;
+        const ordered = { $schema: LOCUS_SCHEMAS.settings, ...rest };
+        writeFileSync7(settingsPath, JSON.stringify(ordered, null, 2), "utf-8");
       }
-      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 locusMdPath = getLocusPath(this.projectPath, "contextFile");
+    const locusMdExisted = existsSync16(locusMdPath);
+    writeFileSync7(locusMdPath, LOCUS_MD_TEMPLATE);
+    if (!locusMdExisted) {
+      result.directoriesCreated.push(".locus/LOCUS.md");
     }
-    const session2 = this.historyManager.findSessionByPartialId(sessionId);
-    if (!session2) {
-      console.error(`
-  ${c.error("Error:")} Session ${c.cyan(sessionId)} not found
-`);
-      return;
+    const locusSubdirs = [
+      LOCUS_CONFIG.artifactsDir,
+      LOCUS_CONFIG.documentsDir,
+      LOCUS_CONFIG.sessionsDir,
+      LOCUS_CONFIG.reviewsDir,
+      LOCUS_CONFIG.plansDir,
+      LOCUS_CONFIG.discussionsDir
+    ];
+    const locusConfigDir = join16(this.projectPath, LOCUS_CONFIG.dir);
+    for (const subdir of locusSubdirs) {
+      const subdirPath = join16(locusConfigDir, subdir);
+      if (!existsSync16(subdirPath)) {
+        mkdirSync7(subdirPath, { recursive: true });
+        result.directoriesCreated.push(`.locus/${subdir}`);
+      }
     }
-    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
-`);
+    const learningsMdPath = getLocusPath(this.projectPath, "learningsFile");
+    if (!existsSync16(learningsMdPath)) {
+      writeFileSync7(learningsMdPath, DEFAULT_LEARNINGS_MD);
+      result.directoriesCreated.push(".locus/LEARNINGS.md");
     }
-  }
-  async clear() {
-    const count = this.historyManager.getSessionCount();
-    if (count === 0) {
-      console.log(`
-  ${c.dim("No sessions to clear.")}
-`);
-      return;
+    const gitignorePath = join16(this.projectPath, ".gitignore");
+    const gitignoreBefore = existsSync16(gitignorePath) ? readFileSync14(gitignorePath, "utf-8") : "";
+    updateGitignore(this.projectPath);
+    const gitignoreAfter = readFileSync14(gitignorePath, "utf-8");
+    if (gitignoreBefore !== gitignoreAfter) {
+      result.gitignoreUpdated = true;
     }
-    const deleted = this.historyManager.clearAllSessions();
-    console.log(`
-  ${c.success("✔")} Cleared ${deleted} exec session${deleted === 1 ? "" : "s"}
-`);
+    ensureGitIdentity(this.projectPath);
+    return result;
   }
-  getShortId(sessionId) {
-    const parts = sessionId.split("-");
-    if (parts.length >= 3) {
-      return parts.slice(-1)[0].slice(0, 8);
-    }
-    return sessionId.slice(0, 8);
+  saveConfig(config2) {
+    const { $schema: _2, ...rest } = config2;
+    const ordered = { $schema: LOCUS_SCHEMAS.config, ...rest };
+    const path3 = getLocusPath(this.projectPath, "configFile");
+    writeFileSync7(path3, JSON.stringify(ordered, null, 2));
   }
 }
-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
+// src/commands/docs.ts
+init_settings_manager();
+init_utils3();
 
-  ${c.dim("Session IDs can be partial (first 8 characters).")}
-`);
-}
+// src/workspace-resolver.ts
+init_index_node();
 
-// src/commands/exec.ts
-async function execCommand(args) {
-  const { values, positionals } = parseArgs3({
-    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;
+class WorkspaceResolver {
+  options;
+  constructor(options) {
+    this.options = options;
   }
-  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;
+  async resolve() {
+    if (this.options.workspaceId) {
+      return this.options.workspaceId;
+    }
+    try {
+      console.log(c.dim("ℹ  Resolving workspace from API key..."));
+      const client = new LocusClient({
+        baseUrl: this.options.apiBase,
+        token: this.options.apiKey
+      });
+      const info = await client.auth.getApiKeyInfo();
+      if (info.workspaceId) {
+        console.log(c.success(`✓  Resolved workspace: ${info.workspaceId}`));
+        return info.workspaceId;
+      }
+      throw new Error("API key is not associated with a workspace. Please specify --workspace.");
+    } catch (error48) {
+      throw new Error(`Error resolving workspace: ${error48 instanceof Error ? error48.message : String(error48)}`);
     }
   }
-  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();
+}
+
+// src/commands/docs.ts
+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" },
+      help: { type: "boolean" }
+    },
+    strict: false
+  });
+  if (values.help) {
+    showDocsSyncHelp();
     return;
   }
-  const promptInput = positionals.join(" ");
-  if (!promptInput) {
-    console.error(c.error('Error: Prompt is required. Usage: locus exec "your prompt" or locus exec --interactive'));
+  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);
   }
-  const useStreaming = !values["no-stream"];
-  const reasoningEffort = values["reasoning-effort"];
-  const aiRunner = createAiRunner(provider, {
-    projectPath,
-    model,
-    reasoningEffort
+  const apiBase = values["api-url"] || settings.apiUrl || "https://api.locusai.dev/api";
+  const resolver = new WorkspaceResolver({
+    apiKey,
+    apiBase,
+    workspaceId: values.workspace
   });
-  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 = "";
+  let workspaceId;
   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!")}
-`);
+    workspaceId = await resolver.resolve();
   } 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 client = new LocusClient({
+    baseUrl: apiBase,
+    token: apiKey
   });
-  const handleSignal = () => {
-    if (!renderer.isDone()) {
-      renderer.emitFatalError("PROCESS_CRASHED", "Process terminated by signal");
+  const fetcher = new DocumentFetcher({
+    client,
+    workspaceId,
+    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}`);
     }
-    process.exit(1);
-  };
-  process.on("SIGINT", handleSignal);
-  process.on("SIGTERM", handleSignal);
+  });
+  console.log(`
+  ${c.info("●")} ${c.bold("Syncing docs from API...")}
+`);
   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);
+    await fetcher.fetch();
+    console.log(`
+  ${c.success("✔")} ${c.success("Docs sync complete.")} ${c.dim("Local docs: .locus/documents")}
+`);
   } catch (error48) {
-    const message = error48 instanceof Error ? error48.message : String(error48);
-    if (!renderer.isDone()) {
-      renderer.emitFatalError("UNKNOWN", message);
-    }
+    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")}
+`);
+}
+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
+
+  ${c.header(" EXAMPLES ")}
+    ${c.dim("$")} ${c.primary("locus docs sync")}
+    ${c.dim("$")} ${c.primary("locus docs sync --workspace ws_123")}
+`);
+}
+
+// src/commands/index.ts
+init_exec2();
+init_exec_sessions();
+
 // src/commands/help.ts
 init_index_node();
 function showHelp2() {
@@ -44669,6 +44911,9 @@ function showHelp2() {
               ${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
 
@@ -44692,13 +44937,15 @@ function showHelp2() {
     ${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 artifacts show reduce-cli-terminal-output")}
 
   For more information, visit: ${c.underline("https://docs.locusai.dev")}
 `);
 }
 // src/commands/index-codebase.ts
 init_index_node();
-import { parseArgs as parseArgs4 } from "node:util";
+import { parseArgs as parseArgs5 } from "node:util";
 
 // src/tree-summarizer.ts
 init_index_node();
@@ -44725,8 +44972,9 @@ ${tree}`;
 }
 
 // src/commands/index-codebase.ts
+init_utils3();
 async function indexCommand(args) {
-  const { values } = parseArgs4({
+  const { values } = parseArgs5({
     args,
     options: {
       dir: { type: "string" },
@@ -44765,6 +45013,7 @@ async function indexCommand(args) {
 }
 // src/commands/init.ts
 init_index_node();
+init_utils3();
 async function initCommand() {
   const projectPath = process.cwd();
   const configManager = new ConfigManager(projectPath);
@@ -44824,9 +45073,11 @@ async function initCommand() {
 }
 // src/commands/plan.ts
 init_index_node();
-import { existsSync as existsSync16, unlinkSync as unlinkSync5 } from "node:fs";
-import { join as join16 } from "node:path";
-import { parseArgs as parseArgs5 } from "node:util";
+import { existsSync as existsSync17, unlinkSync as unlinkSync5 } from "node:fs";
+import { join as join17 } from "node:path";
+import { parseArgs as parseArgs6 } from "node:util";
+init_settings_manager();
+init_utils3();
 function normalizePlanIdArgs(args) {
   const planIdFlags = new Set(["--approve", "--reject", "--cancel", "--show"]);
   const result = [];
@@ -44845,7 +45096,7 @@ function normalizePlanIdArgs(args) {
 }
 async function planCommand(args) {
   const normalizedArgs = normalizePlanIdArgs(args);
-  const { values, positionals } = parseArgs5({
+  const { values, positionals } = parseArgs6({
     args: normalizedArgs,
     options: {
       approve: { type: "string" },
@@ -44932,8 +45183,8 @@ async function planCommand(args) {
   try {
     const result = await meeting.run(directive, feedback);
     planManager.save(result.plan);
-    const tempFile = join16(getLocusPath(projectPath, "plansDir"), `${result.plan.id}.json`);
-    if (existsSync16(tempFile)) {
+    const tempFile = join17(getLocusPath(projectPath, "plansDir"), `${result.plan.id}.json`);
+    if (existsSync17(tempFile)) {
       unlinkSync5(tempFile);
     }
     console.log(`
@@ -45130,9 +45381,11 @@ function showPlanHelp() {
 }
 // src/commands/review.ts
 init_index_node();
-import { existsSync as existsSync17, mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "node:fs";
-import { join as join17 } from "node:path";
-import { parseArgs as parseArgs6 } from "node:util";
+import { existsSync as existsSync18, mkdirSync as mkdirSync8, writeFileSync as writeFileSync8 } from "node:fs";
+import { join as join18 } from "node:path";
+import { parseArgs as parseArgs7 } from "node:util";
+init_settings_manager();
+init_utils3();
 async function reviewCommand(args) {
   const subcommand = args[0];
   if (subcommand === "local") {
@@ -45141,7 +45394,7 @@ async function reviewCommand(args) {
   return reviewPrsCommand(args);
 }
 async function reviewPrsCommand(args) {
-  const { values } = parseArgs6({
+  const { values } = parseArgs7({
     args,
     options: {
       "api-key": { type: "string" },
@@ -45227,7 +45480,7 @@ ${c.info("Received shutdown signal. Stopping reviewer...")}`);
   await reviewer.run();
 }
 async function reviewLocalCommand(args) {
-  const { values } = parseArgs6({
+  const { values } = parseArgs7({
     args,
     options: {
       model: { type: "string" },
@@ -45270,12 +45523,12 @@ async function reviewLocalCommand(args) {
 `);
     return;
   }
-  const reviewsDir = join17(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
-  if (!existsSync17(reviewsDir)) {
+  const reviewsDir = join18(projectPath, LOCUS_CONFIG.dir, LOCUS_CONFIG.reviewsDir);
+  if (!existsSync18(reviewsDir)) {
     mkdirSync8(reviewsDir, { recursive: true });
   }
   const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
-  const reportPath = join17(reviewsDir, `review-${timestamp}.md`);
+  const reportPath = join18(reviewsDir, `review-${timestamp}.md`);
   writeFileSync8(reportPath, report, "utf-8");
   console.log(`
   ${c.success("✔")} ${c.success("Review complete!")}`);
@@ -45284,9 +45537,11 @@ async function reviewLocalCommand(args) {
 }
 // src/commands/run.ts
 init_index_node();
-import { parseArgs as parseArgs7 } from "node:util";
+import { parseArgs as parseArgs8 } from "node:util";
+init_settings_manager();
+init_utils3();
 async function runCommand(args) {
-  const { values } = parseArgs7({
+  const { values } = parseArgs8({
     args,
     options: {
       "api-key": { type: "string" },
@@ -45367,9 +45622,10 @@ ${c.info(`Received ${signal}. Stopping agent and cleaning up...`)}`);
 }
 // src/commands/telegram.ts
 init_index_node();
+init_settings_manager();
 import { spawn as spawn4 } from "node:child_process";
-import { existsSync as existsSync18 } from "node:fs";
-import { join as join18 } from "node:path";
+import { existsSync as existsSync19 } from "node:fs";
+import { join as join19 } from "node:path";
 import { createInterface as createInterface4 } from "node:readline";
 function ask2(question) {
   const rl = createInterface4({
@@ -45603,8 +45859,8 @@ function runBotCommand(projectPath) {
 `);
     process.exit(1);
   }
-  const monorepoTelegramEntry = join18(projectPath, "packages/telegram/src/index.ts");
-  const isMonorepo = existsSync18(monorepoTelegramEntry);
+  const monorepoTelegramEntry = join19(projectPath, "packages/telegram/src/index.ts");
+  const isMonorepo = existsSync19(monorepoTelegramEntry);
   let cmd;
   let args;
   if (isMonorepo) {
@@ -45733,6 +45989,7 @@ async function upgradeCommand() {
 }
 // src/commands/version.ts
 init_index_node();
+init_utils3();
 import { execSync as execSync4 } from "node:child_process";
 function getTelegramVersion() {
   try {
@@ -45759,6 +46016,7 @@ function versionCommand() {
   console.log("");
 }
 // src/cli.ts
+init_utils3();
 var isJsonStream = process.argv.includes("--json-stream");
 async function main() {
   const command = process.argv[2];
@@ -45783,6 +46041,9 @@ async function main() {
     case "exec":
       await execCommand(args);
       break;
+    case "artifacts":
+      await artifactsCommand(args);
+      break;
     case "discuss":
       await discussCommand(args);
       break;