aether-code 0.33.0 → 0.33.2

package/bin/aether-code.js

@@ -28,7 +28,7 @@ import {
 import readline from "node:readline";
 import { c, errorLine, divider, setTerminalTitle } from "../src/render.js";
 
-const VERSION = "0.33.0";
+const VERSION = "0.33.2";
 
 /**
  * Try to start MCP servers from ~/.aether/mcp.json. Returns a started

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aether-code",
-  "version": "0.33.0",
+  "version": "0.33.2",
   "description": "Uncensored AI coding agent for your terminal — Claude Code alternative with MCP support. Reads code, writes files, runs commands. Drives IDA Pro, Roblox Studio, Wireshark, Blender, and any MCP server. No refusal layer.",
   "homepage": "https://trynoguard.com",
   "repository": {
@@ -25,7 +25,7 @@
   },
   "scripts": {
     "postinstall": "node scripts/postinstall.js",
-    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js src/update-check.js src/ink-input.js scripts/postinstall.js",
+    "lint": "node --check bin/aether-code.js src/agent.js src/api.js src/config.js src/render.js src/tools.js src/diff.js src/repl.js src/mcp.js src/mcp-cli.js src/mcp-registry.js src/skills.js src/update-check.js src/box-input.js src/ink-input.js scripts/postinstall.js",
     "test": "node --test \"test/**/*.test.js\"",
     "prepublishOnly": "npm run lint && npm test"
   },

package/src/box-input.js

