codelantern-agent-cli 0.0.0-stage → 1.0.0

package/dist/cli.js

@@ -0,0 +1,914 @@
+#!/usr/bin/env node
+import {
+  ALLOWED_CONFIG_KEYS,
+  McpManager,
+  OrbitAgent,
+  addMcpServer,
+  createNewSession,
+  deleteSession,
+  exportSessionMarkdown,
+  formatErrorMessage,
+  getConfigFilePath,
+  getLanternHomeDir,
+  getSessionsDir,
+  listSessions,
+  loadAttachments,
+  loadConfig,
+  loadMcpConfig,
+  loadProjectInstructions,
+  loadSession,
+  removeMcpServer,
+  saveSession,
+  setConfigValue,
+  toggleMcpServer
+} from "./chunk-Y3PEOLTZ.js";
+
+// src/cli.ts
+import { Command } from "commander";
+
+// src/commands/interactive.ts
+import pc4 from "picocolors";
+
+// src/ui/prompt.ts
+import readline from "readline";
+import fs from "fs";
+import path from "path";
+import pc from "picocolors";
+function getHistoryFilePath() {
+  return path.join(getLanternHomeDir(), "history.txt");
+}
+function loadHistory() {
+  const filePath = getHistoryFilePath();
+  if (!fs.existsSync(filePath)) return [];
+  try {
+    const raw = fs.readFileSync(filePath, "utf8");
+    return raw.replace(/\r\n/g, "\n").split("\n").filter((line) => line.trim().length > 0);
+  } catch {
+    return [];
+  }
+}
+function appendHistory(line) {
+  const clean = line.trim();
+  if (!clean || clean.startsWith("/") || clean.length < 2) return;
+  const filePath = getHistoryFilePath();
+  try {
+    fs.appendFileSync(filePath, clean + "\n", { encoding: "utf8" });
+  } catch {
+  }
+}
+var TerminalPrompt = class {
+  history;
+  constructor() {
+    this.history = loadHistory();
+  }
+  async askPrompt(promptPrefix = pc.yellow("lantern> ")) {
+    const rl = readline.createInterface({
+      input: process.stdin,
+      output: process.stdout,
+      history: this.history,
+      historySize: 200,
+      prompt: promptPrefix
+    });
+    let sigintCount = 0;
+    return new Promise((resolve) => {
+      let accumulated = "";
+      let insideTripleQuotes = false;
+      rl.prompt();
+      rl.on("line", (rawLine) => {
+        sigintCount = 0;
+        const line = rawLine.replace(/\r/g, "");
+        if (!insideTripleQuotes && (line.trim().startsWith('"""') || line.trim().startsWith("```"))) {
+          insideTripleQuotes = true;
+          const content = line.trim().slice(3);
+          accumulated += content + "\n";
+          rl.setPrompt(pc.dim("... "));
+          rl.prompt();
+          return;
+        }
+        if (insideTripleQuotes) {
+          if (line.trim().endsWith('"""') || line.trim().endsWith("```")) {
+            const content = line.trim().slice(0, -3);
+            accumulated += content;
+            insideTripleQuotes = false;
+            rl.close();
+            appendHistory(accumulated.trim());
+            return resolve(accumulated.trim());
+          }
+          accumulated += line + "\n";
+          rl.prompt();
+          return;
+        }
+        if (line.endsWith("\\")) {
+          accumulated += line.slice(0, -1) + "\n";
+          rl.setPrompt(pc.dim("... "));
+          rl.prompt();
+          return;
+        }
+        accumulated += line;
+        rl.close();
+        const result = accumulated.trim();
+        if (result) {
+          appendHistory(result);
+        }
+        resolve(result);
+      });
+      rl.on("SIGINT", () => {
+        sigintCount++;
+        if (sigintCount >= 2 || insideTripleQuotes) {
+          console.log("\nExiting Code Lantern.");
+          rl.close();
+          resolve("/exit");
+        } else {
+          console.log(pc.dim("\n(Press Ctrl+C again or type /exit to quit)"));
+          accumulated = "";
+          insideTripleQuotes = false;
+          rl.setPrompt(promptPrefix);
+          rl.prompt();
+        }
+      });
+      rl.on("close", () => {
+        if (!accumulated) {
+          resolve(null);
+        }
+      });
+    });
+  }
+};
+
+// src/ui/banner.ts
+import pc2 from "picocolors";
+function printBanner(options) {
+  const logo = `
+   ____          _        _                 _                 
+  / ___|___   __| | ___  | |    __ _ _ __  | |_ ___ _ __ _ __  
+ | |   / _ \\ / _\` |/ _ \\ | |   / _\` | '_ \\ | __/ _ \\ '__| '_ \\ 
+ | |__| (_) | (_| |  __/ | |__| (_| | | | || ||  __/ |  | | | |
+  \\____\\___/ \\__,_|\\___| |_____\\__,_|_| |_(_)__\\___|_|  |_| |_|
+   \u{1F3EE} Personal AI Coding Assistant for Terminal (Gemini)
+`;
+  console.log(pc2.yellow(logo));
+  console.log(pc2.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(`${pc2.bold("Product:")}    Code Lantern CLI (${pc2.cyan("lantern")})  ${pc2.bold("Version:")} ${options.version}`);
+  console.log(`${pc2.bold("Default Model:")} ${pc2.green(options.model)}`);
+  console.log(`${pc2.bold("Workspace:")}  ${pc2.blue(options.workspace)}`);
+  const modeBadge = options.planMode ? pc2.bgBlue(pc2.white(" PLAN MODE (Read-only) ")) : options.yolo ? pc2.bgRed(pc2.white(" YOLO MODE (Auto-approve) ")) : pc2.bgGreen(pc2.black(" SAFE MODE (Approval Prompts) "));
+  console.log(`${pc2.bold("Status:")}     ${modeBadge}`);
+  console.log(pc2.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(pc2.dim(`Type your task or question. Use ${pc2.bold(pc2.yellow("/help"))} for commands, ${pc2.bold(pc2.yellow("/exit"))} to quit.`));
+  console.log(pc2.dim(`Multiline tip: End a line with '\\' or enclose in '"""' for multiline blocks.
+`));
+}
+
+// src/ui/slashCommands.ts
+import pc3 from "picocolors";
+async function handleSlashCommand(input, context) {
+  const parts = input.trim().split(/\s+/);
+  const command = parts[0].toLowerCase();
+  const arg = parts.slice(1).join(" ");
+  switch (command) {
+    case "/help":
+      console.log("\n" + pc3.bold(pc3.yellow("\u{1F3EE} Code Lantern CLI \u2014 Help & Commands")));
+      console.log(pc3.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(pc3.bold("Slash Commands:"));
+      console.log(`  ${pc3.cyan("/help")}                 Show this help overview`);
+      console.log(`  ${pc3.cyan("/clear")}                Clear the terminal screen`);
+      console.log(`  ${pc3.cyan("/status")}               Display current session, workspace, and model status`);
+      console.log(`  ${pc3.cyan("/model [name]")}         View or change current Gemini model`);
+      console.log(`  ${pc3.cyan("/plan [on|off]")}        Toggle read-only planning mode`);
+      console.log(`  ${pc3.cyan("/yolo [on|off]")}        Toggle YOLO auto-approval mode`);
+      console.log(`  ${pc3.cyan("/sessions")}             List saved local sessions`);
+      console.log(`  ${pc3.cyan("/history")}              Display recent turns in current session`);
+      console.log(`  ${pc3.cyan("/export [md|json]")}     Export current conversation transcript`);
+      console.log(`  ${pc3.cyan("/exit")} or ${pc3.cyan("/quit")}        Exit Code Lantern CLI`);
+      console.log("");
+      console.log(pc3.bold("Available Agent Tools:"));
+      console.log(`  ${pc3.yellow("read_file")}           Read file contents with line ranges`);
+      console.log(`  ${pc3.yellow("write_file")}          Create new files (requires approval in safe mode)`);
+      console.log(`  ${pc3.yellow("edit_file")}           Apply targeted patch with diff preview`);
+      console.log(`  ${pc3.yellow("list_directory")}      Inspect directories honoring .gitignore`);
+      console.log(`  ${pc3.yellow("file_search")}         Find files matching glob/pattern`);
+      console.log(`  ${pc3.yellow("grep_search")}         Search code patterns across files`);
+      console.log(`  ${pc3.yellow("project_tree")}        Generate ASCII project tree`);
+      console.log(`  ${pc3.yellow("run_command")}         Run shell commands (requires approval)`);
+      console.log(`  ${pc3.yellow("git_status")}          Inspect Git status`);
+      console.log(`  ${pc3.yellow("git_diff")}            Inspect Git working tree / staged diffs`);
+      console.log(`  ${pc3.yellow("web_search")}          Search documentation / error references`);
+      console.log("");
+      console.log(pc3.bold("Keyboard Shortcuts:"));
+      console.log(`  ${pc3.dim("Enter")}                  Submit prompt`);
+      console.log(`  ${pc3.dim("\\ + Enter")}              Continue prompt on next line (multiline)`);
+      console.log(`  ${pc3.dim('""" ... """')}            Multiline prompt block`);
+      console.log(`  ${pc3.dim("Up/Down Arrows")}         Navigate prompt history`);
+      console.log(`  ${pc3.dim("Ctrl+C")}                 Cancel current line / double-tap to exit`);
+      console.log(`  ${pc3.dim("Ctrl+D")}                 Exit session`);
+      console.log("");
+      return true;
+    case "/clear":
+      console.clear();
+      return true;
+    case "/status":
+      console.log("\n" + pc3.bold(pc3.yellow("\u{1F3EE} Code Lantern Status")));
+      console.log(pc3.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+      console.log(`${pc3.bold("Session ID:")}    ${pc3.cyan(context.session.id)}`);
+      console.log(`${pc3.bold("Workspace:")}     ${pc3.blue(context.workspace)}`);
+      console.log(`${pc3.bold("Active Model:")}  ${pc3.green(context.model)}`);
+      console.log(`${pc3.bold("Turns:")}         ${context.session.turns.length}`);
+      console.log(`${pc3.bold("Total Tokens:")}  ${context.session.totalUsage.totalTokens.toLocaleString()}`);
+      console.log(`${pc3.bold("YOLO Mode:")}     ${context.yolo ? pc3.red("ON (Auto-approve)") : pc3.green("OFF (Prompt approval)")}`);
+      console.log(`${pc3.bold("Plan Mode:")}     ${context.planMode ? pc3.blue("ON (Read-only)") : pc3.dim("OFF (Full execution)")}`);
+      console.log("");
+      return true;
+    case "/model":
+      if (arg) {
+        context.setModel(arg.trim());
+        console.log(pc3.green(`\u2713 Model changed to: ${arg.trim()}`));
+      } else {
+        console.log(`Current model: ${pc3.cyan(context.model)}`);
+        console.log(pc3.dim(`Usage: /model <model-id> (e.g. /model gemini-3.8-flash)`));
+      }
+      return true;
+    case "/plan":
+      if (arg === "off") {
+        context.setPlanMode(false);
+        console.log(pc3.green("\u2713 Plan mode disabled (execution tools enabled)."));
+      } else if (arg === "on") {
+        context.setPlanMode(true);
+        console.log(pc3.blue("\u2713 Plan mode enabled (read-only inspection)."));
+      } else {
+        const next = !context.planMode;
+        context.setPlanMode(next);
+        console.log(next ? pc3.blue("\u2713 Plan mode enabled (read-only inspection).") : pc3.green("\u2713 Plan mode disabled."));
+      }
+      return true;
+    case "/yolo":
+      if (arg === "off") {
+        context.setYolo(false);
+        console.log(pc3.green("\u2713 YOLO mode disabled (safe approval prompts active)."));
+      } else if (arg === "on") {
+        context.setYolo(true);
+        console.log(pc3.red("\u26A1 YOLO mode enabled (auto-approving edits & commands)."));
+      } else {
+        const next = !context.yolo;
+        context.setYolo(next);
+        console.log(next ? pc3.red("\u26A1 YOLO mode enabled.") : pc3.green("\u2713 Safe mode enabled."));
+      }
+      return true;
+    case "/sessions": {
+      const list = listSessions();
+      console.log("\n" + pc3.bold("Recent Sessions:"));
+      if (list.length === 0) {
+        console.log(pc3.dim("  (No saved sessions)"));
+      } else {
+        for (const s of list.slice(0, 8)) {
+          const isCurrent = s.id === context.session.id ? pc3.green(" (current)") : "";
+          console.log(`  ${pc3.cyan(s.id)} - ${s.title}${isCurrent} [${s.turnCount} turns]`);
+        }
+      }
+      console.log("");
+      return true;
+    }
+    case "/history":
+      console.log("\n" + pc3.bold("Session History:"));
+      if (context.session.turns.length === 0) {
+        console.log(pc3.dim("  (No messages yet in this session)"));
+      } else {
+        for (const t of context.session.turns) {
+          const roleBadge = t.role === "user" ? pc3.cyan("[User]") : t.role === "model" ? pc3.yellow("[Lantern]") : pc3.dim("[Tool]");
+          const preview = t.text ? t.text.slice(0, 100).replace(/\n/g, " ") : `(Tool calls: ${t.toolCalls?.map((c) => c.name).join(", ")})`;
+          console.log(`  ${roleBadge} ${preview}`);
+        }
+      }
+      console.log("");
+      return true;
+    case "/export": {
+      const format = arg.toLowerCase() === "json" ? "json" : "markdown";
+      if (format === "json") {
+        console.log("\n" + JSON.stringify(context.session, null, 2));
+      } else {
+        console.log("\n" + exportSessionMarkdown(context.session));
+      }
+      return true;
+    }
+    case "/exit":
+    case "/quit":
+      return false;
+    default:
+      console.log(pc3.yellow(`Unknown slash command '${command}'. Type ${pc3.bold("/help")} for available commands.`));
+      return true;
+  }
+}
+
+// src/commands/interactive.ts
+async function interactiveCommand(options) {
+  const config2 = loadConfig();
+  const workspace = options.cwd || process.cwd();
+  let model = options.model || config2.defaultModel || "gemini-3.8-flash";
+  let yolo = Boolean(options.yolo ?? config2.yolo);
+  let planMode = Boolean(options.plan);
+  let session;
+  if (options.session) {
+    const loaded = loadSession(options.session);
+    if (!loaded) {
+      console.error(pc4.red(`Error: Session '${options.session}' not found.`));
+      process.exit(1);
+    }
+    session = loaded;
+    console.log(pc4.green(`\u2713 Resumed session: ${session.id} (${session.turns.length} turns)`));
+  } else {
+    session = createNewSession(workspace, model);
+  }
+  const attachments = loadAttachments(options.attach);
+  printBanner({
+    version: "1.0.0",
+    model,
+    workspace,
+    yolo,
+    planMode
+  });
+  if (attachments.length > 0) {
+    console.log(pc4.cyan(`\u{1F4CE} Attached ${attachments.length} file(s): ${attachments.map((a) => a.name).join(", ")}
+`));
+  }
+  const agent = new OrbitAgent();
+  await agent.initMcp();
+  const promptUI = new TerminalPrompt();
+  const slashContext = {
+    session,
+    model,
+    workspace,
+    yolo,
+    planMode,
+    setModel: (m) => {
+      model = m;
+      session.model = m;
+    },
+    setYolo: (y) => {
+      yolo = y;
+    },
+    setPlanMode: (p) => {
+      planMode = p;
+    }
+  };
+  try {
+    while (true) {
+      const modeIndicator = planMode ? pc4.blue("[plan] ") : yolo ? pc4.red("[yolo] ") : "";
+      const promptStr = `${pc4.yellow("lantern")} ${modeIndicator}${pc4.dim("\u276F")} `;
+      const input = await promptUI.askPrompt(promptStr);
+      if (input === null || input === "/exit" || input === "/quit") {
+        console.log(pc4.dim("\nGoodbye! Session saved: " + session.id));
+        break;
+      }
+      const trimmed = input.trim();
+      if (!trimmed) {
+        continue;
+      }
+      if (trimmed.startsWith("/")) {
+        const shouldContinue = await handleSlashCommand(trimmed, slashContext);
+        if (!shouldContinue) {
+          console.log(pc4.dim("Session saved. Exiting Code Lantern."));
+          break;
+        }
+        continue;
+      }
+      const context = {
+        workspace,
+        model,
+        yolo,
+        planMode,
+        jsonOutput: false,
+        maxSteps: config2.maxSteps || 25,
+        attachments
+      };
+      try {
+        console.log("");
+        const result = await agent.runTurn(session, trimmed, context, attachments);
+        if (result.usage.totalTokens > 0) {
+          console.log(pc4.dim(`
+[Tokens: ${result.usage.totalTokens.toLocaleString()} | Total turns: ${session.turns.length}]`));
+        }
+        console.log("");
+      } catch (err) {
+        console.error("\n" + formatErrorMessage(err) + "\n");
+      }
+    }
+  } finally {
+    saveSession(session);
+    await agent.shutdown();
+  }
+}
+
+// src/commands/ask.ts
+import pc5 from "picocolors";
+async function askCommand(question, options) {
+  const workspace = options.cwd || process.cwd();
+  const model = options.model || "gemini-3.8-flash";
+  const yolo = Boolean(options.yolo);
+  const jsonOutput = Boolean(options.json);
+  const attachments = loadAttachments(options.attach);
+  const session = createNewSession(workspace, model, `Ask: ${question.slice(0, 40)}`);
+  const agent = new OrbitAgent();
+  await agent.initMcp();
+  const context = {
+    workspace,
+    model,
+    yolo,
+    planMode: false,
+    jsonOutput,
+    maxSteps: options.maxSteps || 25,
+    attachments
+  };
+  try {
+    const result = await agent.runTurn(session, question, context, attachments);
+    if (jsonOutput) {
+      console.log(JSON.stringify({
+        sessionId: session.id,
+        model,
+        question,
+        reply: result.reply,
+        toolCount: result.toolCount,
+        usage: result.usage
+      }, null, 2));
+    } else {
+      if (result.usage.totalTokens > 0) {
+        console.log(pc5.dim(`
+[Tokens: ${result.usage.totalTokens} | Tools executed: ${result.toolCount}]`));
+      }
+    }
+  } catch (err) {
+    if (jsonOutput) {
+      console.error(JSON.stringify({ error: err.message }));
+    } else {
+      console.error(formatErrorMessage(err));
+    }
+    process.exit(1);
+  } finally {
+    await agent.shutdown();
+  }
+}
+
+// src/commands/plan.ts
+import pc6 from "picocolors";
+async function planCommand(task, options) {
+  const workspace = options.cwd || process.cwd();
+  const model = options.model || "gemini-3.8-flash";
+  const jsonOutput = Boolean(options.json);
+  const attachments = loadAttachments(options.attach);
+  const session = createNewSession(workspace, model, `Plan: ${task.slice(0, 40)}`);
+  if (!jsonOutput) {
+    console.log(pc6.bold(pc6.yellow("\n\u{1F3EE} Code Lantern Plan Mode (Read-Only)")));
+    console.log(pc6.dim("Inspecting workspace and formulating step-by-step implementation plan...\n"));
+  }
+  const agent = new OrbitAgent();
+  await agent.initMcp();
+  const context = {
+    workspace,
+    model,
+    yolo: false,
+    planMode: true,
+    jsonOutput,
+    maxSteps: options.maxSteps || 25,
+    attachments
+  };
+  const planPrompt = `Please inspect the codebase as needed and generate a detailed, structured, read-only implementation plan for the following task:
+
+${task}`;
+  try {
+    const result = await agent.runTurn(session, planPrompt, context, attachments);
+    if (jsonOutput) {
+      console.log(JSON.stringify({
+        sessionId: session.id,
+        model,
+        task,
+        plan: result.reply,
+        usage: result.usage
+      }, null, 2));
+    } else {
+      console.log(pc6.dim(`
+[Plan complete. Session ID: ${session.id}]`));
+    }
+  } catch (err) {
+    if (jsonOutput) {
+      console.error(JSON.stringify({ error: err.message }));
+    } else {
+      console.error(formatErrorMessage(err));
+    }
+    process.exit(1);
+  } finally {
+    await agent.shutdown();
+  }
+}
+
+// src/commands/resume.ts
+import pc7 from "picocolors";
+async function resumeCommand(sessionId, options = {}) {
+  const sessions = listSessions();
+  if (sessions.length === 0) {
+    console.log(pc7.yellow("No previous sessions found. Starting a fresh session...\n"));
+    await interactiveCommand(options);
+    return;
+  }
+  let targetId = sessionId;
+  if (!targetId) {
+    targetId = sessions[0].id;
+    console.log(pc7.cyan(`Resuming most recent session: ${sessions[0].title} (${targetId})`));
+  } else {
+    const existing = loadSession(targetId);
+    if (!existing) {
+      console.error(pc7.red(`Error: Session '${targetId}' not found.`));
+      console.log("\nAvailable sessions:");
+      for (const s of sessions.slice(0, 5)) {
+        console.log(`  - ${pc7.cyan(s.id)} (${s.title})`);
+      }
+      process.exit(1);
+    }
+  }
+  await interactiveCommand({
+    ...options,
+    session: targetId
+  });
+}
+
+// src/commands/sessions.ts
+import pc8 from "picocolors";
+async function sessionsCommand(options) {
+  if (options.delete) {
+    const success = deleteSession(options.delete);
+    if (success) {
+      console.log(pc8.green(`\u2713 Deleted session: ${options.delete}`));
+    } else {
+      console.error(pc8.red(`\u2717 Could not find session: ${options.delete}`));
+      process.exit(1);
+    }
+    return;
+  }
+  if (options.export) {
+    const session = loadSession(options.export);
+    if (!session) {
+      console.error(pc8.red(`\u2717 Session '${options.export}' not found.`));
+      process.exit(1);
+    }
+    if (options.json) {
+      console.log(JSON.stringify(session, null, 2));
+    } else {
+      console.log(exportSessionMarkdown(session));
+    }
+    return;
+  }
+  const sessions = listSessions();
+  if (sessions.length === 0) {
+    console.log(pc8.dim("No saved Code Lantern sessions found."));
+    return;
+  }
+  if (options.json) {
+    console.log(JSON.stringify(sessions, null, 2));
+    return;
+  }
+  console.log("\n" + pc8.bold(pc8.yellow("\u{1F3EE} Saved Code Lantern Sessions")));
+  console.log(pc8.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  console.log(
+    pc8.bold("Session ID".padEnd(28)) + pc8.bold("Turns".padEnd(8)) + pc8.bold("Model".padEnd(20)) + pc8.bold("Updated".padEnd(20)) + pc8.bold("Title")
+  );
+  console.log(pc8.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  for (const s of sessions) {
+    const dateStr = new Date(s.updatedAt).toLocaleString().slice(0, 18);
+    console.log(
+      pc8.cyan(s.id.slice(0, 26).padEnd(28)) + String(s.turnCount).padEnd(8) + s.model.slice(0, 18).padEnd(20) + dateStr.padEnd(20) + pc8.dim(s.title.slice(0, 30))
+    );
+  }
+  console.log(pc8.dim("\nTo resume a session: lantern resume <session-id>"));
+  console.log(pc8.dim("To export a session: lantern sessions --export <session-id>"));
+  console.log(pc8.dim("To delete a session: lantern sessions --delete <session-id>\n"));
+}
+
+// src/commands/configCmd.ts
+import pc9 from "picocolors";
+async function configCommand(action, key, value) {
+  const configPath = getConfigFilePath();
+  if (!action || action === "list") {
+    const config2 = loadConfig();
+    console.log("\n" + pc9.bold(pc9.yellow("\u{1F3EE} Code Lantern Configuration")));
+    console.log(pc9.dim(`File: ${configPath}`));
+    console.log(pc9.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    for (const [k, v] of Object.entries(config2)) {
+      if (k === "mcpServers") {
+        const count = Object.keys(v).length;
+        console.log(`  ${pc9.cyan(k.padEnd(24))} = ${pc9.dim(`{ ${count} server(s) configured }`)}`);
+      } else {
+        console.log(`  ${pc9.cyan(k.padEnd(24))} = ${pc9.green(JSON.stringify(v))}`);
+      }
+    }
+    console.log(pc9.dim("\nUpdate setting: lantern config set <key> <value>"));
+    console.log(pc9.dim(`Supported keys: ${ALLOWED_CONFIG_KEYS.join(", ")}
+`));
+    return;
+  }
+  if (action === "path") {
+    console.log(configPath);
+    return;
+  }
+  if (action === "get") {
+    if (!key) {
+      console.error(pc9.red("Error: Missing config key. Usage: orbit config get <key>"));
+      process.exit(1);
+    }
+    const config2 = loadConfig();
+    if (!(key in config2)) {
+      console.error(pc9.red(`Error: Unknown configuration key '${key}'`));
+      process.exit(1);
+    }
+    console.log(JSON.stringify(config2[key]));
+    return;
+  }
+  if (action === "set") {
+    if (!key || value === void 0) {
+      console.error(pc9.red("Error: Missing key or value. Usage: orbit config set <key> <value>"));
+      process.exit(1);
+    }
+    const res = setConfigValue(key, value);
+    if (!res.success) {
+      console.error(pc9.red(`Error: ${res.error}`));
+      process.exit(1);
+    }
+    console.log(pc9.green(`\u2713 Set ${key} = ${value}`));
+    return;
+  }
+  console.error(pc9.red(`Error: Unknown config action '${action}'. Available: list, get, set, path`));
+  process.exit(1);
+}
+
+// src/commands/doctor.ts
+import fs2 from "fs";
+import path2 from "path";
+import { execSync } from "child_process";
+import pc10 from "picocolors";
+import { GoogleGenAI } from "@google/genai";
+async function doctorCommand() {
+  console.log("\n" + pc10.bold(pc10.yellow("\u{1F3EE} Code Lantern Doctor \u2014 Diagnostics")));
+  console.log(pc10.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  let issuesFound = 0;
+  const platformName = process.platform === "darwin" ? `macOS (${process.arch === "arm64" ? "Apple Silicon" : "Intel"})` : process.platform === "win32" ? `Windows (${process.arch})` : `${process.platform} (${process.arch})`;
+  console.log(`${pc10.green("\u2713")} Platform / OS:          ${platformName}`);
+  const nodeVer = process.version;
+  const major = parseInt(nodeVer.replace("v", "").split(".")[0], 10);
+  if (major >= 18) {
+    console.log(`${pc10.green("\u2713")} Node.js Runtime:        ${nodeVer} (compatible)`);
+  } else {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} Node.js Runtime:        ${nodeVer} (Node 18+ required)`);
+  }
+  const apiKey = process.env.GEMINI_API_KEY;
+  if (!apiKey || apiKey.trim().length === 0) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} GEMINI_API_KEY:         Missing!`);
+    console.log(pc10.yellow('  \u2192 To fix: export GEMINI_API_KEY="your-api-key" from https://aistudio.google.com/app/apikey'));
+  } else {
+    const masked = apiKey.length > 8 ? `${apiKey.slice(0, 4)}...${apiKey.slice(-4)}` : "configured";
+    console.log(`${pc10.green("\u2713")} GEMINI_API_KEY:         Found (${masked})`);
+    try {
+      const ai = new GoogleGenAI({ apiKey: apiKey.trim() });
+      const testModel = "gemini-3.8-flash";
+      await ai.models.countTokens({
+        model: testModel,
+        contents: "test"
+      });
+      console.log(`${pc10.green("\u2713")} Gemini API Auth:        Verified (contacted '${testModel}')`);
+    } catch (err) {
+      issuesFound++;
+      console.log(`${pc10.red("\u2717")} Gemini API Auth:        Failed to contact API: ${err.message}`);
+      console.log(pc10.yellow("  \u2192 Verify your API key at https://aistudio.google.com/app/apikey"));
+    }
+  }
+  try {
+    const gitVer = execSync("git --version", { stdio: "pipe" }).toString().trim();
+    console.log(`${pc10.green("\u2713")} Git CLI:                Available (${gitVer})`);
+  } catch {
+    console.log(`${pc10.yellow("!")} Git CLI:                Not found in PATH (some git tools will be unavailable)`);
+  }
+  try {
+    const configFile = getConfigFilePath();
+    const config2 = loadConfig();
+    console.log(`${pc10.green("\u2713")} Config File:            ${configFile} (Model: ${config2.defaultModel})`);
+  } catch (err) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} Config File:            Invalid config: ${err.message}`);
+  }
+  try {
+    const sessionsDir = getSessionsDir();
+    const count = fs2.readdirSync(sessionsDir).filter((f) => f.endsWith(".json")).length;
+    console.log(`${pc10.green("\u2713")} Session Storage:        ${sessionsDir} (${count} stored session(s))`);
+  } catch (err) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} Session Storage:        Failed to access: ${err.message}`);
+  }
+  const mcpServers = loadMcpConfig();
+  const serverCount = Object.keys(mcpServers).length;
+  if (serverCount === 0) {
+    console.log(`${pc10.cyan("\u2139")} MCP Configuration:      No external MCP servers configured (optional)`);
+  } else {
+    console.log(`${pc10.green("\u2713")} MCP Configuration:      ${serverCount} server(s) configured`);
+    for (const [name, s] of Object.entries(mcpServers)) {
+      const status = s.disabled ? pc10.dim("(disabled)") : pc10.green("(enabled)");
+      console.log(`    \u2022 ${name}: ${s.command} ${(s.args || []).join(" ")} ${status}`);
+    }
+  }
+  const cwd = process.cwd();
+  const instructions = loadProjectInstructions(cwd);
+  if (instructions.found) {
+    console.log(`${pc10.green("\u2713")} Project Instructions:   Found (${path2.basename(instructions.filePath || "")}) in ${cwd}`);
+  } else {
+    console.log(`${pc10.dim("\u2139")} Project Instructions:   None found in workspace (e.g. LANTERN.md, GEMINI.md)`);
+  }
+  console.log(pc10.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+  if (issuesFound === 0) {
+    console.log(pc10.bold(pc10.green("\u2728 All systems healthy! Code Lantern CLI is ready to assist.")));
+  } else {
+    console.log(pc10.bold(pc10.yellow(`\u26A0\uFE0F  Doctor found ${issuesFound} issue(s) to address before optimal use.`)));
+  }
+  console.log("");
+}
+
+// src/commands/mcpCmd.ts
+import pc11 from "picocolors";
+async function mcpCommand(action, serverName, command, args = []) {
+  const servers = loadMcpConfig();
+  if (!action || action === "list") {
+    console.log("\n" + pc11.bold(pc11.yellow("\u{1F3EE} Code Lantern MCP Servers")));
+    console.log(pc11.dim("\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500"));
+    const entries = Object.entries(servers);
+    if (entries.length === 0) {
+      console.log(pc11.dim("No MCP servers configured."));
+      console.log(pc11.dim("\nTo add a server: lantern mcp add <name> <command> [args...]"));
+      console.log(pc11.dim("Example: lantern mcp add sqlite npx -y @modelcontextprotocol/server-sqlite /path/to/db.sqlite\n"));
+      return;
+    }
+    for (const [name, s] of entries) {
+      const statusBadge = s.disabled ? pc11.red("[disabled]") : pc11.green("[enabled]");
+      console.log(`${pc11.bold(name)} ${statusBadge}`);
+      console.log(`  Command: ${pc11.cyan(s.command)} ${(s.args || []).join(" ")}`);
+      if (s.env && Object.keys(s.env).length > 0) {
+        console.log(`  Env:     ${JSON.stringify(s.env)}`);
+      }
+      console.log("");
+    }
+    return;
+  }
+  if (action === "add") {
+    if (!serverName || !command) {
+      console.error(pc11.red("Error: Missing arguments. Usage: orbit mcp add <name> <command> [args...]"));
+      process.exit(1);
+    }
+    addMcpServer(serverName, {
+      command,
+      args: args.length > 0 ? args : void 0
+    });
+    console.log(pc11.green(`\u2713 Added MCP server '${serverName}': ${command} ${args.join(" ")}`));
+    return;
+  }
+  if (action === "remove" || action === "rm") {
+    if (!serverName) {
+      console.error(pc11.red("Error: Missing server name. Usage: orbit mcp remove <name>"));
+      process.exit(1);
+    }
+    const removed = removeMcpServer(serverName);
+    if (removed) {
+      console.log(pc11.green(`\u2713 Removed MCP server '${serverName}'`));
+    } else {
+      console.error(pc11.red(`\u2717 MCP server '${serverName}' not found`));
+      process.exit(1);
+    }
+    return;
+  }
+  if (action === "disable") {
+    if (!serverName) {
+      console.error(pc11.red("Error: Missing server name. Usage: orbit mcp disable <name>"));
+      process.exit(1);
+    }
+    toggleMcpServer(serverName, true);
+    console.log(pc11.yellow(`\u2713 Disabled MCP server '${serverName}'`));
+    return;
+  }
+  if (action === "enable") {
+    if (!serverName) {
+      console.error(pc11.red("Error: Missing server name. Usage: orbit mcp enable <name>"));
+      process.exit(1);
+    }
+    toggleMcpServer(serverName, false);
+    console.log(pc11.green(`\u2713 Enabled MCP server '${serverName}'`));
+    return;
+  }
+  if (action === "test") {
+    if (!serverName) {
+      console.error(pc11.red("Error: Missing server name. Usage: orbit mcp test <name>"));
+      process.exit(1);
+    }
+    const server = servers[serverName];
+    if (!server) {
+      console.error(pc11.red(`\u2717 MCP server '${serverName}' not found in configuration`));
+      process.exit(1);
+    }
+    console.log(`Connecting to MCP server '${serverName}'...`);
+    const mgr = new McpManager();
+    try {
+      const tools = await mgr.connectServer(serverName, server);
+      console.log(pc11.green(`\u2713 Connected successfully! Exposing ${tools.length} tool(s):`));
+      for (const t of tools) {
+        console.log(`  - ${pc11.cyan(t.definition.name)}: ${t.definition.description}`);
+      }
+    } catch (err) {
+      console.error(pc11.red(`\u2717 Failed to connect to '${serverName}': ${err.message}`));
+      process.exit(1);
+    } finally {
+      await mgr.closeAll();
+    }
+    return;
+  }
+  console.error(pc11.red(`Error: Unknown action '${action}'. Available: list, add, remove, enable, disable, test`));
+  process.exit(1);
+}
+
+// src/cli.ts
+var program = new Command();
+var config = loadConfig();
+program.name("lantern").description("Code Lantern CLI \u2014 Personal AI coding assistant for the terminal powered by Google Gemini").version("1.0.0");
+program.option("-m, --model <model>", "Gemini model ID to use", config.defaultModel || "gemini-3.8-flash").option("-C, --cwd <path>", "Working directory for Code Lantern agent", process.cwd()).option("-s, --session <id>", "Resume or use a specific session ID").option("-a, --attach <files...>", "Attach one or more files/images/documents to the request").option("--yolo", "Enable YOLO mode (auto-approve file edits and shell commands)", false).option("--json", "Output results formatted as JSON", false);
+program.command("ask <question...>").description("Ask a single question or task and stream the answer").action(async (questionParts) => {
+  const opts = program.opts();
+  const question = questionParts.join(" ");
+  await askCommand(question, {
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    yolo: opts.yolo,
+    json: opts.json
+  });
+});
+program.command("plan <task...>").description("Inspect the codebase and produce a read-only implementation plan").action(async (taskParts) => {
+  const opts = program.opts();
+  const task = taskParts.join(" ");
+  await planCommand(task, {
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    json: opts.json
+  });
+});
+program.command("resume [sessionId]").description("Continue a saved conversation session").action(async (sessionId) => {
+  const opts = program.opts();
+  await resumeCommand(sessionId, {
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    yolo: opts.yolo
+  });
+});
+program.command("sessions").description("List, delete, or export saved local sessions").option("-d, --delete <id>", "Delete session by ID").option("-e, --export <id>", "Export session transcript by ID").action(async (cmdOpts) => {
+  const globalOpts = program.opts();
+  await sessionsCommand({
+    delete: cmdOpts.delete,
+    export: cmdOpts.export,
+    json: globalOpts.json
+  });
+});
+program.command("config [action] [key] [value]").description("View or update configuration (list, get, set, path)").action(async (action, key, value) => {
+  await configCommand(action, key, value);
+});
+program.command("doctor").description("Diagnose API key, configuration, environment, and MCP server health").action(async () => {
+  await doctorCommand();
+});
+program.command("mcp [action] [serverName] [command] [args...]").description("Manage configured MCP servers (list, add, remove, enable, disable, test)").allowUnknownOption().action(async (action, serverName, cmd, ...rest) => {
+  const rawArgs = rest.flat().filter((a) => typeof a === "string");
+  await mcpCommand(action, serverName, cmd, rawArgs);
+});
+program.action(async () => {
+  const opts = program.opts();
+  if (!process.stdin.isTTY) {
+    let pipedData = "";
+    process.stdin.setEncoding("utf8");
+    for await (const chunk of process.stdin) {
+      pipedData += chunk;
+    }
+    const trimmedPiped = pipedData.trim();
+    if (trimmedPiped) {
+      await askCommand(trimmedPiped, {
+        model: opts.model,
+        cwd: opts.cwd,
+        attach: opts.attach,
+        yolo: opts.yolo,
+        json: opts.json
+      });
+      return;
+    }
+  }
+  await interactiveCommand({
+    model: opts.model,
+    cwd: opts.cwd,
+    session: opts.session,
+    attach: opts.attach,
+    yolo: opts.yolo
+  });
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(`Error: ${err.message || err}`);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map