codeblog-app 2.1.4 → 2.1.7

package/package.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://json.schemastore.org/package.json",
   "name": "codeblog-app",
-  "version": "2.1.4",
+  "version": "2.1.7",
   "description": "CLI client for CodeBlog — the forum where AI writes the posts",
   "type": "module",
   "license": "MIT",
@@ -56,11 +56,11 @@
     "typescript": "5.8.2"
   },
   "optionalDependencies": {
-    "codeblog-app-darwin-arm64": "2.1.4",
-    "codeblog-app-darwin-x64": "2.1.4",
-    "codeblog-app-linux-arm64": "2.1.4",
-    "codeblog-app-linux-x64": "2.1.4",
-    "codeblog-app-windows-x64": "2.1.4"
+    "codeblog-app-darwin-arm64": "2.1.7",
+    "codeblog-app-darwin-x64": "2.1.7",
+    "codeblog-app-linux-arm64": "2.1.7",
+    "codeblog-app-linux-x64": "2.1.7",
+    "codeblog-app-windows-x64": "2.1.7"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^3.0.44",

package/src/cli/cmd/setup.ts

@@ -30,14 +30,26 @@ async function authBrowser(): Promise<boolean> {
 
 // ─── Scan & Publish ──────────────────────────────────────────────────────────
 
+async function shimmerLine(text: string, durationMs = 2000): Promise<void> {
+  const frames = ["⠋", "⠙", "⠹", "⠸", "⠼", "⠴", "⠦", "⠧", "⠇", "⠏"]
+  const startTime = Date.now()
+  let i = 0
+  while (Date.now() - startTime < durationMs) {
+    Bun.stderr.write(`\r  ${UI.Style.TEXT_HIGHLIGHT}${frames[i % frames.length]}${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}${text}${UI.Style.TEXT_NORMAL}`)
+    i++
+    await Bun.sleep(80)
+  }
+  Bun.stderr.write(`\r  ${UI.Style.TEXT_SUCCESS}✓${UI.Style.TEXT_NORMAL} ${text}\n`)
+}
+
 async function scanAndPublish(): Promise<void> {
-  // Scan
-  await UI.typeText("Scanning your local IDE sessions...", { charDelay: 15 })
-  console.log("")
+  // Scan with shimmer animation
+  const scanPromise = McpBridge.callTool("scan_sessions", { limit: 10 })
+  await shimmerLine("Scanning local IDE sessions...", 1500)
 
   let sessions: Array<{ id: string; source: string; project: string; title: string }>
   try {
-    const text = await McpBridge.callTool("scan_sessions", { limit: 10 })
+    const text = await scanPromise
     try {
       sessions = JSON.parse(text)
     } catch {
@@ -58,6 +70,7 @@ async function scanAndPublish(): Promise<void> {
 
   // Show what we found
   const sources = [...new Set(sessions.map((s) => s.source))]
+  console.log("")
   await UI.typeText(
     `Found ${sessions.length} session${sessions.length > 1 ? "s" : ""} across ${sources.length} IDE${sources.length > 1 ? "s" : ""}: ${sources.join(", ")}`,
     { charDelay: 10 },
@@ -72,65 +85,97 @@ async function scanAndPublish(): Promise<void> {
   }
   console.log("")
 
-  await UI.typeText("Let me analyze your most interesting session and create a blog post...")
-  console.log("")
+  // Analyze with shimmer — show the thinking process step by step
+  await shimmerLine("Analyzing sessions for interesting insights...", 1200)
 
-  // Dry run — preview
+  // Dry run — preview (with shimmer while waiting)
   let preview: string
   try {
-    preview = await McpBridge.callTool("auto_post", { dry_run: true })
+    const postPromise = McpBridge.callTool("auto_post", { dry_run: true })
+    await shimmerLine("Crafting a blog post from your best session...", 2000)
+    preview = await postPromise
   } catch (err) {
     UI.warn(`Could not generate post: ${err instanceof Error ? err.message : String(err)}`)
     await UI.typeText("You can try again later with /publish in the app.")
     return
   }
 
-  // Display preview
+  // Display preview with structured layout
   const cleaned = UI.cleanMarkdown(preview)
+  console.log("")
   UI.divider()
 
-  // Extract and display title/tags nicely
+  // Parse out key fields for better display
   const lines = cleaned.split("\n")
+  let title = ""
+  let tags = ""
+  let category = ""
+  const bodyLines: string[] = []
+
   for (const line of lines) {
     const trimmed = line.trim()
-    if (!trimmed) {
-      console.log("")
-      continue
+    if (!trimmed || trimmed.startsWith("DRY RUN") || trimmed === "---" || trimmed.match(/^─+$/)) continue
+    if (trimmed.startsWith("Title:")) { title = trimmed.replace("Title:", "").trim(); continue }
+    if (trimmed.startsWith("Tags:")) { tags = trimmed.replace("Tags:", "").trim(); continue }
+    if (trimmed.startsWith("Category:")) { category = trimmed.replace("Category:", "").trim(); continue }
+    if (trimmed.startsWith("Session:")) continue
+    bodyLines.push(trimmed)
+  }
+
+  // Structured display
+  if (title) {
+    console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}📝 ${title}${UI.Style.TEXT_NORMAL}`)
+    console.log("")
+  }
+  if (category || tags) {
+    const meta: string[] = []
+    if (category) meta.push(`Category: ${category}`)
+    if (tags) meta.push(`Tags: ${tags}`)
+    console.log(`  ${UI.Style.TEXT_DIM}${meta.join("  ·  ")}${UI.Style.TEXT_NORMAL}`)
+    console.log("")
+  }
+  if (bodyLines.length > 0) {
+    // Show a preview snippet (first few meaningful lines)
+    const snippet = bodyLines.slice(0, 6)
+    for (const line of snippet) {
+      console.log(`  ${line}`)
     }
-    if (trimmed.startsWith("DRY RUN")) continue
-    if (trimmed.startsWith("Title:")) {
-      console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}${trimmed}${UI.Style.TEXT_NORMAL}`)
-    } else if (trimmed.startsWith("Tags:") || trimmed.startsWith("Category:") || trimmed.startsWith("Session:")) {
-      console.log(`  ${UI.Style.TEXT_DIM}${trimmed}${UI.Style.TEXT_NORMAL}`)
-    } else if (trimmed === "---" || trimmed.match(/^─+$/)) {
-      // skip dividers in content
-    } else {
-      console.log(`  ${trimmed}`)
+    if (bodyLines.length > 6) {
+      console.log(`  ${UI.Style.TEXT_DIM}... (${bodyLines.length - 6} more lines)${UI.Style.TEXT_NORMAL}`)
     }
   }
 
   UI.divider()
 
   // Confirm publish
-  console.log(`  ${UI.Style.TEXT_DIM}Press Enter to publish this post, or Esc to skip${UI.Style.TEXT_NORMAL}`)
-  const choice = await UI.waitEnter()
+  const choice = await UI.waitEnter("Press Enter to publish, or Esc to skip")
 
   if (choice === "escape") {
     await UI.typeText("Skipped. You can publish later with /publish in the app.")
     return
   }
 
-  // Publish
-  await UI.typeText("Publishing...", { charDelay: 20 })
+  // Publish with shimmer
+  const publishPromise = McpBridge.callTool("auto_post", { dry_run: false })
+  await shimmerLine("Publishing your post...", 1500)
+
   try {
-    const result = await McpBridge.callTool("auto_post", { dry_run: false })
+    const result = await publishPromise
     console.log("")
 
-    // Extract URL from result
+    // Extract URL and details from result
     const urlMatch = result.match(/(?:URL|View at|view at)[:\s]*(https?:\/\/\S+)/i)
     if (urlMatch) {
-      UI.success(`Published! View at: ${urlMatch[1]}`)
+      UI.success("Post published successfully!")
+      console.log("")
+      if (title) {
+        console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}${title}${UI.Style.TEXT_NORMAL}`)
+      }
+      console.log(`  ${UI.Style.TEXT_HIGHLIGHT}${urlMatch[1]}${UI.Style.TEXT_NORMAL}`)
+      console.log("")
+      await UI.typeText("Your first post is live! Others can now read, comment, and vote on it.", { charDelay: 10 })
     } else {
+      UI.success("Post published!")
       // Fallback: show cleaned result
       const cleanResult = UI.cleanMarkdown(result)
       for (const line of cleanResult.split("\n").slice(0, 5)) {
@@ -164,8 +209,7 @@ async function aiConfigPrompt(): Promise<void> {
   console.log(`    ${UI.Style.TEXT_DIM}"Write a post about my React refactoring"${UI.Style.TEXT_NORMAL}`)
   console.log("")
 
-  console.log(`  ${UI.Style.TEXT_DIM}Press Enter to configure AI, or Esc to skip${UI.Style.TEXT_NORMAL}`)
-  const choice = await UI.waitEnter()
+  const choice = await UI.waitEnter("Press Enter to configure AI, or Esc to skip")
 
   if (choice === "escape") {
     console.log("")
@@ -179,21 +223,58 @@ async function aiConfigPrompt(): Promise<void> {
     return
   }
 
-  // AI config flow: URL → Key (reuses saveProvider from ai/configure.ts)
+  // AI config flow: URL → Key with ESC support
   console.log("")
-  const url = await UI.input(`  ${UI.Style.TEXT_NORMAL_BOLD}API URL${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(or press Enter to skip):${UI.Style.TEXT_NORMAL} `)
-  const key = await UI.input(`  ${UI.Style.TEXT_NORMAL_BOLD}API Key:${UI.Style.TEXT_NORMAL} `)
+  console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}API URL${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(or press Enter to skip URL, Esc to cancel):${UI.Style.TEXT_NORMAL}`)
+  const urlResult = await UI.inputWithEscape(`  ${UI.Style.TEXT_HIGHLIGHT}❯ ${UI.Style.TEXT_NORMAL}`)
+
+  if (urlResult === null) {
+    // User pressed Esc
+    console.log("")
+    await UI.typeText("Skipped AI configuration. You can configure later with /ai in the app.")
+    return
+  }
+
+  const url = urlResult.trim()
+
+  console.log(`  ${UI.Style.TEXT_NORMAL_BOLD}API Key${UI.Style.TEXT_NORMAL} ${UI.Style.TEXT_DIM}(press Esc to cancel):${UI.Style.TEXT_NORMAL}`)
+  const keyResult = await UI.inputWithEscape(`  ${UI.Style.TEXT_HIGHLIGHT}❯ ${UI.Style.TEXT_NORMAL}`)
+
+  if (keyResult === null) {
+    // User pressed Esc
+    console.log("")
+    await UI.typeText("Skipped AI configuration. You can configure later with /ai in the app.")
+    return
+  }
+
+  const key = keyResult.trim()
+
+  // Both empty → friendly skip
+  if (!url && !key) {
+    console.log("")
+    UI.info("No AI configuration provided — skipping for now.")
+    await UI.typeText("You can configure AI later with /ai in the app.")
+    return
+  }
+
+  // Key empty but URL provided → friendly skip
+  if (!key) {
+    console.log("")
+    UI.info("No API key provided — skipping AI configuration.")
+    await UI.typeText("You can configure AI later with /ai in the app.")
+    return
+  }
 
-  if (!key || key.length < 5) {
-    UI.warn("API key too short, skipping AI configuration.")
+  if (key.length < 5) {
+    UI.warn("API key seems too short, skipping AI configuration.")
     await UI.typeText("You can configure AI later with /ai in the app.")
     return
   }
 
   try {
     const { saveProvider } = await import("../../ai/configure")
-    console.log(`  ${UI.Style.TEXT_DIM}Detecting API format...${UI.Style.TEXT_NORMAL}`)
-    const result = await saveProvider(url.trim(), key.trim())
+    await shimmerLine("Detecting API format...", 1500)
+    const result = await saveProvider(url, key)
     if (result.error) {
       UI.warn(result.error)
       await UI.typeText("You can try again later with /ai in the app.")
@@ -230,8 +311,7 @@ export const SetupCommand: CommandModule = {
       await UI.typeText("You may need to sign up or log in on the website first.", { charDelay: 10 })
       console.log("")
 
-      console.log(`  ${UI.Style.TEXT_DIM}Press Enter to open browser...${UI.Style.TEXT_NORMAL}`)
-      await UI.waitEnter()
+      await UI.waitEnter("Press Enter to open browser...")
 
       authenticated = await authBrowser()
     }
@@ -252,8 +332,7 @@ export const SetupCommand: CommandModule = {
     await UI.typeText("I'll scan your local IDE sessions to find interesting coding experiences.", { charDelay: 10 })
     console.log("")
 
-    console.log(`  ${UI.Style.TEXT_DIM}Press Enter to continue...${UI.Style.TEXT_NORMAL}`)
-    const scanChoice = await UI.waitEnter()
+    const scanChoice = await UI.waitEnter("Press Enter to continue, or Esc to skip")
 
     if (scanChoice === "enter") {
       await scanAndPublish()

package/src/cli/cmd/uninstall.ts

@@ -5,6 +5,39 @@ import fs from "fs/promises"
 import path from "path"
 import os from "os"
 
+const DIM = "\x1b[90m"
+const RESET = "\x1b[0m"
+const BOLD = "\x1b[1m"
+const RED = "\x1b[91m"
+const GREEN = "\x1b[92m"
+const YELLOW = "\x1b[93m"
+const CYAN = "\x1b[36m"
+
+const W = 60  // inner width of the box
+const BAR = `${DIM}│${RESET}`
+
+/** Strip ANSI escape sequences to get visible character length */
+function visLen(s: string): number {
+  return s.replace(/\x1b\[[0-9;]*m/g, "").length
+}
+
+function line(text = "") {
+  const pad = Math.max(0, W - visLen(text) - 1)
+  console.log(`  ${BAR} ${text}${" ".repeat(pad)}${BAR}`)
+}
+
+function lineSuccess(text: string) {
+  line(`${GREEN}✓${RESET} ${text}`)
+}
+
+function lineWarn(text: string) {
+  line(`${YELLOW}⚠${RESET} ${text}`)
+}
+
+function lineInfo(text: string) {
+  line(`${DIM}${text}${RESET}`)
+}
+
 export const UninstallCommand: CommandModule = {
   command: "uninstall",
   describe: "Uninstall codeblog CLI and remove all local data",
@@ -15,35 +48,86 @@ export const UninstallCommand: CommandModule = {
       default: false,
     }),
   handler: async (args) => {
-    UI.println("")
-    UI.warn("This will uninstall codeblog from your system.")
-
-    if (!(args["keep-data"] as boolean)) {
-      UI.println(`  The following directories will be removed:`)
-      UI.println(`    ${UI.Style.TEXT_DIM}${Global.Path.config}${UI.Style.TEXT_NORMAL}`)
-      UI.println(`    ${UI.Style.TEXT_DIM}${Global.Path.data}${UI.Style.TEXT_NORMAL}`)
-      UI.println(`    ${UI.Style.TEXT_DIM}${Global.Path.cache}${UI.Style.TEXT_NORMAL}`)
-      UI.println(`    ${UI.Style.TEXT_DIM}${Global.Path.state}${UI.Style.TEXT_NORMAL}`)
+    const keepData = args["keep-data"] as boolean
+    const binPath = process.execPath
+    const pkg = await import("../../../package.json")
+
+    console.log(UI.logo())
+
+    // Top border
+    console.log(`  ${DIM}┌${"─".repeat(W)}┐${RESET}`)
+    line()
+    line(`${RED}${BOLD}Uninstall CodeBlog${RESET}  ${DIM}v${pkg.version}${RESET}`)
+    line()
+
+    // Show what will be removed
+    line(`${BOLD}The following will be removed:${RESET}`)
+    line()
+    line(`  ${DIM}Binary${RESET}    ${binPath}`)
+
+    if (!keepData) {
+      const dirs = [Global.Path.config, Global.Path.data, Global.Path.cache, Global.Path.state]
+      for (const dir of dirs) {
+        const label = dir.includes("config") ? "Config" : dir.includes("data") || dir.includes("share") ? "Data" : dir.includes("cache") ? "Cache" : "State"
+        try {
+          await fs.access(dir)
+          line(`  ${DIM}${label.padEnd(10)}${RESET}${dir}`)
+        } catch {
+          // dir doesn't exist, skip
+        }
+      }
     }
-    UI.println("")
 
-    const answer = await UI.input(`  Type "yes" to confirm: `)
+    if (os.platform() !== "win32") {
+      const rcFiles = getShellRcFiles()
+      for (const rc of rcFiles) {
+        try {
+          const content = await fs.readFile(rc, "utf-8")
+          if (content.includes("# codeblog")) {
+            line(`  ${DIM}Shell RC${RESET}  ${rc} ${DIM}(PATH entry)${RESET}`)
+          }
+        } catch {}
+      }
+    }
+
+    line()
+
+    // Separator
+    console.log(`  ${DIM}├${"─".repeat(W)}┤${RESET}`)
+    line()
+
+    // Confirm
+    line(`${BOLD}Type "yes" to confirm uninstall:${RESET}`)
+    process.stderr.write(`  ${BAR} ${DIM}> ${RESET}`)
+    const answer = await readLine()
+    // Print the line with right border after input
+    const inputDisplay = answer || ""
+    const inputLine = `${DIM}> ${RESET}${inputDisplay}`
+    const inputPad = Math.max(0, W - visLen(inputLine) - 1)
+    process.stderr.write(`\x1b[A\r  ${BAR} ${inputLine}${" ".repeat(inputPad)}${BAR}\n`)
+
     if (answer.toLowerCase() !== "yes") {
-      UI.info("Uninstall cancelled.")
+      line()
+      line(`Uninstall cancelled.`)
+      line()
+      console.log(`  ${DIM}└${"─".repeat(W)}┘${RESET}`)
+      console.log("")
       return
     }
 
-    UI.println("")
+    line()
 
+    // Execute uninstall steps
     // 1. Remove data directories
-    if (!(args["keep-data"] as boolean)) {
+    if (!keepData) {
       const dirs = [Global.Path.config, Global.Path.data, Global.Path.cache, Global.Path.state]
       for (const dir of dirs) {
         try {
+          await fs.access(dir)
           await fs.rm(dir, { recursive: true, force: true })
-          UI.success(`Removed ${dir}`)
+          lineSuccess(`Removed ${dir}`)
         } catch {
-          // ignore if already gone
+          // dir doesn't exist
         }
       }
     }
@@ -53,67 +137,109 @@ export const UninstallCommand: CommandModule = {
       await cleanShellRc()
     }
 
-    // 3. Remove the binary itself
-    const binPath = process.execPath
+    // 3. Remove the binary
     const binDir = path.dirname(binPath)
 
     if (os.platform() === "win32") {
-      // Windows: can't delete running exe, schedule removal
-      UI.info(`Binary at ${binPath}`)
-      UI.info("On Windows, please delete the binary manually after this process exits:")
-      UI.println(`  ${UI.Style.TEXT_HIGHLIGHT}del "${binPath}"${UI.Style.TEXT_NORMAL}`)
-
-      // Try to remove from PATH
+      lineInfo(`Binary at ${binPath}`)
+      lineWarn(`On Windows, delete manually after exit:`)
+      line(`  ${CYAN}del "${binPath}"${RESET}`)
       await cleanWindowsPath(binDir)
     } else {
       try {
         await fs.unlink(binPath)
-        UI.success(`Removed binary: ${binPath}`)
+        lineSuccess(`Removed ${binPath}`)
       } catch (e: any) {
         if (e.code === "EBUSY" || e.code === "ETXTBSY") {
-          // Binary is running, schedule delete via shell
           const { spawn } = await import("child_process")
           spawn("sh", ["-c", `sleep 1 && rm -f "${binPath}"`], {
             detached: true,
             stdio: "ignore",
           }).unref()
-          UI.success(`Binary will be removed: ${binPath}`)
+          lineSuccess(`Binary will be removed: ${binPath}`)
         } else {
-          UI.warn(`Could not remove binary: ${e.message}`)
-          UI.println(`  Remove it manually: ${UI.Style.TEXT_HIGHLIGHT}rm "${binPath}"${UI.Style.TEXT_NORMAL}`)
+          lineWarn(`Could not remove binary: ${e.message}`)
+          line(`  Run manually: ${CYAN}rm "${binPath}"${RESET}`)
         }
       }
     }
 
-    UI.println("")
-    UI.success("codeblog has been uninstalled. Goodbye!")
-    UI.println("")
+    line()
+
+    // Separator
+    console.log(`  ${DIM}├${"─".repeat(W)}┤${RESET}`)
+    line()
+    line(`${GREEN}${BOLD}CodeBlog has been uninstalled.${RESET} Goodbye!`)
+    line()
+
+    // Bottom border
+    console.log(`  ${DIM}└${"─".repeat(W)}┘${RESET}`)
+    console.log("")
   },
 }
 
-async function cleanShellRc() {
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+
+function readLine(): Promise<string> {
+  const stdin = process.stdin
+  return new Promise((resolve) => {
+    const wasRaw = stdin.isRaw
+    if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+
+    let buf = ""
+    const onData = (ch: Buffer) => {
+      const c = ch.toString("utf8")
+      if (c === "\u0003") {
+        if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+        stdin.removeListener("data", onData)
+        process.exit(130)
+      }
+      if (c === "\r" || c === "\n") {
+        if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+        stdin.removeListener("data", onData)
+        process.stderr.write("\n")
+        resolve(buf)
+        return
+      }
+      if (c === "\u007f" || c === "\b") {
+        if (buf.length > 0) {
+          buf = buf.slice(0, -1)
+          process.stderr.write("\b \b")
+        }
+        return
+      }
+      const clean = c.replace(/[\x00-\x1f\x7f]/g, "")
+      if (clean) {
+        buf += clean
+        process.stderr.write(clean)
+      }
+    }
+    stdin.on("data", onData)
+  })
+}
+
+function getShellRcFiles(): string[] {
   const home = os.homedir()
-  const rcFiles = [
+  return [
     path.join(home, ".zshrc"),
     path.join(home, ".bashrc"),
     path.join(home, ".profile"),
   ]
+}
 
-  for (const rc of rcFiles) {
+async function cleanShellRc() {
+  for (const rc of getShellRcFiles()) {
     try {
       const content = await fs.readFile(rc, "utf-8")
       if (!content.includes("# codeblog")) continue
 
-      // Remove the "# codeblog" line and the export PATH line that follows
       const lines = content.split("\n")
       const filtered: string[] = []
       for (let i = 0; i < lines.length; i++) {
         if (lines[i]!.trim() === "# codeblog") {
-          // Skip this line and the next export PATH line
           if (i + 1 < lines.length && lines[i + 1]!.includes("export PATH=")) {
-            i++ // skip next line too
+            i++
           }
-          // Also skip a preceding blank line if present
           if (filtered.length > 0 && filtered[filtered.length - 1]!.trim() === "") {
             filtered.pop()
           }
@@ -123,7 +249,7 @@ async function cleanShellRc() {
       }
 
       await fs.writeFile(rc, filtered.join("\n"), "utf-8")
-      UI.success(`Cleaned PATH entry from ${rc}`)
+      lineSuccess(`Cleaned PATH from ${rc}`)
     } catch {
       // file doesn't exist or not readable
     }
@@ -136,7 +262,6 @@ async function cleanWindowsPath(binDir: string) {
     const { promisify } = await import("util")
     const execAsync = promisify(exec)
 
-    // Read current user PATH
     const { stdout } = await execAsync(
       `powershell -Command "[Environment]::GetEnvironmentVariable('Path','User')"`,
     )
@@ -148,9 +273,9 @@ async function cleanWindowsPath(binDir: string) {
       await execAsync(
         `powershell -Command "[Environment]::SetEnvironmentVariable('Path','${newPath}','User')"`,
       )
-      UI.success(`Removed ${binDir} from user PATH`)
+      lineSuccess(`Removed ${binDir} from user PATH`)
     }
   } catch {
-    UI.warn("Could not clean PATH. You may need to remove it manually from System Settings.")
+    lineWarn("Could not clean PATH. Remove manually from System Settings.")
   }
 }

package/src/cli/ui.ts

@@ -72,6 +72,61 @@ export namespace UI {
     })
   }
 
+  /**
+   * Input with ESC support. Returns null if user presses Escape, otherwise the input string.
+   */
+  export async function inputWithEscape(prompt: string): Promise<string | null> {
+    const stdin = process.stdin
+    process.stderr.write(prompt)
+
+    return new Promise((resolve) => {
+      const wasRaw = stdin.isRaw
+      if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(true)
+
+      let buf = ""
+      const onData = (ch: Buffer) => {
+        const c = ch.toString("utf8")
+        if (c === "\u0003") {
+          // Ctrl+C
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.exit(130)
+        }
+        if (c === "\x1b") {
+          // Escape
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.stderr.write("\n")
+          resolve(null)
+          return
+        }
+        if (c === "\r" || c === "\n") {
+          // Enter
+          if (stdin.isTTY && stdin.setRawMode) stdin.setRawMode(wasRaw ?? false)
+          stdin.removeListener("data", onData)
+          process.stderr.write("\n")
+          resolve(buf)
+          return
+        }
+        if (c === "\u007f" || c === "\b") {
+          // Backspace
+          if (buf.length > 0) {
+            buf = buf.slice(0, -1)
+            process.stderr.write("\b \b")
+          }
+          return
+        }
+        // Regular character
+        const clean = c.replace(/[\x00-\x1f\x7f]/g, "")
+        if (clean) {
+          buf += clean
+          process.stderr.write(clean)
+        }
+      }
+      stdin.on("data", onData)
+    })
+  }
+
   export async function password(prompt: string): Promise<string> {
     const readline = require("readline")
     const rl = readline.createInterface({ input: process.stdin, output: process.stderr, terminal: true })

package/src/tui/routes/home.tsx

@@ -234,11 +234,25 @@ export function Home(props: {
       const v = aiUrl().trim()
       if (v && !v.startsWith("http")) { showMsg("URL must start with http:// or https://", theme.colors.error); return }
       setAiMode("key")
-      showMsg("Now paste your API key:", theme.colors.primary)
+      showMsg("Now paste your API key (or press Esc to cancel):", theme.colors.primary)
       return
     }
     if (aiMode() === "key") {
-      if (aiKey().trim().length < 5) { showMsg("API key too short", theme.colors.error); return }
+      const url = aiUrl().trim()
+      const key = aiKey().trim()
+      // Both empty → friendly skip
+      if (!url && !key) {
+        showMsg("No AI configuration provided — skipped. Use /ai anytime to configure.", theme.colors.warning)
+        setAiMode("")
+        return
+      }
+      // Key empty but URL provided → friendly skip
+      if (!key) {
+        showMsg("No API key provided — skipped. Use /ai anytime to configure.", theme.colors.warning)
+        setAiMode("")
+        return
+      }
+      if (key.length < 5) { showMsg("API key too short", theme.colors.error); return }
       saveAI()
       return
     }