@@ -1,132 +1,208 @@
-// Bordered single-line text input — raw-mode, cmd.exe-safe.
-//
-// Like the ask_user menu, this is NOT Ink (which ghosts in the legacy Windows
-// console). It draws a 3-line box + hint, and on every keystroke moves the
-// cursor back up (ESC[nA), clears (ESC[J), and reprints. The caret is a FAKE
-// cursor (inverse-video cell) and the real terminal cursor is hidden, so there
-// is no cursor-column math to get wrong. Long input scrolls horizontally under
-// a fixed right border.
-//
-// Returns the typed string, or EXIT_SIGNAL on Ctrl+C / Ctrl+D.
-
-import readline from "node:readline";
-import { c } from "./render.js";
-
-export const EXIT_SIGNAL = "<<aether-exit>>";
-
-const HIDE = "\x1b[?25l";
-const SHOW = "\x1b[?25h";
-const INV = (s) => `\x1b[7m${s}\x1b[27m`;
-
-export function promptBox({ history = [], placeholder = "type a message…  /help for commands" } = {}) {
-  return new Promise((resolve) => {
-    // Non-interactive (piped / tests): plain readline, no box.
-    if (!process.stdin.isTTY) {
-      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-      rl.question(c.magenta("› "), (a) => { rl.close(); resolve(a); });
-      return;
-    }
-
-    let buf = "";
-    let pos = 0;                 // caret index within buf
-    const hist = history.slice();
-    let histIdx = hist.length;   // points one past the end (current draft)
-    let draft = "";
-    let drawn = 0;
-    let lastSigint = 0;
-
-    const innerW = () => Math.max(24, Math.min(process.stdout.columns || 80, 100) - 6);
-
-    const draw = (first) => {
-      const W = innerW();
-      if (!first) process.stdout.write(`\x1b[${drawn}A`);
-      process.stdout.write("\x1b[J");
-
-      // Horizontal scroll: keep the caret within the visible window.
-      const maxVisible = W - 1;
-      const start = pos > maxVisible ? pos - maxVisible : 0;
-      const view = buf.slice(start, start + W);
-      const rel = pos - start;
-
-      let content;
-      if (buf.length === 0) {
-        const ph = placeholder.slice(0, W - 1);
-        content = INV(" ") + c.dim(ph) + " ".repeat(Math.max(0, W - 1 - ph.length));
-      } else {
-        let s = "";
-        for (let i = 0; i < W; i++) {
-          const ch = view[i] ?? " ";
-          s += i === rel ? INV(ch) : ch;
-        }
-        content = s;
-      }
-
-      const top = c.magenta("╭" + "─".repeat(W + 4) + "╮");
-      const mid = c.magenta("│") + " " + c.magenta("›") + " " + content + " " + c.magenta("│");
-      const bot = c.magenta("╰" + "─".repeat(W + 4) + "╯");
-      const hint = c.dim("  Enter send · ↑↓ history · @file for images · /help · /exit");
-
-      process.stdout.write(top + "\n" + mid + "\n" + bot + "\n" + hint + "\n");
-      drawn = 4;
-    };
-
-    const finish = (result) => {
-      process.stdin.removeListener("keypress", onKey);
-      if (process.stdin.isTTY) process.stdin.setRawMode(false);
-      process.stdin.pause();
-      process.stdout.write(`\x1b[${drawn}A\x1b[J` + SHOW);
-      // Echo the submitted line so it persists in scrollback.
-      if (result && result !== EXIT_SIGNAL && result.trim()) {
-        process.stdout.write(c.magenta("› ") + result + "\n");
-      }
-      resolve(result);
-    };
-
-    const onKey = (str, key) => {
-      if (!key) return;
-      const k = key.name;
-
-      if (k === "return" || k === "enter") return finish(buf);
-      if (key.ctrl && k === "c") {
-        const now = Date.now();
-        if (now - lastSigint < 1500 || buf.length === 0) return finish(EXIT_SIGNAL);
-        lastSigint = now;
-        buf = ""; pos = 0; draw(false);
-        return;
-      }
-      if (key.ctrl && k === "d") return finish(buf.length === 0 ? EXIT_SIGNAL : buf);
-
-      if (k === "backspace") { if (pos > 0) { buf = buf.slice(0, pos - 1) + buf.slice(pos); pos--; } }
-      else if (k === "delete") { buf = buf.slice(0, pos) + buf.slice(pos + 1); }
-      else if (k === "left") { if (pos > 0) pos--; }
-      else if (k === "right") { if (pos < buf.length) pos++; }
-      else if (k === "home" || (key.ctrl && k === "a")) pos = 0;
-      else if (k === "end" || (key.ctrl && k === "e")) pos = buf.length;
-      else if (key.ctrl && k === "u") { buf = ""; pos = 0; }
-      else if (k === "up") {
-        if (histIdx === hist.length) draft = buf;
-        if (histIdx > 0) { histIdx--; buf = hist[histIdx] ?? ""; pos = buf.length; }
-      }
-      else if (k === "down") {
-        if (histIdx < hist.length) {
-          histIdx++;
-          buf = histIdx === hist.length ? draft : (hist[histIdx] ?? "");
-          pos = buf.length;
-        }
-      }
-      else if (str && !key.ctrl && !key.meta && str >= " " && str !== "\x7f") {
-        buf = buf.slice(0, pos) + str + buf.slice(pos);
-        pos += str.length;
-      }
-      else return; // ignore unhandled keys without a redraw
-      draw(false);
-    };
-
-    process.stdout.write(HIDE);
-    readline.emitKeypressEvents(process.stdin);
-    if (process.stdin.isTTY) process.stdin.setRawMode(true);
-    process.stdin.resume();
-    process.stdin.on("keypress", onKey);
-    draw(true);
-  });
-}
+// Minimal prompt input — raw-mode, cmd.exe-safe.
+// No box/border — just a bare "> " prompt like Claude Code.
+//
+// Features:
+//   - Ctrl+V / Alt+V: paste image from clipboard
+//   - @file.png: reference images by path (parsed by agent.js)
+//   - Arrow keys, Home/End, Ctrl+A/E, Ctrl+U, history navigation
+//   - Horizontal scroll for long input
+//
+// Returns the typed string (with @temppath appended for clipboard images),
+// or EXIT_SIGNAL on Ctrl+C / Ctrl+D.
+
+import readline from "node:readline";
+import { execFileSync } from "node:child_process";
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { c } from "./render.js";
+
+export const EXIT_SIGNAL = "<<aether-exit>>";
+
+const HIDE = "\x1b[?25l";
+const SHOW = "\x1b[?25h";
+const INV = (s) => `\x1b[7m${s}\x1b[27m`;
+
+// Save clipboard image to a temp file. Returns the file path or null.
+function grabClipboardImage() {
+  const tmpFile = path.join(os.tmpdir(), `aether-paste-${Date.now()}.png`);
+
+  try {
+    if (process.platform === "win32") {
+      const script =
+        "Add-Type -AssemblyName System.Windows.Forms;" +
+        "$img=[System.Windows.Forms.Clipboard]::GetImage();" +
+        "if($img){$img.Save('" + tmpFile.replace(/'/g, "''") + "'," +
+        "[System.Drawing.Imaging.ImageFormat]::Png);'OK'}else{'NO_IMAGE'}";
+      const out = execFileSync("powershell.exe", [
+        "-NoProfile", "-NonInteractive", "-Command", script,
+      ], { timeout: 5000, encoding: "utf8", stdio: ["pipe", "pipe", "pipe"] }).trim();
+      if (out.endsWith("OK") && fs.existsSync(tmpFile)) return tmpFile;
+    } else if (process.platform === "darwin") {
+      try {
+        execFileSync("pngpaste", [tmpFile], { timeout: 3000, stdio: "pipe" });
+        if (fs.existsSync(tmpFile) && fs.statSync(tmpFile).size > 0) return tmpFile;
+      } catch { /* pngpaste not installed */ }
+    } else {
+      try {
+        const fd = fs.openSync(tmpFile, "w");
+        try {
+          execFileSync("xclip", ["-selection", "clipboard", "-t", "image/png", "-o"], {
+            timeout: 3000, stdio: ["pipe", fd, "pipe"],
+          });
+        } finally {
+          fs.closeSync(fd);
+        }
+        if (fs.existsSync(tmpFile) && fs.statSync(tmpFile).size > 0) return tmpFile;
+      } catch { /* xclip not installed */ }
+    }
+  } catch { /* any failure — fall through */ }
+
+  try { if (fs.existsSync(tmpFile)) fs.unlinkSync(tmpFile); } catch { /* ignore */ }
+  return null;
+}
+
+export function promptBox({ history = [], placeholder = "Message Aether…" } = {}) {
+  return new Promise((resolve) => {
+    if (!process.stdin.isTTY) {
+      const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+      rl.question(c.cyan("> "), (a) => { rl.close(); resolve(a); });
+      return;
+    }
+
+    let buf = "";
+    let pos = 0;
+    const hist = history.slice();
+    let histIdx = hist.length;
+    let draft = "";
+    let drawn = 0;
+    let lastSigint = 0;
+    const clipImages = [];
+
+    const termW = () => Math.max(30, (process.stdout.columns || 80) - 4);
+
+    const draw = (first) => {
+      const W = termW();
+      if (!first) process.stdout.write(`\x1b[${drawn}A`);
+      process.stdout.write("\x1b[J");
+
+      // Horizontal scroll
+      const prefix = c.cyan("> ");
+      const prefixLen = 2; // "> " visible chars
+      const maxVisible = W - prefixLen;
+      const start = pos > maxVisible ? pos - maxVisible : 0;
+      const view = buf.slice(start, start + maxVisible);
+      const rel = pos - start;
+
+      let content;
+      if (buf.length === 0 && clipImages.length === 0) {
+        content = INV(" ") + c.dim(placeholder.slice(0, maxVisible - 1));
+      } else if (buf.length === 0 && clipImages.length > 0) {
+        const tag = `[${clipImages.length} image${clipImages.length > 1 ? "s" : ""} pasted]`;
+        content = INV(" ") + c.cyan(tag);
+      } else {
+        let s = "";
+        for (let i = 0; i < maxVisible; i++) {
+          const ch = view[i] ?? " ";
+          s += i === rel ? INV(ch) : ch;
+        }
+        if (clipImages.length > 0) {
+          s += " " + c.cyan(`[+${clipImages.length} img]`);
+        }
+        content = s;
+      }
+
+      // Prompt line — bare "> " like Claude Code
+      const promptLine = prefix + content;
+
+      // Status bar — mode + shortcuts, like Claude's bottom bar
+      const imgHint = clipImages.length > 0 ? " · " + c.cyan("images queued") : "";
+      const statusBar = c.dim("  ? for help · @file for images · Alt+V paste") + imgHint;
+
+      process.stdout.write(promptLine + "\n" + statusBar + "\n");
+      drawn = 2;
+    };
+
+    const finish = (result) => {
+      process.stdin.removeListener("keypress", onKey);
+      if (process.stdin.isTTY) process.stdin.setRawMode(false);
+      process.stdin.pause();
+      process.stdout.write(`\x1b[${drawn}A\x1b[J` + SHOW);
+
+      let finalResult = result;
+      if (result !== null && result !== EXIT_SIGNAL && clipImages.length > 0) {
+        const userText = (result || "").trim();
+        const imgRefs = clipImages.map((p) => `@"${p}"`).join(" ");
+        finalResult = userText ? `${userText} ${imgRefs}` : `What is in this image? ${imgRefs}`;
+      }
+
+      if (finalResult && finalResult !== EXIT_SIGNAL) {
+        const echoText = (result || "").trim();
+        const suffix = clipImages.length > 0
+          ? c.cyan(` [+${clipImages.length} image${clipImages.length > 1 ? "s" : ""}]`)
+          : "";
+        if (echoText || clipImages.length > 0) {
+          process.stdout.write(c.cyan("> ") + (echoText || c.dim("(image)")) + suffix + "\n");
+        }
+      }
+      resolve(finalResult);
+    };
+
+    const onKey = (str, key) => {
+      if (!key) return;
+      const k = key.name;
+
+      if (k === "return" || k === "enter") return finish(buf);
+      if (key.ctrl && k === "c") {
+        const now = Date.now();
+        if (now - lastSigint < 1500 || (buf.length === 0 && clipImages.length === 0)) return finish(EXIT_SIGNAL);
+        lastSigint = now;
+        buf = ""; pos = 0; clipImages.length = 0; draw(false);
+        return;
+      }
+      if (key.ctrl && k === "d") return finish(buf.length === 0 ? EXIT_SIGNAL : buf);
+
+      // Alt+V or Ctrl+V: paste image from clipboard
+      if ((key.meta && k === "v") || (key.ctrl && k === "v")) {
+        const imgPath = grabClipboardImage();
+        if (imgPath) {
+          clipImages.push(imgPath);
+        }
+        draw(false);
+        return;
+      }
+
+      if (k === "backspace") { if (pos > 0) { buf = buf.slice(0, pos - 1) + buf.slice(pos); pos--; } }
+      else if (k === "delete") { buf = buf.slice(0, pos) + buf.slice(pos + 1); }
+      else if (k === "left") { if (pos > 0) pos--; }
+      else if (k === "right") { if (pos < buf.length) pos++; }
+      else if (k === "home" || (key.ctrl && k === "a")) pos = 0;
+      else if (k === "end" || (key.ctrl && k === "e")) pos = buf.length;
+      else if (key.ctrl && k === "u") { buf = ""; pos = 0; }
+      else if (k === "up") {
+        if (histIdx === hist.length) draft = buf;
+        if (histIdx > 0) { histIdx--; buf = hist[histIdx] ?? ""; pos = buf.length; }
+      }
+      else if (k === "down") {
+        if (histIdx < hist.length) {
+          histIdx++;
+          buf = histIdx === hist.length ? draft : (hist[histIdx] ?? "");
+          pos = buf.length;
+        }
+      }
+      else if (str && !key.ctrl && !key.meta && str >= " " && str !== "\x7f") {
+        buf = buf.slice(0, pos) + str + buf.slice(pos);
+        pos += str.length;
+      }
+      else return;
+      draw(false);
+    };
+
+    process.stdout.write(HIDE);
+    readline.emitKeypressEvents(process.stdin);
+    if (process.stdin.isTTY) process.stdin.setRawMode(true);
+    process.stdin.resume();
+    process.stdin.on("keypress", onKey);
+    draw(true);
+  });
+}

package/src/repl.js

@@ -1,291 +1,249 @@
-// Interactive REPL — Claude-CLI-style. Launched when `aether-code` is run
-// without a task argument.
-//
-// Behaviors:
-//   - Banner on startup (version, model, balance, cwd, mode)
-//   - Persistent message history across prompts within the session
-//   - Slash commands: /help, /exit, /clear, /balance, /cwd, /yes, /turns
-//   - Bottom status line is rendered after each turn
-//   - Ctrl+C: first press cancels in-progress turn, second press exits
-
-import path from "node:path";
-import { runAgent } from "./agent.js";
-import { fetchBalance, AetherError } from "./api.js";
-import { runSetup } from "./setup.js";
-import { c, errorLine, boxLines, sideBySide } from "./render.js";
-import { checkForUpdate } from "./update-check.js";
-import { promptBox, EXIT_SIGNAL } from "./box-input.js";
-
-const VERSION = "0.33.0";
-const MODEL_NAME = "Aether Core";
-
-// /model aliases → { id, name }. id=null = server default (gemma / Aether Core).
-// Premium models are gated SERVER-SIDE: if you haven't purchased credits, the
-// server transparently uses Core instead — selecting one here can't bypass that.
-const MODEL_ALIASES = {
-  core: { id: null, name: "Aether Core" },
-  gemma: { id: null, name: "Aether Core" },
-  ultra: { id: "claude-opus-4-6", name: "Aether Ultra" },
-  opus: { id: "claude-opus-4-6", name: "Aether Ultra" },
-};
-
-const SHORTCUTS = `
-  ${c.cyan("/help")}      Show this help
-  ${c.cyan("/exit")}      Exit (or Ctrl+C twice)
-  ${c.cyan("/clear")}     Clear conversation history (start fresh)
-  ${c.cyan("/balance")}   Refresh and show credit balance
-  ${c.cyan("/cwd")} ${c.gray("[path]")}    Show or change working directory
-  ${c.cyan("/yes")}       Toggle auto-approve mode (skip y/N prompts)
-  ${c.cyan("/turns")} ${c.gray("<n>")}     Set max turns per prompt (default 25)
-  ${c.cyan("/model")} ${c.gray("[core|ultra]")}  Show or switch model (ultra=Opus — premium)
-
-${c.gray("Anything else is sent to the agent as your next message.")}
-${c.gray("Conversation history is kept across messages until you /clear.")}
-`;
-
-export async function runRepl({ cwd: initialCwd, autoYes: initialAutoYes, unsafePaths: initialUnsafePaths, maxTurns: initialMaxTurns, model: initialModel = null, mcpManager = null }) {
-  const initialAlias = Object.values(MODEL_ALIASES).find((a) => a.id === initialModel);
-  const state = {
-    cwd: initialCwd,
-    autoYes: !!initialAutoYes,
-    unsafePaths: !!initialUnsafePaths,
-    maxTurns: initialMaxTurns ?? 25,
-    model: initialModel ?? null,
-    modelName: initialAlias?.name ?? MODEL_NAME,
-    messages: [], // accumulates across turns
-    balance: null,
-    sessionCredits: 0,
-    sessionIn: 0,
-    sessionOut: 0,
-  };
-
-  // Kick off the npm update check concurrently with the balance fetch so it
-  // adds no startup latency; the nudge (if any) prints just under the banner.
-  const updatePromise = checkForUpdate().catch(() => null);
-
-  // Free balance check up front. If no key configured, walk through first-time
-  // setup flow (open browser → paste key → verify → save).
-  let needsSetup = false;
-  try {
-    const me = await fetchBalance();
-    state.balance = me.balance;
-    state.plan = me.plan || "FREE";
-  } catch (err) {
-    if (err instanceof AetherError && (err.code === "NO_API_KEY" || err.status === 401)) {
-      needsSetup = true;
-    } else {
-      // Transient network or other — surface but don't block
-      console.log(c.gray(`(could not fetch balance: ${err.message})`));
-    }
-  }
-
-  if (needsSetup) {
-    const ok = await runSetup();
-    if (!ok) {
-      console.log(c.gray("Aborting — no valid API key."));
-      process.exit(1);
-    }
-    // Re-fetch balance now that the key is saved
-    try {
-      const me = await fetchBalance();
-      state.balance = me.balance;
-      state.plan = me.plan || "FREE";
-    } catch { /* tolerate — banner just won't show balance */ }
-  }
-
-  printBanner(state);
-  const updateNudge = await updatePromise;
-  if (updateNudge) console.log(updateNudge + "\n");
-
-  // Input: a bordered raw-mode box (box-input.js) — cmd.exe-safe and identical
-  // everywhere. (Ink's live redraw ghosts in the legacy Windows console, so we
-  // don't use it.) Each prompt is independent; the tool y/N prompts and the
-  // ask_user menu run BETWEEN prompts in raw mode too, so nothing overlaps.
-  const inputHistory = [];
-
-  while (true) {
-    const raw = await promptBox({ history: inputHistory });
-    if (raw === EXIT_SIGNAL) { console.log(c.gray("bye.")); return; }
-    const line = (raw ?? "").trim();
-    if (!line) continue;
-
-    // promptBox already echoes "› <line>" on submit, so no echo needed here.
-    inputHistory.push(line);
-
-    // Slash command?
-    if (line.startsWith("/") || line === "?") {
-      const handled = await handleSlash(line, state);
-      if (handled === "exit") return;
-      printStatusLine(state);
-      continue;
-    }
-
-    // Otherwise — send as a message to the agent
-    const result = await runAgent({
-      initialPrompt: line,
-      priorMessages: state.messages.length > 0 ? state.messages : undefined,
-      cwd: state.cwd,
-      autoYes: state.autoYes,
-      unsafePaths: state.unsafePaths,
-      model: state.model,
-      maxTurns: state.maxTurns,
-      mcpManager,
-    });
-
-    state.sessionCredits += result.totalCredits ?? 0;
-    state.sessionIn += result.totalIn ?? 0;
-    state.sessionOut += result.totalOut ?? 0;
-    if (typeof result.balance === "number") state.balance = result.balance;
-    if (result.messages) state.messages = result.messages;
-
-    if (!result.ok && result.error) {
-      console.log("\n" + errorLine(result.error.message || String(result.error)));
-      // Don't kill the session on a single error — surface it and continue.
-    }
-
-    printStatusLine(state);
-  }
-}
-
-/* ───────── slash commands ───────── */
-
-async function handleSlash(line, state) {
-  const [cmd, ...rest] = line.replace(/^\//, "").split(/\s+/);
-  const arg = rest.join(" ").trim();
-
-  switch ((cmd || "").toLowerCase()) {
-    case "":
-    case "help":
-    case "?":
-      console.log(SHORTCUTS);
-      break;
-    case "exit":
-    case "quit":
-    case "q":
-      console.log(c.gray("bye."));
-      return "exit";
-    case "clear":
-      state.messages = [];
-      state.sessionCredits = 0;
-      state.sessionIn = 0;
-      state.sessionOut = 0;
-      console.log(c.gray("Conversation cleared."));
-      break;
-    case "balance": {
-      try {
-        const me = await fetchBalance();
-        state.balance = me.balance;
-        state.plan = me.plan || "FREE";
-        console.log(
-          c.cyan(`balance: ${me.balance.toLocaleString()} credits`) +
-            c.gray(` · plan: ${me.plan || "FREE"} (${me.planCredits ?? 0} plan + ${me.topupCredits ?? 0} topup)`),
-        );
-      } catch (err) {
-        console.log(errorLine(err.message || String(err)));
-      }
-      break;
-    }
-    case "cwd":
-      if (arg) {
-        const next = path.resolve(arg);
-        try {
-          process.chdir(next);
-          state.cwd = next;
-          console.log(c.gray(`cwd → ${state.cwd}`));
-        } catch (err) {
-          console.log(errorLine(err.message));
-        }
-      } else {
-        console.log(c.gray(`cwd: ${state.cwd}`));
-      }
-      break;
-    case "yes":
-      state.autoYes = !state.autoYes;
-      console.log(c.gray(`auto-yes: ${state.autoYes ? "on (writes/shells will skip y/N)" : "off"}`));
-      break;
-    case "turns": {
-      const n = parseInt(arg, 10);
-      if (!Number.isFinite(n) || n < 1 || n > 200) {
-        console.log(errorLine(`/turns expects 1..200, got "${arg}"`));
-      } else {
-        state.maxTurns = n;
-        console.log(c.gray(`max turns: ${state.maxTurns}`));
-      }
-      break;
-    }
-    case "model": {
-      const key = (arg || "").trim().toLowerCase();
-      if (!key) {
-        console.log(c.gray(`model: ${state.modelName}`));
-        console.log(c.gray("switch with /model core | ultra   (ultra=Opus — premium, need credits)"));
-      } else if (MODEL_ALIASES[key]) {
-        state.model = MODEL_ALIASES[key].id;
-        state.modelName = MODEL_ALIASES[key].name;
-        const premium = state.model !== null;
-        console.log(
-          c.gray(`model → ${c.cyan(state.modelName)}`) +
-            (premium ? c.gray("  (premium — needs purchased credits, else falls back to Core)") : ""),
-        );
-      } else {
-        console.log(errorLine(`Unknown model "${key}". Try: core, ultra`));
-      }
-      break;
-    }
-    default:
-      console.log(errorLine(`Unknown command: /${cmd}. Type ${c.cyan("/help")} for shortcuts.`));
-  }
-  return null;
-}
-
-/* ───────── banner + status ───────── */
-
-const visLen = (s) => s.replace(/\x1b\[[0-9;]*m/g, "").length;
-const shortenPath = (p, max) => (p.length <= max ? p : "..." + p.slice(p.length - max + 3));
-
-// Short, hand-curated highlights shown in the "What's new" box. Update with
-// notable releases — keep it to ~3 lines so it balances the banner height.
-const WHATS_NEW = [
-  "Image support — @file.png in your prompt",
-  "Live token counter + turn stats",
-  "Enhanced spinner with mm:ss timing",
-];
-
-function printBanner(state) {
-  const mode = state.autoYes ? (state.unsafePaths ? "skip-permissions" : "auto-yes") : "review mode";
-  const credits = state.balance != null ? `${state.balance.toLocaleString()} credits` : "";
-  const left = boxLines(
-    [
-      c.bold(c.magenta("aether")) + c.gray("  ·  ") + c.bold(state.modelName) + c.gray("   v" + VERSION),
-      c.gray("uncensored AI coding agent"),
-      c.gray((credits ? credits + " · " : "") + mode),
-      c.gray(shortenPath(state.cwd, 52)),
-    ],
-    { color: c.magenta, padX: 2 },
-  );
-  const right = boxLines(
-    [c.bold(c.cyan("What's new")), ...WHATS_NEW.map((s) => c.gray("• " + s))],
-    { color: c.cyan, padX: 2 },
-  );
-
-  console.log("");
-  const cols = process.stdout.columns || 80;
-  // Only place the two boxes side by side when there's room; otherwise the
-  // banner alone (narrow terminals would wrap and tear the second box).
-  if (cols >= visLen(left[0]) + visLen(right[0]) + 4) {
-    console.log(sideBySide(left, right, 3));
-  } else {
-    console.log(left.join("\n"));
-  }
-  console.log("");
-}
-
-function printStatusLine(state) {
-  const parts = [];
-  parts.push(c.gray(`session: ${state.sessionCredits} cr · ${state.sessionIn}→${state.sessionOut} tokens`));
-  if (state.balance != null) parts.push(c.gray(`balance: ${state.balance.toLocaleString()}`));
-  if (state.messages.length > 0) {
-    parts.push(c.gray(`history: ${state.messages.length} msg${state.messages.length === 1 ? "" : "s"}`));
-  }
-  parts.push(c.cyan(state.autoYes ? "auto-yes" : "review"));
-  console.log(c.dim(parts.join("  ·  ")));
-}
+// Interactive REPL — Claude-CLI-style. Launched when `aether-code` is run
+// without a task argument.
+
+import path from "node:path";
+import { runAgent } from "./agent.js";
+import { fetchBalance, AetherError } from "./api.js";
+import { runSetup } from "./setup.js";
+import { c, errorLine } from "./render.js";
+import { autoUpdate } from "./update-check.js";
+import { promptBox, EXIT_SIGNAL } from "./box-input.js";
+
+const VERSION = "0.33.2";
+const MODEL_NAME = "Aether Core";
+
+const MODEL_ALIASES = {
+  core: { id: null, name: "Aether Core" },
+  gemma: { id: null, name: "Aether Core" },
+  ultra: { id: "claude-opus-4-6", name: "Aether Ultra" },
+  opus: { id: "claude-opus-4-6", name: "Aether Ultra" },
+};
+
+const SHORTCUTS = `
+  ${c.cyan("/help")}      Show this help
+  ${c.cyan("/exit")}      Exit (or Ctrl+C twice)
+  ${c.cyan("/clear")}     Clear conversation history (start fresh)
+  ${c.cyan("/balance")}   Refresh and show credit balance
+  ${c.cyan("/cwd")} ${c.gray("[path]")}    Show or change working directory
+  ${c.cyan("/yes")}       Toggle auto-approve mode (skip y/N prompts)
+  ${c.cyan("/turns")} ${c.gray("<n>")}     Set max turns per prompt (default 25)
+  ${c.cyan("/model")} ${c.gray("[core|ultra]")}  Show or switch model (ultra=Opus — premium)
+
+${c.gray("Anything else is sent to the agent as your next message.")}
+${c.gray("Conversation history is kept across messages until you /clear.")}
+`;
+
+export async function runRepl({ cwd: initialCwd, autoYes: initialAutoYes, unsafePaths: initialUnsafePaths, maxTurns: initialMaxTurns, model: initialModel = null, mcpManager = null }) {
+  const initialAlias = Object.values(MODEL_ALIASES).find((a) => a.id === initialModel);
+  const state = {
+    cwd: initialCwd,
+    autoYes: !!initialAutoYes,
+    unsafePaths: !!initialUnsafePaths,
+    maxTurns: initialMaxTurns ?? 25,
+    model: initialModel ?? null,
+    modelName: initialAlias?.name ?? MODEL_NAME,
+    messages: [],
+    balance: null,
+    sessionCredits: 0,
+    sessionIn: 0,
+    sessionOut: 0,
+  };
+
+  // Auto-update + balance fetch in parallel — zero startup latency added.
+  const updatePromise = autoUpdate().catch(() => null);
+
+  let needsSetup = false;
+  try {
+    const me = await fetchBalance();
+    state.balance = me.balance;
+    state.plan = me.plan || "FREE";
+  } catch (err) {
+    if (err instanceof AetherError && (err.code === "NO_API_KEY" || err.status === 401)) {
+      needsSetup = true;
+    } else {
+      console.log(c.gray(`(could not fetch balance: ${err.message})`));
+    }
+  }
+
+  if (needsSetup) {
+    const ok = await runSetup();
+    if (!ok) {
+      console.log(c.gray("Aborting — no valid API key."));
+      process.exit(1);
+    }
+    try {
+      const me = await fetchBalance();
+      state.balance = me.balance;
+      state.plan = me.plan || "FREE";
+    } catch { /* tolerate */ }
+  }
+
+  printBanner(state);
+  const updateMsg = await updatePromise;
+  if (updateMsg) console.log(updateMsg);
+  console.log("");
+
+  const inputHistory = [];
+
+  while (true) {
+    const raw = await promptBox({ history: inputHistory });
+    if (raw === EXIT_SIGNAL) { console.log(c.gray("bye.")); return; }
+    const line = (raw ?? "").trim();
+    if (!line) continue;
+
+    inputHistory.push(line);
+
+    if (line.startsWith("/") || line === "?") {
+      const handled = await handleSlash(line, state);
+      if (handled === "exit") return;
+      printStatusLine(state);
+      continue;
+    }
+
+    const result = await runAgent({
+      initialPrompt: line,
+      priorMessages: state.messages.length > 0 ? state.messages : undefined,
+      cwd: state.cwd,
+      autoYes: state.autoYes,
+      unsafePaths: state.unsafePaths,
+      model: state.model,
+      maxTurns: state.maxTurns,
+      mcpManager,
+    });
+
+    state.sessionCredits += result.totalCredits ?? 0;
+    state.sessionIn += result.totalIn ?? 0;
+    state.sessionOut += result.totalOut ?? 0;
+    if (typeof result.balance === "number") state.balance = result.balance;
+    if (result.messages) state.messages = result.messages;
+
+    if (!result.ok && result.error) {
+      console.log("\n" + errorLine(result.error.message || String(result.error)));
+    }
+
+    printStatusLine(state);
+  }
+}
+
+/* ───────── slash commands ───────── */
+
+async function handleSlash(line, state) {
+  const [cmd, ...rest] = line.replace(/^\//, "").split(/\s+/);
+  const arg = rest.join(" ").trim();
+
+  switch ((cmd || "").toLowerCase()) {
+    case "":
+    case "help":
+    case "?":
+      console.log(SHORTCUTS);
+      break;
+    case "exit":
+    case "quit":
+    case "q":
+      console.log(c.gray("bye."));
+      return "exit";
+    case "clear":
+      state.messages = [];
+      state.sessionCredits = 0;
+      state.sessionIn = 0;
+      state.sessionOut = 0;
+      console.log(c.gray("Conversation cleared."));
+      break;
+    case "balance": {
+      try {
+        const me = await fetchBalance();
+        state.balance = me.balance;
+        state.plan = me.plan || "FREE";
+        console.log(
+          c.cyan(`balance: ${me.balance.toLocaleString()} credits`) +
+            c.gray(` · plan: ${me.plan || "FREE"} (${me.planCredits ?? 0} plan + ${me.topupCredits ?? 0} topup)`),
+        );
+      } catch (err) {
+        console.log(errorLine(err.message || String(err)));
+      }
+      break;
+    }
+    case "cwd":
+      if (arg) {
+        const next = path.resolve(arg);
+        try {
+          process.chdir(next);
+          state.cwd = next;
+          console.log(c.gray(`cwd → ${state.cwd}`));
+        } catch (err) {
+          console.log(errorLine(err.message));
+        }
+      } else {
+        console.log(c.gray(`cwd: ${state.cwd}`));
+      }
+      break;
+    case "yes":
+      state.autoYes = !state.autoYes;
+      console.log(c.gray(`auto-yes: ${state.autoYes ? "on (writes/shells will skip y/N)" : "off"}`));
+      break;
+    case "turns": {
+      const n = parseInt(arg, 10);
+      if (!Number.isFinite(n) || n < 1 || n > 200) {
+        console.log(errorLine(`/turns expects 1..200, got "${arg}"`));
+      } else {
+        state.maxTurns = n;
+        console.log(c.gray(`max turns: ${state.maxTurns}`));
+      }
+      break;
+    }
+    case "model": {
+      const key = (arg || "").trim().toLowerCase();
+      if (!key) {
+        console.log(c.gray(`model: ${state.modelName}`));
+        console.log(c.gray("switch with /model core | ultra   (ultra=Opus — premium, need credits)"));
+      } else if (MODEL_ALIASES[key]) {
+        state.model = MODEL_ALIASES[key].id;
+        state.modelName = MODEL_ALIASES[key].name;
+        const premium = state.model !== null;
+        console.log(
+          c.gray(`model → ${c.cyan(state.modelName)}`) +
+            (premium ? c.gray("  (premium — needs purchased credits, else falls back to Core)") : ""),
+        );
+      } else {
+        console.log(errorLine(`Unknown model "${key}". Try: core, ultra`));
+      }
+      break;
+    }
+    default:
+      console.log(errorLine(`Unknown command: /${cmd}. Type ${c.cyan("/help")} for shortcuts.`));
+  }
+  return null;
+}
+
+/* ───────── banner + status ───────── */
+
+const shortenPath = (p, max) => (p.length <= max ? p : "..." + p.slice(p.length - max + 3));
+
+function printBanner(state) {
+  const credits = state.balance != null ? `${state.balance.toLocaleString()} credits` : "";
+  const mode = state.autoYes ? (state.unsafePaths ? "skip-permissions" : "auto-yes") : "review";
+
+  // No boxes — plain text, exactly like Claude Code
+  console.log("");
+  console.log(
+    " " + c.bold(c.cyan("✦")) + "  " +
+    c.bold("Aether Code") + " " + c.dim("v" + VERSION),
+  );
+  console.log(
+    "    " + state.modelName +
+    (credits ? c.dim(" · ") + credits : "") +
+    (state.plan && state.plan !== "FREE" ? c.dim(" · ") + c.cyan(state.plan) : ""),
+  );
+  console.log("    " + c.dim(shortenPath(state.cwd, 60)));
+}
+
+function printStatusLine(state) {
+  const parts = [];
+  parts.push(c.gray(`session: ${state.sessionCredits} cr · ${state.sessionIn}→${state.sessionOut} tokens`));
+  if (state.balance != null) parts.push(c.gray(`balance: ${state.balance.toLocaleString()}`));
+  if (state.messages.length > 0) {
+    parts.push(c.gray(`history: ${state.messages.length} msg${state.messages.length === 1 ? "" : "s"}`));
+  }
+  parts.push(c.cyan(state.autoYes ? "auto-yes" : "review"));
+  console.log(c.dim(parts.join("  ·  ")));
+}

package/src/update-check.js

@@ -1,60 +1,117 @@
-// Startup update check — like Claude Code / npm itself nudging you when a newer
-// version is published. Never throws, bounded by a short timeout so it can't
-// slow or block startup; silent when offline or already current.
-
-import { readFileSync } from "node:fs";
-import { fileURLToPath } from "node:url";
-import { dirname, join } from "node:path";
-import { c } from "./render.js";
-
-export function currentVersion() {
-  try {
-    const p = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
-    return JSON.parse(readFileSync(p, "utf8")).version || null;
-  } catch {
-    return null;
-  }
-}
-
-// Compare two "x.y.z" strings. Returns >0 if a is newer than b.
-export function cmpVersion(a, b) {
-  const pa = String(a).split(".").map(Number);
-  const pb = String(b).split(".").map(Number);
-  for (let i = 0; i < 3; i++) {
-    const d = (pa[i] || 0) - (pb[i] || 0);
-    if (d !== 0) return d;
-  }
-  return 0;
-}
-
-/**
- * Resolve a one-line "update available" nudge if the npm registry has a newer
- * version than the installed one — otherwise null. Bounded to ~2s; any failure
- * (offline, timeout, registry hiccup) resolves to null silently.
- */
-export async function checkForUpdate({ fetchImpl = fetch, timeoutMs = 2000 } = {}) {
-  const current = currentVersion();
-  if (!current) return null;
-  try {
-    const ac = new AbortController();
-    const t = setTimeout(() => ac.abort(), timeoutMs);
-    let res;
-    try {
-      res = await fetchImpl("https://registry.npmjs.org/aether-code/latest", { signal: ac.signal });
-    } finally {
-      clearTimeout(t);
-    }
-    if (!res || !res.ok) return null;
-    const latest = (await res.json())?.version;
-    if (latest && cmpVersion(latest, current) > 0) {
-      return (
-        c.yellow("update available: ") +
-        c.gray(current) + " -> " + c.bold(c.green(latest)) +
-        c.gray("  ·  run ") + c.cyan("npm i -g aether-code@latest")
-      );
-    }
-  } catch {
-    /* offline / aborted / parse error — stay silent */
-  }
-  return null;
-}
+// Startup update check + auto-update. On every REPL launch, checks the npm
+// registry and silently installs the latest version in the background if one
+// exists. Never throws, bounded by a short timeout so it can't slow startup.
+
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { fileURLToPath } from "node:url";
+import { dirname, join } from "node:path";
+import { tmpdir } from "node:os";
+import { spawn } from "node:child_process";
+import { c } from "./render.js";
+
+export function currentVersion() {
+  try {
+    const p = join(dirname(fileURLToPath(import.meta.url)), "..", "package.json");
+    return JSON.parse(readFileSync(p, "utf8")).version || null;
+  } catch {
+    return null;
+  }
+}
+
+// Compare two "x.y.z" strings. Returns >0 if a is newer than b.
+export function cmpVersion(a, b) {
+  const pa = String(a).split(".").map(Number);
+  const pb = String(b).split(".").map(Number);
+  for (let i = 0; i < 3; i++) {
+    const d = (pa[i] || 0) - (pb[i] || 0);
+    if (d !== 0) return d;
+  }
+  return 0;
+}
+
+const COOLDOWN_FILE = join(tmpdir(), "aether-update-ts");
+const COOLDOWN_MS = 3600_000; // 1 hour
+
+/**
+ * Check for updates. If a newer version exists on npm, spawn a background
+ * `npm install -g` to auto-install it. Returns a one-line status message
+ * or null. Cooldown: only checks once per hour.
+ */
+export async function autoUpdate({ fetchImpl = fetch, timeoutMs = 2000 } = {}) {
+  const current = currentVersion();
+  if (!current) return null;
+
+  // Skip if we checked less than 1 hour ago
+  try {
+    const ts = parseInt(readFileSync(COOLDOWN_FILE, "utf8"), 10);
+    if (Date.now() - ts < COOLDOWN_MS) return null;
+  } catch { /* no file or parse error — check now */ }
+
+  try {
+    const ac = new AbortController();
+    const t = setTimeout(() => ac.abort(), timeoutMs);
+    let res;
+    try {
+      res = await fetchImpl("https://registry.npmjs.org/aether-code/latest", { signal: ac.signal });
+    } finally {
+      clearTimeout(t);
+    }
+    if (!res || !res.ok) return null;
+    const latest = (await res.json())?.version;
+
+    // Write cooldown regardless of whether an update is available
+    try { writeFileSync(COOLDOWN_FILE, String(Date.now())); } catch { /* ignore */ }
+
+    if (!latest || cmpVersion(latest, current) <= 0) return null;
+
+    // Spawn background npm install — detached so it doesn't block the CLI.
+    // On Windows, `npm` is a cmd script, so shell:true is required.
+    const child = spawn("npm", ["install", "-g", `aether-code@${latest}`], {
+      detached: true,
+      stdio: "ignore",
+      shell: true,
+      windowsHide: true,
+    });
+    child.unref();
+
+    return (
+      c.cyan("↑ auto-updating ") +
+      c.gray(current) + c.gray(" → ") + c.bold(c.green(latest)) +
+      c.gray("  (background — applies next launch)")
+    );
+  } catch {
+    /* offline / aborted / parse error — stay silent */
+  }
+  return null;
+}
+
+/**
+ * Legacy nudge-only check (kept for the test suite). Same as before: returns
+ * a one-line "update available" string or null.
+ */
+export async function checkForUpdate({ fetchImpl = fetch, timeoutMs = 2000 } = {}) {
+  const current = currentVersion();
+  if (!current) return null;
+  try {
+    const ac = new AbortController();
+    const t = setTimeout(() => ac.abort(), timeoutMs);
+    let res;
+    try {
+      res = await fetchImpl("https://registry.npmjs.org/aether-code/latest", { signal: ac.signal });
+    } finally {
+      clearTimeout(t);
+    }
+    if (!res || !res.ok) return null;
+    const latest = (await res.json())?.version;
+    if (latest && cmpVersion(latest, current) > 0) {
+      return (
+        c.yellow("update available: ") +
+        c.gray(current) + " -> " + c.bold(c.green(latest)) +
+        c.gray("  ·  run ") + c.cyan("npm i -g aether-code@latest")
+      );
+    }
+  } catch {
+    /* offline / aborted / parse error — stay silent */
+  }
+  return null;
+}