codelantern-agent-cli 0.0.0-stage → 1.0.1

package/dist/cli.js

@@ -0,0 +1,1510 @@
+#!/usr/bin/env node
+import {
+  ALLOWED_CONFIG_KEYS,
+  CancelledError,
+  LanternAgent,
+  McpManager,
+  ProviderRegistry,
+  SkillManager,
+  addMcpServer,
+  createNewSession,
+  deleteSession,
+  exportSessionMarkdown,
+  formatErrorMessage,
+  getApiKey,
+  getConfigFilePath,
+  getLanternHomeDir,
+  getSessionsDir,
+  listConfiguredKeys,
+  listSessions,
+  loadAttachments,
+  loadConfig,
+  loadMcpConfig,
+  loadProjectInstructions,
+  loadSession,
+  maskApiKey,
+  removeApiKey,
+  removeMcpServer,
+  saveSession,
+  setApiKey,
+  setConfigValue,
+  toggleMcpServer
+} from "./chunk-PELESOCI.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 (Multi-Provider)
+`;
+  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"));
+  const providerDisplay = options.provider ? `${pc2.bold("Provider:")} ${pc2.magenta(options.provider)}  ` : "";
+  console.log(`${pc2.bold("Product:")}    Code Lantern CLI (${pc2.cyan("lantern")})  ${pc2.bold("Version:")} ${options.version}`);
+  console.log(`${providerDisplay}${pc2.bold("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 session, provider, model, and skill status`);
+      console.log(`  ${pc3.cyan("/provider [name]")}      View or switch active AI provider (gemini, openai, anthropic, openrouter)`);
+      console.log(`  ${pc3.cyan("/model [id]")}           View or switch active model`);
+      console.log(`  ${pc3.cyan("/skills [name]")}        List, enable, or disable active skills`);
+      console.log(`  ${pc3.cyan("/timing [on|off]")}      Toggle request timing diagnostics display`);
+      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("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 active request / 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 Provider:")}  ${pc3.magenta(context.provider)}`);
+      console.log(`${pc3.bold("Active Model:")}     ${pc3.green(context.model)}`);
+      console.log(`${pc3.bold("Active Skills:")}    ${context.activeSkills.length > 0 ? pc3.yellow(context.activeSkills.join(", ")) : pc3.dim("none")}`);
+      console.log(`${pc3.bold("Turns:")}            ${context.session.turns.length}`);
+      console.log(`${pc3.bold("Total Tokens:")}     ${context.session.totalUsage.totalTokens.toLocaleString()}`);
+      console.log(`${pc3.bold("Timing Logs:")}      ${context.showTiming ? pc3.green("ON") : pc3.dim("OFF")}`);
+      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 "/provider": {
+      const registry = new ProviderRegistry();
+      if (arg) {
+        const norm = arg.toLowerCase().trim();
+        if (registry.hasProvider(norm)) {
+          context.setProvider(norm);
+          const p = registry.getProvider(norm);
+          context.setModel(p.defaultModel);
+          console.log(pc3.green(`\u2713 Switched provider to '${p.displayName}' (default model: ${p.defaultModel})`));
+        } else {
+          console.log(pc3.red(`Provider '${arg}' not found. Available: ${registry.listProviders().map((p) => p.id).join(", ")}`));
+        }
+      } else {
+        const providers = registry.listProviders();
+        console.log(`
+Current provider: ${pc3.magenta(context.provider)}`);
+        console.log("Available providers:");
+        for (const p of providers) {
+          const active = p.id === context.provider ? pc3.green(" (active)") : "";
+          console.log(`  - ${pc3.bold(p.id)}: ${p.displayName} [${p.isConfigured ? pc3.green("Ready") : pc3.yellow("Needs key")}]${active}`);
+        }
+        console.log(pc3.dim(`Usage: /provider <name> (e.g. /provider openai)`));
+      }
+      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)} (Provider: ${context.provider})`);
+        console.log(pc3.dim(`Usage: /model <model-id> (or run 'lantern models list' to view available models)`));
+      }
+      return true;
+    case "/skills": {
+      const manager = new SkillManager();
+      const skills = manager.listSkills(context.workspace);
+      if (arg) {
+        const target = arg.trim();
+        const skill = manager.getSkill(target, context.workspace);
+        if (skill) {
+          const isCurrentlyActive = context.activeSkills.includes(skill.name);
+          if (isCurrentlyActive) {
+            context.setActiveSkills(context.activeSkills.filter((s) => s !== skill.name));
+            console.log(pc3.yellow(`\u2713 Deactivated skill '${skill.name}' for this session.`));
+          } else {
+            context.setActiveSkills([...context.activeSkills, skill.name]);
+            console.log(pc3.green(`\u2713 Activated skill '${skill.name}' for this session.`));
+          }
+        } else {
+          console.log(pc3.red(`Skill '${target}' not found.`));
+        }
+      } else {
+        console.log("\n" + pc3.bold(pc3.yellow("\u{1F3EE} Code Lantern Skills:")));
+        if (skills.length === 0) {
+          console.log(pc3.dim("  (No skills currently installed. Add one with: lantern skills add <path>)"));
+        } else {
+          for (const s of skills) {
+            const isSessionActive = context.activeSkills.includes(s.name);
+            const status = isSessionActive ? pc3.green("\u25CF ACTIVE") : s.enabled ? pc3.cyan("\u25CB default") : pc3.dim("\u25CB inactive");
+            console.log(`  ${status} ${pc3.bold(s.name)} - ${pc3.dim(s.description.slice(0, 50))}`);
+          }
+        }
+        console.log(pc3.dim(`
+Toggle skill for session: /skills <name>
+`));
+      }
+      return true;
+    }
+    case "/timing":
+      if (arg === "off") {
+        context.setShowTiming(false);
+        console.log(pc3.yellow("\u2713 Timing diagnostics disabled."));
+      } else if (arg === "on") {
+        context.setShowTiming(true);
+        console.log(pc3.green("\u2713 Timing diagnostics enabled."));
+      } else {
+        const next = !context.showTiming;
+        context.setShowTiming(next);
+        console.log(next ? pc3.green("\u2713 Timing diagnostics enabled.") : pc3.yellow("\u2713 Timing diagnostics disabled."));
+      }
+      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 provider = options.provider || config2.activeProvider || "gemini";
+  let model = options.model || config2.defaultModel || "gemini-3.8-flash";
+  let yolo = Boolean(options.yolo ?? config2.yolo);
+  let planMode = Boolean(options.plan);
+  let showTiming = Boolean(options.timing ?? config2.showTiming);
+  let lowLatency = Boolean(options.fast ?? config2.lowLatency);
+  let activeSkills = options.skill || config2.activeSkills || [];
+  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;
+    if (session.provider) provider = session.provider;
+    if (session.model) model = session.model;
+    if (session.activeSkills) activeSkills = session.activeSkills;
+    console.log(pc4.green(`\u2713 Resumed session: ${session.id} (${session.turns.length} turns)`));
+  } else {
+    session = createNewSession(workspace, model);
+    session.provider = provider;
+  }
+  const attachments = loadAttachments(options.attach);
+  printBanner({
+    version: "1.0.1",
+    provider,
+    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 LanternAgent();
+  await agent.initMcp();
+  const promptUI = new TerminalPrompt();
+  const slashContext = {
+    session,
+    provider,
+    model,
+    workspace,
+    yolo,
+    planMode,
+    showTiming,
+    activeSkills,
+    setProvider: (p) => {
+      provider = p;
+      session.provider = p;
+    },
+    setModel: (m) => {
+      model = m;
+      session.model = m;
+    },
+    setYolo: (y) => {
+      yolo = y;
+    },
+    setPlanMode: (p) => {
+      planMode = p;
+    },
+    setShowTiming: (t) => {
+      showTiming = t;
+    },
+    setActiveSkills: (skills) => {
+      activeSkills = skills;
+      session.activeSkills = skills;
+    }
+  };
+  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 abortController = new AbortController();
+      const onSigInt = () => {
+        abortController.abort(new CancelledError("Request cancelled by user (Ctrl+C)."));
+      };
+      process.on("SIGINT", onSigInt);
+      const context = {
+        workspace,
+        provider,
+        model,
+        yolo,
+        planMode,
+        jsonOutput: false,
+        maxSteps: config2.maxSteps || 25,
+        timeoutMs: options.timeout || config2.timeoutMs || 6e4,
+        firstTokenTimeoutMs: options.firstTokenTimeout || config2.firstTokenTimeoutMs || 3e4,
+        showTiming,
+        lowLatency,
+        activeSkills,
+        attachments,
+        signal: abortController.signal
+      };
+      try {
+        console.log("");
+        const result = await agent.runTurn(session, trimmed, context, attachments);
+        const parts = [];
+        if (result.usage.totalTokens > 0) {
+          parts.push(`Tokens: ${result.usage.totalTokens.toLocaleString()}`);
+        }
+        if (showTiming && result.timing) {
+          const ttft = result.timing.ttftMs ? `TTFT: ${result.timing.ttftMs}ms` : "";
+          const total = `Total: ${(result.timing.totalMs / 1e3).toFixed(2)}s`;
+          parts.push(`[${[provider, model, ttft, total].filter(Boolean).join(" | ")}]`);
+        }
+        if (parts.length > 0) {
+          console.log(pc4.dim(`
+[${parts.join(" | ")}]`));
+        }
+        console.log("");
+      } catch (err) {
+        if (err instanceof CancelledError || abortController.signal.aborted) {
+          console.log(pc4.yellow("\n[Cancelled by user]"));
+        } else {
+          console.error("\n" + formatErrorMessage(err) + "\n");
+        }
+      } finally {
+        process.removeListener("SIGINT", onSigInt);
+      }
+    }
+  } finally {
+    saveSession(session);
+    await agent.shutdown();
+  }
+}
+
+// src/commands/ask.ts
+import pc5 from "picocolors";
+async function askCommand(question, options) {
+  const config2 = loadConfig();
+  const workspace = options.cwd || process.cwd();
+  const provider = options.provider || config2.activeProvider || "gemini";
+  const model = options.model || config2.defaultModel || "gemini-3.8-flash";
+  const yolo = Boolean(options.yolo ?? config2.yolo);
+  const jsonOutput = Boolean(options.json);
+  const showTiming = Boolean(options.timing ?? config2.showTiming);
+  const lowLatency = Boolean(options.fast ?? config2.lowLatency);
+  const attachments = loadAttachments(options.attach);
+  const session = createNewSession(workspace, model, `Ask: ${question.slice(0, 40)}`);
+  session.provider = provider;
+  const agent = new LanternAgent();
+  await agent.initMcp();
+  const abortController = new AbortController();
+  const onSigInt = () => {
+    abortController.abort(new CancelledError("Request cancelled by user (Ctrl+C)."));
+  };
+  process.on("SIGINT", onSigInt);
+  const context = {
+    workspace,
+    provider,
+    model,
+    yolo,
+    planMode: false,
+    jsonOutput,
+    maxSteps: options.maxSteps || config2.maxSteps || 25,
+    timeoutMs: options.timeout || config2.timeoutMs || 6e4,
+    firstTokenTimeoutMs: options.firstTokenTimeout || config2.firstTokenTimeoutMs || 3e4,
+    showTiming,
+    lowLatency,
+    activeSkills: options.skill || config2.activeSkills || [],
+    attachments,
+    signal: abortController.signal
+  };
+  try {
+    const result = await agent.runTurn(session, question, context, attachments);
+    if (jsonOutput) {
+      console.log(JSON.stringify({
+        sessionId: session.id,
+        provider,
+        model,
+        question,
+        reply: result.reply,
+        toolCount: result.toolCount,
+        usage: result.usage,
+        timing: result.timing
+      }, null, 2));
+    } else {
+      const parts = [];
+      if (result.usage.totalTokens > 0) {
+        parts.push(`Tokens: ${result.usage.totalTokens.toLocaleString()}`);
+      }
+      if (showTiming && result.timing) {
+        const ttft = result.timing.ttftMs ? `TTFT: ${result.timing.ttftMs}ms` : "";
+        const total = `Total: ${(result.timing.totalMs / 1e3).toFixed(2)}s`;
+        parts.push(`[${[provider, model, ttft, total].filter(Boolean).join(" | ")}]`);
+      }
+      if (parts.length > 0) {
+        console.log(pc5.dim(`
+[${parts.join(" | ")}]`));
+      }
+    }
+  } catch (err) {
+    if (jsonOutput) {
+      console.error(JSON.stringify({ error: err.message }));
+    } else if (err instanceof CancelledError || abortController.signal.aborted) {
+      console.log(pc5.yellow("\n[Cancelled by user]"));
+    } else {
+      console.error(formatErrorMessage(err));
+    }
+    process.exit(1);
+  } finally {
+    process.removeListener("SIGINT", onSigInt);
+    await agent.shutdown();
+  }
+}
+
+// src/commands/plan.ts
+import pc6 from "picocolors";
+async function planCommand(task, options) {
+  const config2 = loadConfig();
+  const workspace = options.cwd || process.cwd();
+  const provider = options.provider || config2.activeProvider || "gemini";
+  const model = options.model || config2.defaultModel || "gemini-3.8-flash";
+  const jsonOutput = Boolean(options.json);
+  const showTiming = Boolean(options.timing ?? config2.showTiming);
+  const attachments = loadAttachments(options.attach);
+  const session = createNewSession(workspace, model, `Plan: ${task.slice(0, 40)}`);
+  session.provider = provider;
+  if (!jsonOutput) {
+    console.log(pc6.bold(pc6.yellow("\n\u{1F3EE} Code Lantern Plan Mode (Read-Only)")));
+    console.log(pc6.dim(`Inspecting workspace with ${provider} (${model})...
+`));
+  }
+  const agent = new LanternAgent();
+  await agent.initMcp();
+  const abortController = new AbortController();
+  const onSigInt = () => {
+    abortController.abort(new CancelledError("Plan cancelled by user (Ctrl+C)."));
+  };
+  process.on("SIGINT", onSigInt);
+  const context = {
+    workspace,
+    provider,
+    model,
+    yolo: false,
+    planMode: true,
+    jsonOutput,
+    maxSteps: options.maxSteps || config2.maxSteps || 25,
+    timeoutMs: options.timeout || config2.timeoutMs || 6e4,
+    firstTokenTimeoutMs: options.firstTokenTimeout || config2.firstTokenTimeoutMs || 3e4,
+    showTiming,
+    lowLatency: false,
+    activeSkills: options.skill || config2.activeSkills || [],
+    attachments,
+    signal: abortController.signal
+  };
+  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,
+        provider,
+        model,
+        task,
+        plan: result.reply,
+        usage: result.usage,
+        timing: result.timing
+      }, null, 2));
+    } else {
+      console.log(pc6.dim(`
+[Plan complete. Session ID: ${session.id}]`));
+      if (showTiming && result.timing) {
+        console.log(pc6.dim(`[Total Plan Time: ${(result.timing.totalMs / 1e3).toFixed(2)}s]`));
+      }
+    }
+  } catch (err) {
+    if (jsonOutput) {
+      console.error(JSON.stringify({ error: err.message }));
+    } else if (err instanceof CancelledError || abortController.signal.aborted) {
+      console.log(pc6.yellow("\n[Plan cancelled by user]"));
+    } else {
+      console.error(formatErrorMessage(err));
+    }
+    process.exit(1);
+  } finally {
+    process.removeListener("SIGINT", onSigInt);
+    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";
+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 config2 = loadConfig();
+  const registry = new ProviderRegistry();
+  const skillManager = new SkillManager();
+  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 activeProviderId = config2.activeProvider || "gemini";
+  const activeProvider = registry.getProvider(activeProviderId);
+  const keys = listConfiguredKeys();
+  console.log(`${pc10.green("\u2713")} Active Provider:        ${pc10.bold(activeProvider.displayName)} (${activeProviderId})`);
+  console.log(`${pc10.green("\u2713")} Active Model:           ${config2.defaultModel}`);
+  const activeKeyInfo = keys[activeProviderId];
+  if (!activeKeyInfo || !activeKeyInfo.configured) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} API Key (${activeProviderId}):   Missing!`);
+    console.log(pc10.yellow(`  \u2192 To fix: set environment variable or run 'lantern keys set ${activeProviderId}'`));
+  } else {
+    const src = activeKeyInfo.source ? `[${activeKeyInfo.source}]` : "";
+    console.log(`${pc10.green("\u2713")} API Key (${activeProviderId}):   Found (${activeKeyInfo.maskedKey}) ${src}`);
+    try {
+      const pingRes = await activeProvider.testConnection();
+      if (pingRes.success) {
+        console.log(`${pc10.green("\u2713")} Provider Auth & Ping:   Verified (${pingRes.latencyMs}ms latency)`);
+      } else {
+        issuesFound++;
+        console.log(`${pc10.red("\u2717")} Provider Auth & Ping:   Failed: ${pingRes.error}`);
+      }
+    } catch (err) {
+      issuesFound++;
+      console.log(`${pc10.red("\u2717")} Provider Auth & Ping:   Error: ${err.message}`);
+    }
+  }
+  const otherConfigured = Object.entries(keys).filter(([p, k]) => p !== activeProviderId && k.configured);
+  if (otherConfigured.length > 0) {
+    const others = otherConfigured.map(([p]) => p).join(", ");
+    console.log(`${pc10.cyan("\u2139")} Additional Providers:   Configured (${others})`);
+  }
+  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();
+    console.log(`${pc10.green("\u2713")} Config File:            ${configFile} (Timeout: ${config2.timeoutMs}ms, TTFT: ${config2.firstTokenTimeoutMs}ms)`);
+  } catch (err) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} Config File:            Invalid: ${err.message}`);
+  }
+  try {
+    const sessionsDir = getSessionsDir();
+    const count = fs2.existsSync(sessionsDir) ? fs2.readdirSync(sessionsDir).filter((f) => f.endsWith(".json")).length : 0;
+    console.log(`${pc10.green("\u2713")} Session Storage:        ${sessionsDir} (${count} stored session(s))`);
+  } catch (err) {
+    issuesFound++;
+    console.log(`${pc10.red("\u2717")} Session Storage:        Failed: ${err.message}`);
+  }
+  const installedSkills = skillManager.listSkills();
+  if (installedSkills.length > 0) {
+    const activeCount = installedSkills.filter((s) => s.enabled).length;
+    console.log(`${pc10.green("\u2713")} Skills:                 ${installedSkills.length} installed (${activeCount} active default)`);
+  } else {
+    console.log(`${pc10.cyan("\u2139")} Skills:                 None installed (add with: lantern skills add <path>)`);
+  }
+  const mcpServers = loadMcpConfig();
+  const serverCount = Object.keys(mcpServers).length;
+  if (serverCount === 0) {
+    console.log(`${pc10.cyan("\u2139")} MCP Servers:            No external MCP servers configured (optional)`);
+  } else {
+    console.log(`${pc10.green("\u2713")} MCP Servers:            ${serverCount} server(s) configured`);
+  }
+  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/commands/providersCmd.ts
+import pc12 from "picocolors";
+import readline2 from "readline";
+function promptLine(query, hide = false) {
+  const rl = readline2.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(query, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+async function providersCommand(action, target, options) {
+  const registry = new ProviderRegistry();
+  const subAction = (action || "list").toLowerCase();
+  if (subAction === "list") {
+    const providers = registry.listProviders();
+    console.log("\n" + pc12.bold(pc12.yellow("\u{1F3EE} Configured AI Providers")));
+    console.log(pc12.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(
+      pc12.bold("Provider".padEnd(16)) + pc12.bold("Status".padEnd(16)) + pc12.bold("Default Model".padEnd(30)) + pc12.bold("Key Source")
+    );
+    console.log(pc12.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 p of providers) {
+      const activeMarker = p.isActive ? pc12.green(" (active)") : "";
+      const nameCol = pc12.bold(p.name) + activeMarker;
+      const statusCol = p.isConfigured ? pc12.green("\u2713 Ready") : pc12.yellow("! Needs Key");
+      const keyInfo = getApiKey(p.id);
+      const sourceCol = keyInfo.source ? pc12.cyan(`[${keyInfo.source}]`) : pc12.dim("(missing)");
+      console.log(
+        nameCol.padEnd(p.isActive ? 25 : 16) + statusCol.padEnd(25) + p.defaultModel.padEnd(30) + sourceCol
+      );
+    }
+    console.log(pc12.dim("\nTo set default: lantern providers set-default <name>"));
+    console.log(pc12.dim("To test connection: lantern providers test [name]"));
+    console.log(pc12.dim("To add custom provider: lantern providers add <name>\n"));
+    return;
+  }
+  if (subAction === "set-default" || subAction === "use") {
+    if (!target) {
+      console.error(pc12.red("Error: Missing provider name. Usage: lantern providers set-default <name>"));
+      process.exit(1);
+    }
+    const norm = target.toLowerCase();
+    if (!registry.hasProvider(norm)) {
+      console.error(pc12.red(`Error: Provider '${target}' is not registered.`));
+      process.exit(1);
+    }
+    setConfigValue("activeProvider", norm);
+    const p = registry.getProvider(norm);
+    setConfigValue("defaultModel", p.defaultModel);
+    console.log(pc12.green(`\u2713 Set active provider to '${p.displayName}' (default model: ${p.defaultModel})`));
+    return;
+  }
+  if (subAction === "test") {
+    const targetProvider = target || loadConfig().activeProvider || "gemini";
+    const p = registry.getProvider(targetProvider);
+    console.log(`Testing connection to ${pc12.cyan(p.displayName)}...`);
+    const result = await p.testConnection();
+    if (result.success) {
+      console.log(pc12.green(`\u2713 Connection verified! Latency: ${result.latencyMs}ms`));
+      if (result.modelsCount !== void 0) {
+        console.log(pc12.dim(`  Available models discovered: ${result.modelsCount}`));
+      }
+    } else {
+      console.log(pc12.red(`\u2717 Connection failed: ${result.error}`));
+      console.log(pc12.yellow(`  Check your credentials with 'lantern keys list'`));
+      process.exit(1);
+    }
+    return;
+  }
+  if (subAction === "add") {
+    const name = target || await promptLine("Provider ID / Name: ");
+    if (!name) {
+      console.error(pc12.red("Error: Provider name is required."));
+      process.exit(1);
+    }
+    const baseUrl = options?.baseUrl || await promptLine("Base URL (e.g. http://localhost:11434/v1): ");
+    const defaultModel = options?.model || await promptLine("Default Model ID (e.g. llama3, qwen2.5): ");
+    const apiKey = options?.apiKey || await promptLine("API Key (optional, press Enter to skip): ");
+    registry.registerCustomProvider({
+      id: name.toLowerCase(),
+      name,
+      type: "custom",
+      baseUrl,
+      defaultModel: defaultModel || "default"
+    });
+    if (apiKey) {
+      setApiKey(name.toLowerCase(), apiKey);
+    }
+    console.log(pc12.green(`\u2713 Registered custom OpenAI-compatible provider '${name}'`));
+    return;
+  }
+  if (subAction === "remove" || subAction === "rm") {
+    if (!target) {
+      console.error(pc12.red("Error: Missing provider name. Usage: lantern providers remove <name>"));
+      process.exit(1);
+    }
+    const removed = registry.removeCustomProvider(target);
+    if (removed) {
+      console.log(pc12.green(`\u2713 Removed provider '${target}'`));
+    } else {
+      console.log(pc12.red(`Cannot remove built-in provider '${target}'. Only custom providers can be removed.`));
+      process.exit(1);
+    }
+    return;
+  }
+  console.error(pc12.red(`Unknown action '${action}'. Available: list, set-default, test, add, remove`));
+  process.exit(1);
+}
+
+// src/commands/modelsCmd.ts
+import pc13 from "picocolors";
+async function modelsCommand(action, modelId, options) {
+  const registry = new ProviderRegistry();
+  const config2 = loadConfig();
+  const subAction = (action || "list").toLowerCase();
+  const providerId = options?.provider || config2.activeProvider || "gemini";
+  const provider = registry.getProvider(providerId);
+  if (subAction === "list") {
+    if (!options?.json) {
+      console.log(`
+Fetching models for ${pc13.cyan(provider.displayName)}...`);
+    }
+    const models = await provider.listModels(Boolean(options?.refresh));
+    if (options?.json) {
+      console.log(JSON.stringify(models, null, 2));
+      return;
+    }
+    console.log("\n" + pc13.bold(pc13.yellow(`\u{1F3EE} Available Models for ${provider.displayName}`)));
+    console.log(pc13.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(
+      pc13.bold("Model ID".padEnd(36)) + pc13.bold("Tools".padEnd(8)) + pc13.bold("Vision".padEnd(8)) + pc13.bold("Reasoning".padEnd(12)) + pc13.bold("Context Window")
+    );
+    console.log(pc13.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"));
+    const currentModel = config2.defaultModel;
+    for (const m of models) {
+      const isCurrent = m.id === currentModel;
+      const marker = isCurrent ? pc13.green(" (active)") : "";
+      const idCol = (m.id + marker).slice(0, 34);
+      const toolsCol = m.capabilities.tools ? pc13.green("\u2713") : pc13.dim("\u2717");
+      const visionCol = m.capabilities.images ? pc13.green("\u2713") : pc13.dim("\u2717");
+      const reasoningCol = m.capabilities.reasoning ? pc13.magenta("\u2713") : pc13.dim("\u2717");
+      const ctxCol = m.contextWindow ? `${(m.contextWindow / 1e3).toFixed(0)}k` : pc13.dim("standard");
+      console.log(
+        idCol.padEnd(isCurrent ? 45 : 36) + toolsCol.padEnd(16) + visionCol.padEnd(16) + reasoningCol.padEnd(20) + ctxCol
+      );
+    }
+    console.log(pc13.dim("\nTo set active model: lantern model set <model-id>"));
+    console.log(pc13.dim(`Example: lantern model set ${models[0]?.id || "gemini-3.8-flash"}
+`));
+    return;
+  }
+  if (subAction === "set") {
+    if (!modelId) {
+      console.error(pc13.red("Error: Missing model ID. Usage: lantern model set <model-id> [--provider <provider>]"));
+      process.exit(1);
+    }
+    if (options?.provider) {
+      setConfigValue("activeProvider", options.provider.toLowerCase());
+    }
+    setConfigValue("defaultModel", modelId.trim());
+    console.log(pc13.green(`\u2713 Set active model to '${modelId.trim()}' (provider: ${provider.displayName})`));
+    return;
+  }
+  console.error(pc13.red(`Unknown action '${action}'. Available: list, set`));
+  process.exit(1);
+}
+
+// src/commands/keysCmd.ts
+import readline3 from "readline";
+import pc14 from "picocolors";
+function promptPassword(prompt) {
+  const rl = readline3.createInterface({
+    input: process.stdin,
+    output: process.stdout
+  });
+  return new Promise((resolve) => {
+    rl.question(prompt, (answer) => {
+      rl.close();
+      resolve(answer.trim());
+    });
+  });
+}
+async function keysCommand(action, provider, key) {
+  const subAction = (action || "list").toLowerCase();
+  if (subAction === "list") {
+    const keys = listConfiguredKeys();
+    console.log("\n" + pc14.bold(pc14.yellow("\u{1F3EE} Configured Provider API Keys")));
+    console.log(pc14.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"));
+    console.log(
+      pc14.bold("Provider".padEnd(16)) + pc14.bold("Source".padEnd(14)) + pc14.bold("Masked Key")
+    );
+    console.log(pc14.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 [p, info] of Object.entries(keys)) {
+      const srcText = info.source ? pc14.cyan(`[${info.source}]`) : pc14.dim("none");
+      console.log(
+        pc14.bold(p.padEnd(16)) + srcText.padEnd(22) + (info.configured ? pc14.green(info.maskedKey) : pc14.dim("(not configured)"))
+      );
+    }
+    console.log(pc14.dim("\nTo set key: lantern keys set <provider> [key]"));
+    console.log(pc14.dim("To remove key: lantern keys remove <provider>\n"));
+    return;
+  }
+  if (subAction === "set") {
+    if (!provider) {
+      console.error(pc14.red("Error: Missing provider name. Usage: lantern keys set <provider> [key]"));
+      process.exit(1);
+    }
+    let apiKey = key;
+    if (!apiKey) {
+      apiKey = await promptPassword(`Enter API key for '${provider}': `);
+    }
+    if (!apiKey) {
+      console.error(pc14.red("Error: API key cannot be empty."));
+      process.exit(1);
+    }
+    setApiKey(provider, apiKey);
+    console.log(pc14.green(`\u2713 Successfully saved encrypted API key for '${provider}' (${maskApiKey(apiKey)})`));
+    return;
+  }
+  if (subAction === "remove" || subAction === "rm") {
+    if (!provider) {
+      console.error(pc14.red("Error: Missing provider name. Usage: lantern keys remove <provider>"));
+      process.exit(1);
+    }
+    const removed = removeApiKey(provider);
+    if (removed) {
+      console.log(pc14.green(`\u2713 Removed stored key for '${provider}'`));
+    } else {
+      console.log(pc14.yellow(`No stored key found for '${provider}'. (If set in environment variables, unset the env var).`));
+    }
+    return;
+  }
+  console.error(pc14.red(`Unknown action '${action}'. Available: list, set, remove`));
+  process.exit(1);
+}
+
+// src/commands/skillsCmd.ts
+import pc15 from "picocolors";
+async function skillsCommand(action, target) {
+  const manager = new SkillManager();
+  const subAction = (action || "list").toLowerCase();
+  if (subAction === "list") {
+    const skills = manager.listSkills();
+    console.log("\n" + pc15.bold(pc15.yellow("\u{1F3EE} Installed Code Lantern Skills")));
+    console.log(pc15.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(
+      pc15.bold("Skill Name".padEnd(24)) + pc15.bold("Source".padEnd(12)) + pc15.bold("Status".padEnd(14)) + pc15.bold("Description")
+    );
+    console.log(pc15.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 (skills.length === 0) {
+      console.log(pc15.dim("No skills currently installed."));
+      console.log(pc15.dim(`
+Add a skill using: lantern skills add <local-folder-or-git-url>`));
+      console.log(pc15.dim(`User skills folder: ${manager.getUserSkillsDir()}
+`));
+      return;
+    }
+    for (const s of skills) {
+      const statusText = s.enabled ? pc15.green("\u2713 Active") : pc15.dim("Disabled");
+      const sourceText = s.source === "project" ? pc15.cyan("[project]") : pc15.blue("[user]");
+      console.log(
+        pc15.bold(s.name.padEnd(24)) + sourceText.padEnd(20) + statusText.padEnd(22) + pc15.dim(s.description.slice(0, 40))
+      );
+    }
+    console.log(pc15.dim("\nTo inspect: lantern skills show <name>"));
+    console.log(pc15.dim("To enable:  lantern skills enable <name>"));
+    console.log(pc15.dim("To disable: lantern skills disable <name>"));
+    console.log(pc15.dim("To add:     lantern skills add <folder-path-or-git-url>\n"));
+    return;
+  }
+  if (subAction === "show") {
+    if (!target) {
+      console.error(pc15.red("Error: Missing skill name. Usage: lantern skills show <name>"));
+      process.exit(1);
+    }
+    const skill = manager.getSkill(target);
+    if (!skill) {
+      console.error(pc15.red(`Error: Skill '${target}' not found.`));
+      process.exit(1);
+    }
+    console.log("\n" + pc15.bold(pc15.yellow(`\u{1F3EE} Skill: ${skill.name}`)));
+    console.log(pc15.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(`${pc15.bold("Source:")}      ${skill.source}`);
+    console.log(`${pc15.bold("Path:")}        ${skill.path}`);
+    console.log(`${pc15.bold("Status:")}      ${skill.enabled ? pc15.green("Enabled") : pc15.dim("Disabled")}`);
+    console.log(`${pc15.bold("Description:")} ${skill.description}`);
+    if (skill.references && skill.references.length > 0) {
+      console.log(`${pc15.bold("References:")}  ${skill.references.length} reference file(s) available`);
+    }
+    console.log(pc15.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("\n" + pc15.cyan("Instructions Content:"));
+    console.log(skill.content.slice(0, 1e3) + (skill.content.length > 1e3 ? "\n... (truncated)" : ""));
+    console.log("");
+    return;
+  }
+  if (subAction === "enable") {
+    if (!target) {
+      console.error(pc15.red("Error: Missing skill name. Usage: lantern skills enable <name>"));
+      process.exit(1);
+    }
+    const skill = manager.getSkill(target);
+    if (!skill) {
+      console.error(pc15.red(`Error: Skill '${target}' not found.`));
+      process.exit(1);
+    }
+    manager.enableSkill(skill.name);
+    console.log(pc15.green(`\u2713 Enabled skill '${skill.name}'`));
+    return;
+  }
+  if (subAction === "disable") {
+    if (!target) {
+      console.error(pc15.red("Error: Missing skill name. Usage: lantern skills disable <name>"));
+      process.exit(1);
+    }
+    manager.disableSkill(target);
+    console.log(pc15.yellow(`\u2713 Disabled skill '${target}'`));
+    return;
+  }
+  if (subAction === "add") {
+    if (!target) {
+      console.error(pc15.red("Error: Missing path or repository URL. Usage: lantern skills add <path-or-git-url>"));
+      process.exit(1);
+    }
+    console.log(`Adding skill from '${target}'...`);
+    const isGit = target.startsWith("http://") || target.startsWith("https://") || target.startsWith("git@");
+    const result = isGit ? manager.addSkillFromGit(target) : manager.addSkillFromPath(target);
+    if (result.success) {
+      console.log(pc15.green(`\u2713 Successfully added and enabled skill '${result.skillName}'`));
+    } else {
+      console.error(pc15.red(`\u2717 Failed to add skill: ${result.error}`));
+      process.exit(1);
+    }
+    return;
+  }
+  if (subAction === "remove" || subAction === "rm") {
+    if (!target) {
+      console.error(pc15.red("Error: Missing skill name. Usage: lantern skills remove <name>"));
+      process.exit(1);
+    }
+    const removed = manager.removeSkill(target);
+    if (removed) {
+      console.log(pc15.green(`\u2713 Removed skill '${target}'`));
+    } else {
+      console.error(pc15.red(`\u2717 Skill '${target}' not found or could not be removed.`));
+      process.exit(1);
+    }
+    return;
+  }
+  console.error(pc15.red(`Unknown action '${action}'. Available: list, show, add, enable, disable, remove`));
+  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 with multi-provider and skills support").version("1.0.1");
+program.option("-p, --provider <provider>", "AI provider to use (gemini, openai, anthropic, openrouter, or custom)", config.activeProvider || "gemini").option("-m, --model <model>", "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).option("--timeout <ms>", "Maximum total request duration in milliseconds (default: 60000)", (val) => parseInt(val, 10)).option("--first-token-timeout <ms>", "Maximum wait time for initial token in milliseconds (default: 30000)", (val) => parseInt(val, 10)).option("--timing", "Display detailed execution and latency timing diagnostics", false).option("--fast", "Enable low-latency streaming mode where supported", false).option("--skill <skills...>", "Activate specific skills by name for this run");
+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, {
+    provider: opts.provider,
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    yolo: opts.yolo,
+    json: opts.json,
+    timeout: opts.timeout,
+    firstTokenTimeout: opts.firstTokenTimeout,
+    timing: opts.timing,
+    fast: opts.fast,
+    skill: opts.skill
+  });
+});
+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, {
+    provider: opts.provider,
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    json: opts.json,
+    timeout: opts.timeout,
+    firstTokenTimeout: opts.firstTokenTimeout,
+    timing: opts.timing,
+    skill: opts.skill
+  });
+});
+program.command("resume [sessionId]").description("Continue a saved conversation session").action(async (sessionId) => {
+  const opts = program.opts();
+  await resumeCommand(sessionId, {
+    provider: opts.provider,
+    model: opts.model,
+    cwd: opts.cwd,
+    attach: opts.attach,
+    yolo: opts.yolo,
+    timeout: opts.timeout,
+    firstTokenTimeout: opts.firstTokenTimeout,
+    timing: opts.timing,
+    fast: opts.fast,
+    skill: opts.skill
+  });
+});
+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 keys, 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.command("providers [action] [target]").description("Manage AI providers (list, set-default, test, add, remove)").option("--base-url <url>", "Base URL for custom OpenAI-compatible provider").option("--api-key <key>", "API key for provider").option("--model <model>", "Default model ID for provider").action(async (action, target, cmdOpts) => {
+  await providersCommand(action, target, cmdOpts);
+});
+program.command("models [action] [modelId]").alias("model").description("List available models or switch the active model").option("-p, --provider <provider>", "Provider to inspect models for").option("-r, --refresh", "Bypass cache and query live model list", false).option("--json", "Output models list as JSON", false).action(async (action, modelId, cmdOpts) => {
+  const globalOpts = program.opts();
+  const provider = cmdOpts?.provider || globalOpts.provider;
+  const json = Boolean(cmdOpts?.json || globalOpts.json);
+  const refresh = Boolean(cmdOpts?.refresh);
+  await modelsCommand(action, modelId, { provider, refresh, json });
+});
+program.command("keys [action] [provider] [key]").description("Securely manage API keys with local AES-256-GCM encryption (list, set, remove)").action(async (action, provider, key) => {
+  await keysCommand(action, provider, key);
+});
+program.command("skills [action] [target]").description("Manage portable skills in SKILL.md format (list, show, add, enable, disable, remove)").action(async (action, target) => {
+  await skillsCommand(action, target);
+});
+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, {
+        provider: opts.provider,
+        model: opts.model,
+        cwd: opts.cwd,
+        attach: opts.attach,
+        yolo: opts.yolo,
+        json: opts.json,
+        timeout: opts.timeout,
+        firstTokenTimeout: opts.firstTokenTimeout,
+        timing: opts.timing,
+        fast: opts.fast,
+        skill: opts.skill
+      });
+      return;
+    }
+  }
+  await interactiveCommand({
+    provider: opts.provider,
+    model: opts.model,
+    cwd: opts.cwd,
+    session: opts.session,
+    attach: opts.attach,
+    yolo: opts.yolo,
+    timeout: opts.timeout,
+    firstTokenTimeout: opts.firstTokenTimeout,
+    timing: opts.timing,
+    fast: opts.fast,
+    skill: opts.skill
+  });
+});
+program.parseAsync(process.argv).catch((err) => {
+  console.error(`Error: ${err.message || err}`);
+  process.exit(1);
+});
+//# sourceMappingURL=cli.js.map