kimiflare 0.24.0 → 0.26.0

package/dist/index.js

@@ -18,8 +18,7 @@ function configPath() {
 }
 function readReasoningEffortEnv() {
   const raw = process.env.KIMI_REASONING_EFFORT?.toLowerCase();
-  if (raw === "low" || raw === "medium" || raw === "high") return raw;
-  return void 0;
+  return EFFORTS.includes(raw ?? "") ? raw : void 0;
 }
 function readCoauthorEnv() {
   const enabled = process.env.KIMIFLARE_COAUTHOR;
@@ -84,6 +83,7 @@ async function loadConfig() {
   const envMemoryMaxAgeDays = readNumberEnv("KIMIFLARE_MEMORY_MAX_AGE_DAYS");
   const envMemoryMaxEntries = readNumberEnv("KIMIFLARE_MEMORY_MAX_ENTRIES");
   const envMemoryEmbeddingModel = process.env.KIMIFLARE_MEMORY_EMBEDDING_MODEL;
+  const envPlumbingModel = process.env.KIMIFLARE_PLUMBING_MODEL;
   const envCodeMode = readBooleanEnv("KIMIFLARE_CODE_MODE");
   if (envAccount && envToken) {
     return {
@@ -108,6 +108,7 @@ async function loadConfig() {
       memoryMaxAgeDays: envMemoryMaxAgeDays,
       memoryMaxEntries: envMemoryMaxEntries,
       memoryEmbeddingModel: envMemoryEmbeddingModel,
+      plumbingModel: envPlumbingModel,
       codeMode: envCodeMode
     };
   }
@@ -138,6 +139,7 @@ async function loadConfig() {
         memoryMaxAgeDays: envMemoryMaxAgeDays ?? parsed.memoryMaxAgeDays,
         memoryMaxEntries: envMemoryMaxEntries ?? parsed.memoryMaxEntries,
         memoryEmbeddingModel: envMemoryEmbeddingModel ?? parsed.memoryEmbeddingModel,
+        plumbingModel: envPlumbingModel ?? parsed.plumbingModel,
         codeMode: envCodeMode ?? parsed.codeMode
       };
     }
@@ -152,10 +154,11 @@ async function saveConfig(cfg) {
   await chmod(p, 384);
   return p;
 }
-var DEFAULT_MODEL, DEFAULT_REASONING_EFFORT;
+var EFFORTS, DEFAULT_MODEL, DEFAULT_REASONING_EFFORT;
 var init_config = __esm({
   "src/config.ts"() {
     "use strict";
+    EFFORTS = ["low", "medium", "high"];
     DEFAULT_MODEL = "@cf/moonshotai/kimi-k2.6";
     DEFAULT_REASONING_EFFORT = "medium";
   }
@@ -173,10 +176,10 @@ async function* readSSE(stream, signal) {
       if (done) break;
       buffer += decoder.decode(value, { stream: true });
       buffer = buffer.replace(/\r\n/g, "\n");
-      let sep2;
-      while ((sep2 = buffer.indexOf("\n\n")) !== -1) {
-        const event = buffer.slice(0, sep2);
-        buffer = buffer.slice(sep2 + 2);
+      let sep3;
+      while ((sep3 = buffer.indexOf("\n\n")) !== -1) {
+        const event = buffer.slice(0, sep3);
+        buffer = buffer.slice(sep3 + 2);
         const data = extractData(event);
         if (data !== null) yield data;
       }
@@ -209,8 +212,8 @@ var init_errors = __esm({
   "src/util/errors.ts"() {
     "use strict";
     KimiApiError = class extends Error {
-      constructor(message, code, httpStatus) {
-        super(message);
+      constructor(message2, code, httpStatus) {
+        super(message2);
         this.code = code;
         this.httpStatus = httpStatus;
         this.name = "KimiApiError";
@@ -880,7 +883,7 @@ function schemaToTsType(prop, required = true) {
     types.push(`${itemType}[]`);
   } else if (prop.type === "object") {
     if (prop.properties && Object.keys(prop.properties).length > 0) {
-      const entries = Object.entries(prop.properties).map(([key, val]) => {
+      const entries = Object.entries(prop.properties).sort(([a], [b]) => a.localeCompare(b)).map(([key, val]) => {
         const isReq = prop.required?.includes(key) ?? false;
         return `  ${key}${isReq ? "" : "?"}: ${schemaToTsType(val, isReq)};`;
       }).join("\n");
@@ -901,7 +904,7 @@ ${entries}
   return required ? result : `${result} | undefined`;
 }
 function generateInterface(name, properties, required = []) {
-  const entries = Object.entries(properties).map(([key, val]) => {
+  const entries = Object.entries(properties).sort(([a], [b]) => a.localeCompare(b)).map(([key, val]) => {
     const isReq = required.includes(key);
     return `  ${key}${isReq ? "" : "?"}: ${schemaToTsType(val, isReq)};`;
   }).join("\n");
@@ -921,13 +924,14 @@ function generateTypeScriptApi(tools) {
   const inputInterfaces = [];
   const outputInterfaces = [];
   const methodEntries = [];
-  for (const tool of tools) {
+  for (const tool of [...tools].sort((a, b) => a.name.localeCompare(b.name))) {
     const baseName = sanitizeTypeName(tool.name);
     const inputName = `${baseName}_Input`;
     const outputName = `${baseName}_Output`;
     const params = tool.parameters;
-    if (params.properties && Object.keys(params.properties).length > 0) {
-      inputInterfaces.push(generateInterface(inputName, params.properties, params.required));
+    const sortedPropKeys = params.properties ? Object.keys(params.properties).sort((a, b) => a.localeCompare(b)) : [];
+    if (sortedPropKeys.length > 0 && params.properties) {
+      inputInterfaces.push(generateInterface(inputName, params.properties, [...params.required ?? []].sort((a, b) => a.localeCompare(b))));
       inputInterfaces.push("");
       methodEntries.push(`  /**`);
       methodEntries.push(`   * ${tool.description.replace(/\n/g, "\n   * ")}`);
@@ -1027,8 +1031,8 @@ ${jsCode}
     await script.run(context, { timeout, release: true });
     await new Promise((r) => setTimeout(r, 10));
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { output: "", logs, error: message, toolCalls };
+    const message2 = err instanceof Error ? err.message : String(err);
+    return { output: "", logs, error: message2, toolCalls };
   } finally {
     isolate.dispose();
   }
@@ -1110,8 +1114,8 @@ ${jsCode}
     await runInNewContext(wrapped, sandbox, { timeout, displayErrors: true });
     await new Promise((r) => setTimeout(r, 10));
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    return { output: "", logs, error: message, toolCalls };
+    const message2 = err instanceof Error ? err.message : String(err);
+    return { output: "", logs, error: message2, toolCalls };
   }
   return { output: logs.join("\n"), logs, toolCalls };
 }
@@ -1119,8 +1123,8 @@ async function runInSandbox(opts2) {
   try {
     return await runWithIsolatedVm(opts2);
   } catch (err) {
-    const message = err instanceof Error ? err.message : String(err);
-    if (message.includes("isolated-vm") || message.includes("Cannot find module") || message.includes("bindings")) {
+    const message2 = err instanceof Error ? err.message : String(err);
+    if (message2.includes("isolated-vm") || message2.includes("Cannot find module") || message2.includes("bindings")) {
       return runWithNodeVm(opts2);
     }
     return runWithNodeVm(opts2);
@@ -1148,7 +1152,14 @@ async function runAgentTurn(opts2) {
   let toolDefs;
   let codeModeApiString = "";
   if (codeMode) {
-    codeModeApiString = generateTypeScriptApi(opts2.tools);
+    const toolsKey = stableStringify(opts2.tools);
+    const cached = codeModeApiCache.get(toolsKey);
+    if (cached) {
+      codeModeApiString = cached;
+    } else {
+      codeModeApiString = generateTypeScriptApi(opts2.tools);
+      codeModeApiCache.set(toolsKey, codeModeApiString);
+    }
     toolDefs = [
       {
         type: "function",
@@ -1183,6 +1194,9 @@ Use console.log() to return results. Only console.log output will be sent back t
   }
   let turn = 0;
   let lastUsage = null;
+  const recentToolCalls = [];
+  const LOOP_WINDOW = 8;
+  const LOOP_THRESHOLD = 2;
   for (let iter = 0; iter < max; iter++) {
     turn++;
     const previousMessages = opts2.messages.slice();
@@ -1313,6 +1327,28 @@ Use console.log() to return results. Only console.log output will be sent back t
     }
     for (const tc of toolCalls) {
       if (opts2.signal.aborted) throw new DOMException("aborted", "AbortError");
+      const loopSignature = `${tc.function.name}:${stableStringify(tc.function.arguments)}`;
+      const loopCount = recentToolCalls.filter((s) => s === loopSignature).length;
+      if (loopCount >= LOOP_THRESHOLD) {
+        const warning = `Loop detected: you have called ${tc.function.name} with the same arguments multiple times in a row. Consider a different approach.`;
+        const loopResult = {
+          tool_call_id: tc.id,
+          name: tc.function.name,
+          content: warning,
+          ok: false
+        };
+        toolResults.push(loopResult);
+        opts2.messages.push({
+          role: "tool",
+          tool_call_id: tc.id,
+          content: sanitizeString(warning),
+          name: tc.function.name
+        });
+        opts2.callbacks.onToolResult?.(loopResult);
+        recentToolCalls.push(loopSignature);
+        if (recentToolCalls.length > LOOP_WINDOW) recentToolCalls.shift();
+        continue;
+      }
       if (codeMode && tc.function.name === "execute_code") {
         const args = JSON.parse(tc.function.arguments || "{}");
         const code = args.code || "";
@@ -1353,6 +1389,8 @@ ${sandboxResult.output}` : sandboxResult.output;
           name: "execute_code"
         });
         opts2.callbacks.onToolResult?.(result);
+        recentToolCalls.push(loopSignature);
+        if (recentToolCalls.length > LOOP_WINDOW) recentToolCalls.shift();
       } else {
         const result = await opts2.executor.run(
           { id: tc.id, name: tc.function.name, arguments: tc.function.arguments },
@@ -1367,6 +1405,8 @@ ${sandboxResult.output}` : sandboxResult.output;
           name: result.name
         });
         opts2.callbacks.onToolResult?.(result);
+        recentToolCalls.push(loopSignature);
+        if (recentToolCalls.length > LOOP_WINDOW) recentToolCalls.shift();
       }
     }
     if (opts2.sessionId && lastUsage) {
@@ -1392,6 +1432,7 @@ function validateToolArguments(raw) {
     return "{}";
   }
 }
+var codeModeApiCache;
 var init_loop = __esm({
   "src/agent/loop.ts"() {
     "use strict";
@@ -1401,6 +1442,7 @@ var init_loop = __esm({
     init_cost_debug();
     init_strip_reasoning();
     init_code_mode();
+    codeModeApiCache = /* @__PURE__ */ new Map();
   }
 });
 
@@ -1711,6 +1753,9 @@ function resolvePath(cwd, input) {
   }
   return isAbsolute(input) ? input : resolve(cwd, input);
 }
+function isPathOutside(relPath) {
+  return relPath === ".." || relPath.startsWith(`..${sep}`) || isAbsolute(relPath);
+}
 function collapsePath(input, cwd, maxLen = 40) {
   if (!input) return input;
   let abs;
@@ -2839,6 +2884,16 @@ var init_expand_artifact = __esm({
 });
 
 // src/tools/executor.ts
+function isDiffCommand(cmd) {
+  const trimmed = cmd.trim();
+  if (/^git\s+show(?:\s|$)/.test(trimmed)) return true;
+  if (/^git\s+diff(?:\s|$)/.test(trimmed)) return true;
+  if (/^git\s+format-patch(?:\s|$)/.test(trimmed)) return true;
+  const hasPatchFlag = /(?:^|\s)(?:-p|--patch)(?:\s|$)/.test(trimmed);
+  if (/^git\s+log(?:\s|$)/.test(trimmed) && hasPatchFlag) return true;
+  if (/^git\s+stash\s+show(?:\s|$)/.test(trimmed) && hasPatchFlag) return true;
+  return false;
+}
 function normalizeToolOutput(result) {
   if (typeof result === "string") {
     const bytes = Buffer.byteLength(result, "utf8");
@@ -2941,6 +2996,20 @@ var init_executor = __esm({
         try {
           const result = await tool.run(args, ctx);
           const normalized = normalizeToolOutput(result);
+          const cmd = call.name === "bash" && typeof args.command === "string" ? args.command : "";
+          if (isDiffCommand(cmd)) {
+            const artifactId = this.artifactStore.store(normalized.content);
+            const bytes = Buffer.byteLength(normalized.content, "utf8");
+            return {
+              tool_call_id: call.id,
+              name: call.name,
+              content: normalized.content,
+              ok: true,
+              rawBytes: bytes,
+              reducedBytes: bytes,
+              artifactId
+            };
+          }
           const reduced = reduceToolOutput(
             call.name,
             normalized.content,
@@ -3087,13 +3156,17 @@ import { fileURLToPath as fileURLToPath2 } from "url";
 import { dirname as dirname3, join as join7 } from "path";
 function getAppVersion() {
   if (cachedVersion !== null) return cachedVersion;
-  try {
-    const here = dirname3(fileURLToPath2(import.meta.url));
-    const pkg = JSON.parse(readFileSync2(join7(here, "..", "..", "package.json"), "utf8"));
-    cachedVersion = pkg.version ?? "0.0.0";
-  } catch {
-    cachedVersion = "0.0.0";
+  const here = dirname3(fileURLToPath2(import.meta.url));
+  const candidates = [join7(here, "..", "..", "package.json"), join7(here, "..", "package.json")];
+  for (const path of candidates) {
+    try {
+      const pkg = JSON.parse(readFileSync2(path, "utf8"));
+      cachedVersion = pkg.version ?? "0.0.0";
+      return cachedVersion;
+    } catch {
+    }
   }
+  cachedVersion = "0.0.0";
   return cachedVersion;
 }
 var cachedVersion;
@@ -3205,6 +3278,39 @@ function emptySessionState(task = "") {
     artifact_index: {}
   };
 }
+function serializeArtifactStore(store) {
+  const MAX_ARTIFACT_CHARS = 5e4;
+  const out = [];
+  for (const a of store.list()) {
+    out.push({
+      id: a.id,
+      type: a.type,
+      summary: a.summary,
+      raw: a.raw.slice(0, MAX_ARTIFACT_CHARS),
+      source: a.source,
+      path: a.path,
+      lineRange: a.lineRange,
+      ts: a.ts
+    });
+  }
+  return out;
+}
+function deserializeArtifactStore(data) {
+  const store = new ArtifactStore();
+  for (const a of data) {
+    store.add({
+      id: a.id,
+      type: a.type,
+      summary: a.summary,
+      raw: a.raw,
+      source: a.source,
+      path: a.path,
+      lineRange: a.lineRange,
+      ts: a.ts
+    });
+  }
+  return store;
+}
 function formatRecalledArtifacts(recalled) {
   if (recalled.length === 0) return "";
   const lines = ["[recalled artifacts]"];
@@ -3577,11 +3683,12 @@ function recallArtifacts(messages, store, state) {
   }
   for (const failure of state.recent_failures) {
     const keyword = failure.split(":")[0];
-    if (keyword && text.toLowerCase().includes(keyword.toLowerCase())) {
-      for (const [id, meta] of Object.entries(state.artifact_index)) {
-        if (meta.source === "bash" && !ids.includes(id)) {
-          ids.push(id);
-        }
+    if (!keyword) continue;
+    const lowerKeyword = keyword.toLowerCase();
+    if (!text.toLowerCase().includes(lowerKeyword)) continue;
+    for (const [id, meta] of Object.entries(state.artifact_index)) {
+      if (meta.source === "bash" && !ids.includes(id) && meta.summary.toLowerCase().includes(lowerKeyword)) {
+        ids.push(id);
       }
     }
   }
@@ -4069,6 +4176,12 @@ var init_chat = __esm({
           evt.text
         ] });
       }
+      if (evt.kind === "memory") {
+        return /* @__PURE__ */ jsxs4(Text4, { color: theme.info.color, dimColor: theme.info.dim, children: [
+          "\u25C8 ",
+          evt.text
+        ] });
+      }
       return /* @__PURE__ */ jsxs4(Text4, { color: theme.error, children: [
         "! ",
         evt.text
@@ -4153,14 +4266,14 @@ function buildRightParts(usage, contextLimit, sessionUsage, gatewayMeta) {
     parts.push(`in ${sessionUsage.promptTokens}${cached ? ` (${cached} cached)` : ""}`);
     parts.push(`out ${sessionUsage.completionTokens}`);
     parts.push(`ctx ${pct}%`);
-    parts.push(`${sessionUsage.cost.toFixed(5)}`);
+    parts.push(`$${sessionUsage.cost.toFixed(5)}`);
   } else {
     const cached = usage.prompt_tokens_details?.cached_tokens ?? 0;
     const cost = calculateCost(usage.prompt_tokens, usage.completion_tokens, cached);
     parts.push(`in ${usage.prompt_tokens}${cached ? ` (${cached} cached)` : ""}`);
     parts.push(`out ${usage.completion_tokens}`);
     parts.push(`ctx ${pct}%`);
-    parts.push(`${cost.total.toFixed(5)}`);
+    parts.push(`$${cost.total.toFixed(5)}`);
   }
   const gatewayCache = formatGatewayCacheStatus(gatewayMeta);
   if (gatewayCache) parts.push(gatewayCache);
@@ -4910,18 +5023,18 @@ var init_source = __esm({
         }
       }
     });
-    createStyler = (open, close, parent) => {
+    createStyler = (open3, close, parent) => {
       let openAll;
       let closeAll;
       if (parent === void 0) {
-        openAll = open;
+        openAll = open3;
         closeAll = close;
       } else {
-        openAll = parent.openAll + open;
+        openAll = parent.openAll + open3;
         closeAll = close + parent.closeAll;
       }
       return {
-        open,
+        open: open3,
         close,
         openAll,
         closeAll,
@@ -5367,6 +5480,245 @@ var init_welcome = __esm({
   }
 });
 
+// src/ui/help-menu.tsx
+import { useState as useState6 } from "react";
+import { Box as Box12, Text as Text13, useInput as useInput2 } from "ink";
+import SelectInput4 from "ink-select-input";
+import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
+function HelpMenu({ theme, themes, currentThemeName, customCommands, onDone, onCommand }) {
+  const [page, setPage] = useState6("main");
+  const customs = customCommands ?? [];
+  useInput2((_input, key) => {
+    if (key.escape) {
+      if (page !== "main") {
+        setPage("main");
+      } else {
+        onDone();
+      }
+    }
+  });
+  const handleSelect = (command) => {
+    onCommand(command);
+    onDone();
+  };
+  if (page === "main") {
+    const items2 = CATEGORIES.map((cat) => ({
+      label: cat.label,
+      value: cat.key,
+      key: cat.key
+    }));
+    if (customs.length > 0) {
+      items2.push({ label: "Run custom commands", value: "custom", key: "custom" });
+    }
+    items2.push({ label: "(close)", value: "__close__", key: "__close__" });
+    return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+      /* @__PURE__ */ jsx13(Text13, { color: theme.accent, bold: true, children: "Help" }),
+      /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: "Arrow keys to navigate, Enter to select, Esc to close." }),
+      /* @__PURE__ */ jsx13(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx13(
+        SelectInput4,
+        {
+          items: items2,
+          onSelect: (item) => {
+            if (item.value === "__close__") {
+              onDone();
+            } else {
+              setPage(item.value);
+            }
+          }
+        }
+      ) }),
+      /* @__PURE__ */ jsx13(Box12, { marginTop: 1, flexDirection: "column", children: SINGLE_COMMANDS.map((cmd) => /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: `  ${cmd.command.padEnd(20)} ${cmd.description}` }, cmd.command)) }),
+      /* @__PURE__ */ jsx13(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: "keys: ctrl-c interrupt/exit \xB7 ctrl-r toggle reasoning \xB7 ctrl-o verbose \xB7 ctrl+t theme \xB7 shift+tab cycle mode \xB7 \u2191/\u2193 history" }) })
+    ] });
+  }
+  if (page === "theme") {
+    const items2 = themes.map((t) => ({
+      label: t.name === currentThemeName ? `${t.label} \xB7 current` : t.label,
+      value: t.name,
+      key: t.name
+    }));
+    items2.push({ label: "\u2190 Back", value: "__back__", key: "__back__" });
+    return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+      /* @__PURE__ */ jsx13(Text13, { color: theme.accent, bold: true, children: "Theme" }),
+      /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: "Arrow keys to navigate, Enter to apply, Esc to go back." }),
+      /* @__PURE__ */ jsx13(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx13(
+        SelectInput4,
+        {
+          items: items2,
+          onSelect: (item) => {
+            if (item.value === "__back__") {
+              setPage("main");
+            } else {
+              handleSelect(`/theme ${item.value}`);
+            }
+          }
+        }
+      ) })
+    ] });
+  }
+  if (page === "custom") {
+    const items2 = customs.map((c) => ({
+      label: `${`/${c.name}`.padEnd(28)} ${c.description ?? ""}`.trimEnd(),
+      value: `/${c.name}`,
+      key: c.name
+    }));
+    items2.push({ label: "\u2190 Back", value: "__back__", key: "__back__" });
+    return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+      /* @__PURE__ */ jsx13(Text13, { color: theme.accent, bold: true, children: "Custom commands" }),
+      /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: customs.length === 0 ? "no custom commands found in .kimiflare/commands/" : "Arrow keys to navigate, Enter to run, Esc to go back." }),
+      /* @__PURE__ */ jsx13(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx13(
+        SelectInput4,
+        {
+          items: items2,
+          onSelect: (item) => {
+            if (item.value === "__back__") {
+              setPage("main");
+            } else {
+              handleSelect(item.value);
+            }
+          }
+        }
+      ) })
+    ] });
+  }
+  const category = CATEGORIES.find((c) => c.key === page);
+  const selectable = category.commands.filter((cmd) => cmd.selectable !== false);
+  const staticCmds = category.commands.filter((cmd) => cmd.selectable === false);
+  const items = selectable.map((cmd) => ({
+    label: `${cmd.command.padEnd(28)} ${cmd.description}`,
+    value: cmd.command,
+    key: cmd.command
+  }));
+  items.push({ label: "\u2190 Back", value: "__back__", key: "__back__" });
+  return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+    /* @__PURE__ */ jsx13(Text13, { color: theme.accent, bold: true, children: category.label }),
+    /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: false, children: "Arrow keys to navigate, Enter to execute, Esc to go back." }),
+    /* @__PURE__ */ jsx13(Box12, { marginTop: 1, children: /* @__PURE__ */ jsx13(
+      SelectInput4,
+      {
+        items,
+        onSelect: (item) => {
+          if (item.value === "__back__") {
+            setPage("main");
+          } else {
+            handleSelect(item.value);
+          }
+        }
+      }
+    ) }),
+    staticCmds.length > 0 && /* @__PURE__ */ jsx13(Box12, { marginTop: 1, flexDirection: "column", children: staticCmds.map((cmd) => /* @__PURE__ */ jsx13(Text13, { color: theme.info.color, dimColor: true, children: `  ${cmd.command.padEnd(28)} ${cmd.description}` }, cmd.command)) })
+  ] });
+}
+var CATEGORIES, SINGLE_COMMANDS;
+var init_help_menu = __esm({
+  "src/ui/help-menu.tsx"() {
+    "use strict";
+    CATEGORIES = [
+      {
+        key: "mode",
+        label: "Mode",
+        commands: [
+          { command: "/mode edit", description: "switch to edit mode" },
+          { command: "/mode plan", description: "switch to plan mode" },
+          { command: "/mode auto", description: "switch to auto mode" }
+        ]
+      },
+      {
+        key: "thinking",
+        label: "Thinking",
+        commands: [
+          { command: "/thinking low", description: "fast, lower quality" },
+          { command: "/thinking medium", description: "balanced" },
+          { command: "/thinking high", description: "slow, higher quality" }
+        ]
+      },
+      {
+        key: "theme",
+        label: "Theme",
+        commands: []
+      },
+      {
+        key: "session",
+        label: "Session",
+        commands: [
+          { command: "/resume", description: "pick a past conversation" },
+          { command: "/compact", description: "summarize old turns to free context" },
+          { command: "/clear", description: "clear current conversation" }
+        ]
+      },
+      {
+        key: "memory",
+        label: "Memory",
+        commands: [
+          { command: "/memory", description: "show memory stats" },
+          { command: "/memory on", description: "enable memory" },
+          { command: "/memory off", description: "disable memory" },
+          { command: "/memory clear", description: "wipe memories for this repo" },
+          { command: "/memory search <query>", description: "search stored memories", selectable: false }
+        ]
+      },
+      {
+        key: "mcp",
+        label: "MCP",
+        commands: [
+          { command: "/mcp list", description: "list connected MCP servers and tools" },
+          { command: "/mcp reload", description: "reconnect all configured MCP servers" }
+        ]
+      },
+      {
+        key: "gateway",
+        label: "Gateway",
+        commands: [
+          { command: "/gateway", description: "show gateway status" },
+          { command: "/gateway off", description: "disable AI Gateway (direct Workers AI)" },
+          { command: "/gateway skip-cache true", description: "enable skip-cache" },
+          { command: "/gateway skip-cache false", description: "disable skip-cache" },
+          { command: "/gateway collect-logs true", description: "enable log collection" },
+          { command: "/gateway collect-logs false", description: "disable log collection" },
+          { command: "/gateway metadata clear", description: "remove all metadata" },
+          { command: "/gateway <id>", description: "enable AI Gateway", selectable: false },
+          { command: "/gateway cache-ttl <seconds>", description: "set cache TTL", selectable: false },
+          { command: "/gateway metadata <key>=<value>", description: "add metadata", selectable: false }
+        ]
+      },
+      {
+        key: "info",
+        label: "Info",
+        commands: [
+          { command: "/cost", description: "show cost report" },
+          { command: "/model", description: "show current model" },
+          { command: "/update", description: "check for updates" },
+          { command: "/hello", description: "send a voice note to the creator" },
+          { command: "/community", description: "join our Discord server" }
+        ]
+      },
+      {
+        key: "commands",
+        label: "Commands",
+        commands: [
+          { command: "/command create", description: "create a new custom slash command" },
+          { command: "/command edit", description: "edit an existing custom command" },
+          { command: "/command delete", description: "delete a custom command" },
+          { command: "/command list", description: "list all custom commands" }
+        ]
+      },
+      {
+        key: "config",
+        label: "Config",
+        commands: [
+          { command: "/init", description: "scan this repo and write a KIMI.md" },
+          { command: "/logout", description: "clear credentials" }
+        ]
+      }
+    ];
+    SINGLE_COMMANDS = [
+      { command: "/reasoning", description: "toggle show/hide model reasoning" },
+      { command: "/help", description: "show this menu" },
+      { command: "/exit", description: "exit kimiflare" }
+    ];
+  }
+});
+
 // src/ui/theme.ts
 function resolveTheme(name) {
   if (!name) return THEMES[DEFAULT_THEME_NAME];
@@ -6164,11 +6516,11 @@ function updateAccessedAt(db, ids) {
 function searchMemoriesFts(db, query, repoPath, limit = 50) {
   const sql = repoPath ? `SELECT m.*, rank FROM memories m
        JOIN memories_fts fts ON m.rowid = fts.rowid
-       WHERE memories_fts MATCH ? AND m.repo_path = ? AND m.forgotten = 0 AND m.superseded_by IS NULL
+       WHERE memories_fts MATCH ? AND m.repo_path = ? AND m.forgotten = 0 AND m.superseded_by IS NULL AND m.category != 'task'
        ORDER BY rank
        LIMIT ?` : `SELECT m.*, rank FROM memories m
        JOIN memories_fts fts ON m.rowid = fts.rowid
-       WHERE memories_fts MATCH ? AND m.forgotten = 0 AND m.superseded_by IS NULL
+       WHERE memories_fts MATCH ? AND m.forgotten = 0 AND m.superseded_by IS NULL AND m.category != 'task'
        ORDER BY rank
        LIMIT ?`;
   const params = repoPath ? [`${query}*`, repoPath, limit] : [`${query}*`, limit];
@@ -6181,7 +6533,7 @@ function searchMemoriesFts(db, query, repoPath, limit = 50) {
 function listMemoriesForVectorSearch(db, repoPath, since, limit = 2e3) {
   const rows = db.prepare(
     `SELECT * FROM memories
-       WHERE repo_path = ? AND created_at >= ? AND forgotten = 0 AND superseded_by IS NULL
+       WHERE repo_path = ? AND created_at >= ? AND forgotten = 0 AND superseded_by IS NULL AND category != 'task'
        ORDER BY accessed_at DESC
        LIMIT ?`
   ).all(repoPath, since, limit);
@@ -6628,7 +6980,20 @@ function redactSecrets(text) {
   }
   return result;
 }
-var SECRET_PATTERNS, VERIFY_SYSTEM, TOPIC_KEY_SYSTEM, HYPOTHETICAL_QUERIES_SYSTEM, MemoryManager;
+function deterministicTopicKey(content) {
+  return content.toLowerCase().replace(/[^a-z0-9\s]/g, "").trim().replace(/\s+/g, "_").slice(0, 60);
+}
+function pickTopicKey(content, existingKeys) {
+  const normalized = deterministicTopicKey(content);
+  if (!normalized) return null;
+  for (const existing of existingKeys) {
+    if (normalized.includes(existing) || existing.includes(normalized)) {
+      return existing;
+    }
+  }
+  return normalized;
+}
+var SECRET_PATTERNS, VERIFY_SYSTEM, HYPOTHETICAL_QUERIES_SYSTEM, MemoryManager;
 var init_manager2 = __esm({
   "src/memory/manager.ts"() {
     "use strict";
@@ -6656,19 +7021,12 @@ Return a JSON object:
   "confidence": "high" | "medium" | "low",
   "corrected_content": string | null  // if minor correction needed, provide it; otherwise null
 }`;
-    TOPIC_KEY_SYSTEM = `You are a topic normalization engine. Given a new memory and a list of existing topic keys for this project, decide whether the new memory belongs to an existing topic or needs a new one.
-
-Rules:
-- Topic keys are lowercase snake_case, max 3 words.
-- If the new memory is about the same topic as an existing key, return the existing key.
-- If it's a genuinely new topic, generate a new normalized key.
-- Return ONLY the topic key string, nothing else.`;
     HYPOTHETICAL_QUERIES_SYSTEM = `Given a memory, generate 3-5 short search queries a user might type to find it.
 Cover different phrasings: declarative, interrogative, and keyword-based.
 
 Return a JSON array of strings. Example:
 ["what package manager does this project use?", "pnpm preference", "user likes pnpm over npm"]`;
-    MemoryManager = class {
+    MemoryManager = class _MemoryManager {
       db = null;
       opts;
       constructor(opts2) {
@@ -6696,6 +7054,14 @@ Return a JSON array of strings. Example:
           gateway: this.opts.gateway
         };
       }
+      get plumbingLlmOpts() {
+        return {
+          accountId: this.opts.accountId,
+          apiToken: this.opts.apiToken,
+          model: this.opts.plumbingModel ?? "@cf/meta/llama-4-scout-17b-16e-instruct",
+          gateway: this.opts.gateway
+        };
+      }
       shouldRedact() {
         return this.opts.redactSecrets !== false;
       }
@@ -6716,7 +7082,7 @@ Return a JSON array of strings. Example:
         if (verified.corrected_content) {
           safeContent = verified.corrected_content;
         }
-        const topicKey = await this.normalizeTopicKey(safeContent, repoPath, signal);
+        const topicKey = this.normalizeTopicKey(safeContent, repoPath);
         const supersededIds = [];
         if (topicKey) {
           const existing = findMemoriesByTopicKey(this.db, repoPath, topicKey);
@@ -6768,6 +7134,38 @@ Return a JSON array of strings. Example:
         }
         return retrieveMemories({ db: this.db, query });
       }
+      /**
+       * Format recalled memories as a compact context block for injection into messages.
+       */
+      static formatRecalled(results) {
+        if (results.length === 0) return "";
+        const lines = ["[recalled memories]"];
+        for (const r of results) {
+          const files = r.memory.relatedFiles.length > 0 ? ` [${r.memory.relatedFiles.join(", ")}]` : "";
+          lines.push(`- [${r.memory.category}] ${r.memory.content}${files}`);
+        }
+        return lines.join("\n");
+      }
+      /**
+       * Synthesize recalled memories into a dense prose paragraph.
+       * Uses the lightweight plumbing model (Scout) to keep costs low.
+       */
+      async synthesizeRecalled(results, signal) {
+        if (results.length === 0) return "";
+        const raw = _MemoryManager.formatRecalled(results);
+        const text = await runKimiText({
+          ...this.plumbingLlmOpts,
+          signal,
+          messages: [
+            {
+              role: "system",
+              content: "You are a context-synthesis engine. Given a list of recalled memories about a codebase, produce a single dense paragraph of context for a coding assistant. Preserve all facts, file paths, and decisions. Do not add information not present in the memories. Be terse."
+            },
+            { role: "user", content: raw }
+          ]
+        });
+        return text || raw;
+      }
       /**
        * Soft-delete a memory by ID.
        */
@@ -6827,7 +7225,7 @@ Return a JSON array of strings. Example:
       }
       async verifyMemory(content, signal) {
         const text = await runKimiText({
-          ...this.llmOpts,
+          ...this.plumbingLlmOpts,
           signal,
           messages: [
             { role: "system", content: VERIFY_SYSTEM },
@@ -6851,31 +7249,13 @@ Context: This memory was explicitly provided by the user during a conversation.`
         const corrected = typeof rec.corrected_content === "string" ? rec.corrected_content : null;
         return { valid, corrected_content: corrected };
       }
-      async normalizeTopicKey(content, repoPath, signal) {
+      normalizeTopicKey(content, repoPath) {
         const existingKeys = listTopicKeys(this.db, repoPath);
-        const keysBlock = existingKeys.length > 0 ? existingKeys.join("\n") : "(none yet)";
-        const text = await runKimiText({
-          ...this.llmOpts,
-          signal,
-          messages: [
-            { role: "system", content: TOPIC_KEY_SYSTEM },
-            {
-              role: "user",
-              content: `Existing topic keys:
-${keysBlock}
-
-New memory: "${content}"
-
-Return only the topic key string.`
-            }
-          ]
-        });
-        const key = text.trim().toLowerCase().replace(/\s+/g, "_").replace(/[^a-z0-9_]/g, "").slice(0, 60);
-        return key || null;
+        return pickTopicKey(content, existingKeys);
       }
       async generateHypotheticalQueries(content, signal) {
         const text = await runKimiText({
-          ...this.llmOpts,
+          ...this.plumbingLlmOpts,
           signal,
           messages: [
             { role: "system", content: HYPOTHETICAL_QUERIES_SYSTEM },
@@ -6932,133 +7312,1036 @@ var init_state = __esm({
   }
 });
 
-// src/app.tsx
-var app_exports = {};
-__export(app_exports, {
-  renderApp: () => renderApp
-});
-import { useState as useState6, useRef as useRef3, useEffect as useEffect4, useCallback } from "react";
-import { Box as Box12, Text as Text13, useApp, useInput as useInput2, render } from "ink";
-import { existsSync } from "fs";
-import { join as join12 } from "path";
-import { unlink as unlink2 } from "fs/promises";
-import { spawn as spawn2 } from "child_process";
-import { platform as platform2 } from "os";
-import { jsx as jsx13, jsxs as jsxs12 } from "react/jsx-runtime";
-function gatewayFromConfig(cfg) {
-  if (!cfg.aiGatewayId) return void 0;
-  return {
-    id: cfg.aiGatewayId,
-    cacheTtl: cfg.aiGatewayCacheTtl,
-    skipCache: cfg.aiGatewaySkipCache,
-    collectLogPayload: cfg.aiGatewayCollectLogPayload,
-    metadata: cfg.aiGatewayMetadata
-  };
+// src/commands/frontmatter.ts
+function serializeFrontmatter(data) {
+  const lines = [];
+  for (const [key, value] of Object.entries(data)) {
+    if (value === void 0 || value === "") continue;
+    lines.push(`${key}: ${value}`);
+  }
+  if (lines.length === 0) return "";
+  return `---
+${lines.join("\n")}
+---
+`;
+}
+function parseFrontmatter(input) {
+  const errors = [];
+  if (!FENCE.test(input)) {
+    return { data: {}, body: input, errors };
+  }
+  const afterOpen = input.replace(FENCE, "");
+  const closeIdx = afterOpen.search(/\r?\n---\s*(\r?\n|$)/);
+  if (closeIdx === -1) {
+    errors.push("frontmatter not closed with ---");
+    return { data: {}, body: input, errors };
+  }
+  const yaml = afterOpen.slice(0, closeIdx);
+  const closeMatch = afterOpen.slice(closeIdx).match(/\r?\n---\s*(\r?\n|$)/);
+  const body = closeMatch ? afterOpen.slice(closeIdx + closeMatch[0].length) : "";
+  const data = {};
+  const lines = yaml.split(/\r?\n/);
+  for (const line of lines) {
+    if (line.trim() === "" || line.trim().startsWith("#")) continue;
+    const m = line.match(KV);
+    if (!m) {
+      errors.push(`unparseable line: ${line.trim()}`);
+      continue;
+    }
+    const key = m[1];
+    let value = m[2] ?? "";
+    if (value.startsWith('"') && value.endsWith('"') && value.length >= 2 || value.startsWith("'") && value.endsWith("'") && value.length >= 2) {
+      value = value.slice(1, -1);
+    }
+    data[key] = value;
+  }
+  return { data, body, errors };
 }
-function gatewayUsageLookupFromConfig(cfg, meta) {
-  if (!cfg.aiGatewayId || !meta) return void 0;
+var FENCE, KV;
+var init_frontmatter = __esm({
+  "src/commands/frontmatter.ts"() {
+    "use strict";
+    FENCE = /^---\s*\r?\n/;
+    KV = /^([A-Za-z][\w-]*)\s*:\s*(.*?)\s*$/;
+  }
+});
+
+// src/commands/loader.ts
+import { open, realpath } from "fs/promises";
+import { homedir as homedir9 } from "os";
+import { join as join12, relative as relative2, sep as sep2 } from "path";
+import fg3 from "fast-glob";
+function projectCommandsDir(cwd = process.cwd()) {
+  return join12(cwd, ".kimiflare", "commands");
+}
+function globalCommandsDir() {
+  const xdg = process.env.XDG_CONFIG_HOME || join12(homedir9(), ".config");
+  return join12(xdg, "kimiflare", "commands");
+}
+async function loadCustomCommands(cwd = process.cwd()) {
+  const warnings = [];
+  const byName = /* @__PURE__ */ new Map();
+  const sources = [
+    { dir: globalCommandsDir(), source: "global" },
+    { dir: projectCommandsDir(cwd), source: "project" }
+  ];
+  const perSource = await Promise.all(
+    sources.map(async ({ dir, source }) => {
+      const safeDir = await resolveSafeDir(dir, source, cwd, warnings);
+      if (safeDir === null) return [];
+      const files = await fg3("**/*.md", {
+        cwd: safeDir,
+        absolute: true,
+        onlyFiles: true,
+        followSymbolicLinks: false,
+        suppressErrors: true
+      });
+      return Promise.all(files.map((file) => loadOne(file, safeDir, source, warnings)));
+    })
+  );
+  for (const loaded of perSource) {
+    for (const cmd of loaded) {
+      if (cmd) byName.set(cmd.name, cmd);
+    }
+  }
   return {
-    accountId: cfg.accountId,
-    apiToken: cfg.apiToken,
-    gatewayId: cfg.aiGatewayId,
-    meta
+    commands: [...byName.values()].sort((a, b) => a.name.localeCompare(b.name)),
+    warnings
   };
 }
-function openBrowser(url) {
-  const cmd = platform2() === "darwin" ? "open" : platform2() === "win32" ? "start" : "xdg-open";
-  const child = spawn2(cmd, [url], { detached: true, stdio: "ignore" });
-  child.unref();
-}
-function capEvents(prev) {
-  if (prev.length <= MAX_EVENTS) return prev;
-  return prev.slice(prev.length - MAX_EVENTS);
+async function resolveSafeDir(dir, source, cwd, warnings) {
+  let realDir;
+  try {
+    realDir = await realpath(dir);
+  } catch (err) {
+    const code = err.code;
+    if (code !== "ENOENT" && code !== "ENOTDIR") {
+      warnings.push(`commands dir ${dir} unreadable: ${err.message}`);
+    }
+    return null;
+  }
+  if (source === "project") {
+    let realCwd;
+    try {
+      realCwd = await realpath(cwd);
+    } catch {
+      return null;
+    }
+    const rel = relative2(realCwd, realDir);
+    if (rel !== "" && isPathOutside(rel)) {
+      warnings.push(`commands dir ${dir} escapes workspace via symlink \u2014 skipped`);
+      return null;
+    }
+  }
+  return realDir;
 }
-function compactEventsVisual(prev, keepLastTurns) {
-  let seen = 0;
-  let cutoff = -1;
-  for (let i = prev.length - 1; i >= 0; i--) {
-    if (prev[i].kind === "user") {
-      seen++;
-      if (seen === keepLastTurns + 1) {
-        cutoff = i;
-        break;
+async function loadOne(file, rootDir, source, warnings) {
+  let content;
+  try {
+    const handle = await open(file, "r");
+    try {
+      const stats = await handle.stat();
+      if (stats.size > MAX_COMMAND_FILE_BYTES) {
+        warnings.push(`command file ${file} exceeds ${MAX_COMMAND_FILE_BYTES} bytes \u2014 skipped`);
+        return null;
       }
+      content = await handle.readFile("utf8");
+    } finally {
+      await handle.close();
     }
+  } catch (e) {
+    warnings.push(`failed to read command file ${file}: ${e.message}`);
+    return null;
   }
-  if (cutoff <= 0) return prev;
-  const kept = prev.slice(cutoff);
-  return [
-    { kind: "info", key: mkKey(), text: `\xB7\xB7\xB7 ${cutoff} earlier messages compacted \xB7\xB7\xB7` },
-    ...kept
-  ];
-}
-function makePrefixMessages(cacheStable, model, mode, tools) {
-  if (cacheStable) {
-    return buildSystemMessages({ cwd: process.cwd(), tools, model, mode });
+  const name = filenameToCommandName(file, rootDir);
+  if (!name) {
+    warnings.push(`invalid command name from ${file}`);
+    return null;
   }
-  return [
-    {
-      role: "system",
-      content: buildSystemPrompt({ cwd: process.cwd(), tools, model, mode })
+  const { data, body, errors } = parseFrontmatter(content);
+  if (errors.length > 0) {
+    warnings.push(`frontmatter errors in ${file}: ${errors.join("; ")} \u2014 skipped`);
+    return null;
+  }
+  const cmd = {
+    name,
+    template: body,
+    source,
+    filepath: file
+  };
+  if (data.description) cmd.description = data.description;
+  const modeRaw = data.mode ?? data.agent;
+  if (modeRaw !== void 0) {
+    const normalized = modeRaw === "build" ? "edit" : modeRaw;
+    if (MODES.includes(normalized)) {
+      cmd.mode = normalized;
+    } else {
+      warnings.push(`unknown mode "${modeRaw}" in ${file} \u2014 ignored`);
     }
-  ];
-}
-function findImagePaths(text) {
-  const paths = [];
-  for (const token of text.split(/\s+/)) {
-    const clean = token.replace(/^["']|["',;:!?]$/g, "").replace(/[.,;:!?]$/, "");
-    if (isImagePath(clean) && existsSync(clean)) {
-      paths.push(clean);
+  }
+  if (data.model !== void 0 && data.model !== "") {
+    cmd.model = data.model;
+  }
+  if (data.effort !== void 0) {
+    if (EFFORTS.includes(data.effort)) {
+      cmd.effort = data.effort;
+    } else {
+      warnings.push(`unknown effort "${data.effort}" in ${file} \u2014 ignored`);
     }
   }
-  return [...new Set(paths)];
+  return cmd;
 }
-function App({ initialCfg, initialUpdateResult }) {
-  const { exit } = useApp();
-  const [cfg, setCfg] = useState6(initialCfg);
-  const [events, setRawEvents] = useState6([]);
-  const setEvents = useCallback(
-    (updater) => {
-      setRawEvents((prev) => {
-        const next = typeof updater === "function" ? updater(prev) : updater;
-        return capEvents(next);
-      });
-    },
-    []
-  );
-  const [input, setInput] = useState6("");
-  const [busy, setBusy] = useState6(false);
-  const [usage, setUsage] = useState6(null);
-  const [sessionUsage, setSessionUsage] = useState6(null);
-  const [gatewayMeta, setGatewayMeta] = useState6(null);
-  const [showReasoning, setShowReasoning] = useState6(false);
-  const [perm, setPerm] = useState6(null);
-  const [queue, setQueue] = useState6([]);
-  const [history, setHistory] = useState6([]);
-  const [historyIndex, setHistoryIndex] = useState6(-1);
-  const [draftInput, setDraftInput] = useState6("");
-  const [mode, setMode] = useState6("edit");
-  const [codeMode, setCodeMode] = useState6(initialCfg?.codeMode ?? false);
-  const [effort, setEffort] = useState6(
-    initialCfg?.reasoningEffort ?? DEFAULT_REASONING_EFFORT
-  );
-  const [theme, setTheme] = useState6(resolveTheme(initialCfg?.theme));
-  const [resumeSessions, setResumeSessions] = useState6(null);
-  const [showThemePicker, setShowThemePicker] = useState6(false);
-  const [originalTheme, setOriginalTheme] = useState6(null);
-  const [tasks, setTasks] = useState6([]);
-  const [tasksStartedAt, setTasksStartedAt] = useState6(null);
-  const [tasksStartTokens, setTasksStartTokens] = useState6(0);
-  const [turnStartedAt, setTurnStartedAt] = useState6(null);
-  const [verbose, setVerbose] = useState6(false);
-  const [hasUpdate, setHasUpdate] = useState6(initialUpdateResult?.hasUpdate ?? false);
-  const [latestVersion, setLatestVersion] = useState6(initialUpdateResult?.latestVersion ?? null);
-  const cacheStableRef = useRef3(initialCfg?.cacheStablePrompts !== false);
-  const messagesRef = useRef3(
-    makePrefixMessages(cacheStableRef.current, cfg?.model ?? DEFAULT_MODEL, "edit", ALL_TOOLS)
-  );
-  const executorRef = useRef3(new ToolExecutor(ALL_TOOLS));
-  const activeAsstIdRef = useRef3(null);
+function filenameToCommandName(file, rootDir) {
+  const rel = relative2(rootDir, file);
+  if (!rel || isPathOutside(rel)) return null;
+  const noExt = rel.replace(/\.md$/i, "");
+  const parts = noExt.split(sep2).filter((p) => p.length > 0);
+  if (parts.length === 0) return null;
+  if (parts.some((p) => !/^[\w.-]+$/.test(p))) return null;
+  return parts.join("/");
+}
+var MAX_COMMAND_FILE_BYTES;
+var init_loader = __esm({
+  "src/commands/loader.ts"() {
+    "use strict";
+    init_mode();
+    init_config();
+    init_paths();
+    init_frontmatter();
+    MAX_COMMAND_FILE_BYTES = 256 * 1024;
+  }
+});
+
+// src/commands/renderer.ts
+import { exec } from "child_process";
+import { open as open2, realpath as realpath2 } from "fs/promises";
+import { isAbsolute as isAbsolute2, relative as relative3, resolve as resolvePathJoin } from "path";
+import { promisify as promisify2 } from "util";
+function tokenizeArgs(s) {
+  return [...s.matchAll(ARG_TOKEN_RE)].map((match) => {
+    const token = match[0];
+    if (token.length >= 2 && (token.startsWith('"') && token.endsWith('"') || token.startsWith("'") && token.endsWith("'"))) {
+      return token.slice(1, -1);
+    }
+    return token;
+  });
+}
+async function renderCommand(cmd, rawInput, opts2 = {}) {
+  const warnings = [];
+  const cwd = opts2.cwd ?? process.cwd();
+  const maxFileBytes = opts2.maxFileBytes ?? DEFAULT_MAX_FILE_BYTES;
+  const argsString = stripCommandName(rawInput);
+  const args = tokenizeArgs(argsString);
+  const originalTemplate = cmd.template;
+  const hadArguments = originalTemplate.includes("$ARGUMENTS");
+  const hadPositionals = HAS_POSITIONAL.test(originalTemplate);
+  let prompt = replacePositionals(originalTemplate, args);
+  prompt = prompt.replaceAll("$ARGUMENTS", argsString);
+  if (!hadArguments && !hadPositionals && argsString !== "") {
+    prompt += `
+
+${argsString}`;
+  }
+  prompt = await replaceShell(prompt, warnings, opts2.shellTimeoutMs ?? DEFAULT_SHELL_TIMEOUT_MS);
+  prompt = await replaceFiles(prompt, warnings, cwd, maxFileBytes);
+  if (prompt.trim() === "") {
+    warnings.push("rendered prompt is empty");
+  }
+  return { prompt, warnings };
+}
+function stripCommandName(rawInput) {
+  if (!rawInput.startsWith("/")) {
+    return rawInput;
+  }
+  return rawInput.replace(/^\/\S+\s*/, "");
+}
+function replacePositionals(template, args) {
+  const indexes = [...template.matchAll(POSITIONAL_RE)].map(
+    (match) => Number(match[1])
+  );
+  const highest = indexes.length === 0 ? -1 : Math.max(...indexes);
+  return template.replace(POSITIONAL_RE, (_match, n) => {
+    const index = Number(n);
+    if (index <= 0) {
+      return "";
+    }
+    if (index === highest) {
+      return args.slice(index - 1).join(" ");
+    }
+    return args[index - 1] ?? "";
+  });
+}
+async function replaceShell(prompt, warnings, shellTimeoutMs) {
+  const matches = [...prompt.matchAll(SHELL_RE)];
+  const replacements = await Promise.all(
+    matches.map(async (match) => {
+      const command = match[1] ?? "";
+      try {
+        const { stdout } = await execAsync(command, {
+          timeout: shellTimeoutMs,
+          maxBuffer: 1024 * 1024
+        });
+        return String(stdout).trimEnd();
+      } catch (error) {
+        warnings.push(`shell command failed: \`${command}\` \u2014 ${message(error)}`);
+        return "";
+      }
+    })
+  );
+  let index = 0;
+  return prompt.replace(SHELL_RE, () => replacements[index++] ?? "");
+}
+async function replaceFiles(prompt, warnings, cwd, maxFileBytes) {
+  const matches = [...prompt.matchAll(FILE_RE)];
+  if (matches.length === 0) return prompt;
+  const realCwd = await realpath2(cwd).catch(() => cwd);
+  const replacements = await Promise.all(
+    matches.map(async (match) => {
+      const rawPath = match[1] ?? "";
+      if (isAbsolute2(rawPath) || rawPath.startsWith("~")) {
+        warnings.push(`file inclusion skipped: @${rawPath} \u2014 outside workspace`);
+        return "";
+      }
+      const resolved = resolvePathJoin(cwd, rawPath);
+      if (isPathOutside(relative3(cwd, resolved))) {
+        warnings.push(`file inclusion skipped: @${rawPath} \u2014 outside workspace`);
+        return "";
+      }
+      let real;
+      try {
+        real = await realpath2(resolved);
+      } catch (error) {
+        warnings.push(`file inclusion failed: @${rawPath} \u2014 ${message(error)}`);
+        return "";
+      }
+      if (isPathOutside(relative3(realCwd, real))) {
+        warnings.push(`file inclusion skipped: @${rawPath} \u2014 symlink escapes workspace`);
+        return "";
+      }
+      try {
+        const handle = await open2(real, "r");
+        try {
+          const stats = await handle.stat();
+          if (stats.size > maxFileBytes) {
+            warnings.push(
+              `file inclusion skipped: @${rawPath} \u2014 exceeds ${maxFileBytes} bytes`
+            );
+            return "";
+          }
+          return await handle.readFile("utf8");
+        } finally {
+          await handle.close();
+        }
+      } catch (error) {
+        warnings.push(`file inclusion failed: @${rawPath} \u2014 ${message(error)}`);
+        return "";
+      }
+    })
+  );
+  let index = 0;
+  return prompt.replace(FILE_RE, (_match, _path, trailing = "") => {
+    const replacement = replacements[index++] ?? "";
+    return replacement + trailing;
+  });
+}
+function message(error) {
+  return error instanceof Error ? error.message : String(error);
+}
+var execAsync, ARG_TOKEN_RE, POSITIONAL_RE, HAS_POSITIONAL, SHELL_RE, FILE_RE, DEFAULT_MAX_FILE_BYTES, DEFAULT_SHELL_TIMEOUT_MS;
+var init_renderer = __esm({
+  "src/commands/renderer.ts"() {
+    "use strict";
+    init_paths();
+    execAsync = promisify2(exec);
+    ARG_TOKEN_RE = /(?:"[^"]*"|'[^']*'|[^\s"']+)/g;
+    POSITIONAL_RE = /\$(\d+)/g;
+    HAS_POSITIONAL = /\$\d+/;
+    SHELL_RE = /!`([^`]+)`/g;
+    FILE_RE = /(?<![\w`])@(\.?[^\s`,]+?)([.,;:!?)\]}]*)(?=[\s`,]|$)/g;
+    DEFAULT_MAX_FILE_BYTES = 100 * 1024;
+    DEFAULT_SHELL_TIMEOUT_MS = 5e3;
+  }
+});
+
+// src/commands/save.ts
+import { mkdir as mkdir8, writeFile as writeFile8, unlink as unlink2 } from "fs/promises";
+import { dirname as dirname5 } from "path";
+async function saveCustomCommand(opts2) {
+  const dir = opts2.source === "project" ? projectCommandsDir(opts2.cwd) : globalCommandsDir();
+  const filepath = `${dir}/${opts2.name}.md`;
+  const data = {};
+  if (opts2.description) data.description = opts2.description;
+  if (opts2.mode) data.mode = opts2.mode;
+  if (opts2.model) data.model = opts2.model;
+  if (opts2.effort) data.effort = opts2.effort;
+  const frontmatter = serializeFrontmatter(data);
+  const content = frontmatter + opts2.template;
+  await mkdir8(dirname5(filepath), { recursive: true });
+  await writeFile8(filepath, content, "utf8");
+  return { filepath };
+}
+async function deleteCustomCommand(cmd) {
+  await unlink2(cmd.filepath);
+}
+var init_save = __esm({
+  "src/commands/save.ts"() {
+    "use strict";
+    init_frontmatter();
+    init_loader();
+  }
+});
+
+// src/ui/command-wizard.tsx
+import { useState as useState7 } from "react";
+import { Box as Box13, Text as Text14, useInput as useInput3, useWindowSize as useWindowSize2 } from "ink";
+import SelectInput5 from "ink-select-input";
+import { Fragment as Fragment2, jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
+function CommandWizard({ theme, mode, initial, existingNames, builtinNames, onDone, onSave }) {
+  const [step, setStep] = useState7("name");
+  const [name, setName] = useState7(initial?.name ?? "");
+  const [description, setDescription] = useState7(initial?.description ?? "");
+  const [template, setTemplate] = useState7(initial?.template ?? "");
+  const [cmdMode, setCmdMode] = useState7(initial?.mode);
+  const [cmdEffort, setCmdEffort] = useState7(initial?.effort);
+  const [cmdModel, setCmdModel] = useState7(initial?.model);
+  const [source, setSource] = useState7(initial?.source ?? "project");
+  const [error, setError] = useState7(null);
+  const { columns } = useWindowSize2();
+  const totalSteps = 5;
+  const stepIndex = step === "name" ? 1 : step === "description" ? 2 : step === "template" ? 3 : step === "advanced" || step === "mode" || step === "effort" || step === "model" ? 4 : step === "location" ? 4 : 5;
+  const isEditingSelf = (n) => initial !== void 0 && initial.name === n;
+  const validateName = (n) => {
+    const trimmed = n.trim();
+    if (!trimmed) return "name is required";
+    if (!NAME_RE.test(trimmed)) return "invalid name: use letters, numbers, _ - / only; must start with a letter";
+    if (builtinNames.has(trimmed.toLowerCase())) return `/${trimmed} is a built-in command`;
+    if (existingNames.includes(trimmed) && !isEditingSelf(trimmed)) return `/${trimmed} already exists`;
+    return null;
+  };
+  useInput3((_input, key) => {
+    if (key.escape) {
+      onDone();
+    }
+  });
+  const handleNameSubmit = (value) => {
+    const trimmed = value.trim();
+    const err = validateName(trimmed);
+    if (err) {
+      setError(err);
+      return;
+    }
+    setError(null);
+    setName(trimmed);
+    setStep("description");
+  };
+  const handleDescriptionSubmit = (value) => {
+    setDescription(value.trim());
+    setStep("template");
+  };
+  const handleTemplateSubmit = (value) => {
+    const trimmed = value.trim();
+    if (!trimmed) {
+      setError("template cannot be empty");
+      return;
+    }
+    setError(null);
+    setTemplate(trimmed);
+    setStep("advanced");
+  };
+  const handleAdvancedChoice = (choice) => {
+    if (choice === "skip") {
+      setCmdMode(void 0);
+      setCmdEffort(void 0);
+      setCmdModel("");
+      if (mode === "edit" && initial) {
+        setSource(initial.source);
+        setStep("confirm");
+      } else {
+        setStep("location");
+      }
+    } else {
+      setStep("mode");
+    }
+  };
+  const handleModeChoice = (m) => {
+    setCmdMode(m === "none" ? void 0 : m);
+    setStep("effort");
+  };
+  const handleEffortChoice = (e) => {
+    setCmdEffort(e === "none" ? void 0 : e);
+    setStep("model");
+  };
+  const handleModelSubmit = (value) => {
+    const trimmed = value.trim();
+    setCmdModel(trimmed || void 0);
+    if (mode === "edit" && initial) {
+      setSource(initial.source);
+      setStep("confirm");
+    } else {
+      setStep("location");
+    }
+  };
+  const handleLocationChoice = (s) => {
+    setSource(s);
+    setStep("confirm");
+  };
+  const handleConfirm = (choice) => {
+    if (choice === "cancel") {
+      onDone();
+      return;
+    }
+    onSave({
+      name,
+      description: description || void 0,
+      template,
+      source,
+      mode: cmdMode,
+      model: cmdModel || void 0,
+      effort: cmdEffort
+    });
+  };
+  const previewContent = () => {
+    const data = {};
+    if (description) data.description = description;
+    if (cmdMode) data.mode = cmdMode;
+    if (cmdModel) data.model = cmdModel;
+    if (cmdEffort) data.effort = cmdEffort;
+    const fm = Object.entries(data).map(([k, v]) => `${k}: ${v}`).join("\n");
+    if (fm) {
+      return `---
+${fm}
+---
+${template}`;
+    }
+    return template;
+  };
+  const renderStep = () => {
+    switch (step) {
+      case "name":
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            mode === "create" ? "Create" : "Edit",
+            " custom command \u2014 Name (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          error && /* @__PURE__ */ jsx14(Text14, { color: theme.error, children: error }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            CustomTextInput,
+            {
+              value: name,
+              onChange: setName,
+              onSubmit: handleNameSubmit,
+              focus: true
+            }
+          ) }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "letters, numbers, _ - / only; must start with a letter" })
+        ] });
+      case "description":
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            mode === "create" ? "Create" : "Edit",
+            " custom command \u2014 Description (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            CustomTextInput,
+            {
+              value: description,
+              onChange: setDescription,
+              onSubmit: handleDescriptionSubmit,
+              focus: true
+            }
+          ) }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Press Enter to skip" })
+        ] });
+      case "template": {
+        const guide = /* @__PURE__ */ jsxs13(Box13, { flexDirection: "column", paddingLeft: 1, children: [
+          /* @__PURE__ */ jsx14(Text14, { color: theme.accent, bold: true, children: "What is this?" }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "A prompt template \u2014 instructions to the AI." }),
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+            "When you type /",
+            name || "yourcommand",
+            " later, this gets sent to the model."
+          ] }),
+          /* @__PURE__ */ jsxs13(Box13, { marginTop: 1, flexDirection: "column", children: [
+            /* @__PURE__ */ jsx14(Text14, { color: theme.accent, bold: true, children: "Variables" }),
+            /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+              "  ",
+              "$1, $2 ...     \u2192 arguments you type"
+            ] }),
+            /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+              "  ",
+              "$ARGUMENTS     \u2192 everything after the command"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs13(Box13, { marginTop: 1, flexDirection: "column", children: [
+            /* @__PURE__ */ jsx14(Text14, { color: theme.accent, bold: true, children: "Dynamic inlines" }),
+            /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+              "  ",
+              "!`git diff`    \u2192 shell output inlined"
+            ] }),
+            /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+              "  ",
+              "@README.md     \u2192 file contents inlined"
+            ] })
+          ] }),
+          /* @__PURE__ */ jsxs13(Box13, { marginTop: 1, flexDirection: "column", children: [
+            /* @__PURE__ */ jsx14(Text14, { color: theme.accent, bold: true, children: "Example" }),
+            /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Review this PR diff:" }),
+            /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "!`git diff main...HEAD`" }),
+            /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Focus on: $1" })
+          ] })
+        ] });
+        const inputArea = /* @__PURE__ */ jsxs13(Box13, { flexDirection: "column", flexGrow: 1, children: [
+          error && /* @__PURE__ */ jsx14(Text14, { color: theme.error, children: error }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            CustomTextInput,
+            {
+              value: template,
+              onChange: setTemplate,
+              onSubmit: handleTemplateSubmit,
+              focus: true,
+              enablePaste: true
+            }
+          ) }),
+          columns < 100 && /* @__PURE__ */ jsxs13(Fragment2, { children: [
+            /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Paste multi-line templates with Ctrl+V." }),
+            /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Variables: $1 $2 ... $ARGUMENTS  Shell: !`cmd`  File: @path" })
+          ] })
+        ] });
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            mode === "create" ? "Create" : "Edit",
+            " custom command \u2014 Template (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          columns >= 100 ? /* @__PURE__ */ jsxs13(Box13, { flexDirection: "row", marginTop: 1, children: [
+            /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", width: "50%", children: inputArea }),
+            /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", width: "50%", children: guide })
+          ] }) : /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", marginTop: 1, children: inputArea })
+        ] });
+      }
+      case "advanced": {
+        const items = [
+          { label: "Set advanced options", value: "set", key: "set" },
+          { label: "Skip", value: "skip", key: "skip" },
+          { label: "\u2190 Cancel", value: "cancel", key: "cancel" }
+        ];
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            mode === "create" ? "Create" : "Edit",
+            " custom command \u2014 Options (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            SelectInput5,
+            {
+              items,
+              onSelect: (item) => {
+                if (item.value === "cancel") onDone();
+                else handleAdvancedChoice(item.value);
+              }
+            }
+          ) })
+        ] });
+      }
+      case "mode": {
+        const items = [
+          { label: cmdMode === void 0 ? "none \xB7 current" : "none", value: "none", key: "none" },
+          { label: cmdMode === "edit" ? "edit \xB7 current" : "edit", value: "edit", key: "edit" },
+          { label: cmdMode === "plan" ? "plan \xB7 current" : "plan", value: "plan", key: "plan" },
+          { label: cmdMode === "auto" ? "auto \xB7 current" : "auto", value: "auto", key: "auto" },
+          { label: "\u2190 Back", value: "__back__", key: "__back__" }
+        ];
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            "Mode override (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Saved to file but not yet enforced at runtime" }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            SelectInput5,
+            {
+              items,
+              onSelect: (item) => {
+                if (item.value === "__back__") setStep("advanced");
+                else handleModeChoice(item.value);
+              }
+            }
+          ) })
+        ] });
+      }
+      case "effort": {
+        const items = [
+          { label: cmdEffort === void 0 ? "none \xB7 current" : "none", value: "none", key: "none" },
+          { label: cmdEffort === "low" ? "low \xB7 current" : "low", value: "low", key: "low" },
+          { label: cmdEffort === "medium" ? "medium \xB7 current" : "medium", value: "medium", key: "medium" },
+          { label: cmdEffort === "high" ? "high \xB7 current" : "high", value: "high", key: "high" },
+          { label: "\u2190 Back", value: "__back__", key: "__back__" }
+        ];
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            "Reasoning effort (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            SelectInput5,
+            {
+              items,
+              onSelect: (item) => {
+                if (item.value === "__back__") setStep("mode");
+                else handleEffortChoice(item.value);
+              }
+            }
+          ) })
+        ] });
+      }
+      case "model":
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            "Model override (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            CustomTextInput,
+            {
+              value: cmdModel ?? "",
+              onChange: setCmdModel,
+              onSubmit: handleModelSubmit,
+              focus: true
+            }
+          ) }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Press Enter to skip" })
+        ] });
+      case "location": {
+        const items = [
+          { label: source === "project" ? "Project \xB7 current" : "Project", value: "project", key: "project" },
+          { label: source === "global" ? "Global \xB7 current" : "Global", value: "global", key: "global" },
+          { label: "\u2190 Back", value: "__back__", key: "__back__" }
+        ];
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            "Save location (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            SelectInput5,
+            {
+              items,
+              onSelect: (item) => {
+                if (item.value === "__back__") setStep("advanced");
+                else handleLocationChoice(item.value);
+              }
+            }
+          ) }),
+          /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: "Project: .kimiflare/commands/    Global: ~/.config/kimiflare/commands/" })
+        ] });
+      }
+      case "confirm": {
+        const items = [
+          { label: "Save", value: "save", key: "save" },
+          { label: "Cancel", value: "cancel", key: "cancel" }
+        ];
+        return /* @__PURE__ */ jsxs13(Fragment2, { children: [
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.accent, bold: true, children: [
+            mode === "create" ? "Create" : "Edit",
+            " custom command \u2014 Confirm (",
+            stepIndex,
+            "/",
+            totalSteps,
+            ")"
+          ] }),
+          /* @__PURE__ */ jsxs13(Text14, { color: theme.info.color, dimColor: true, children: [
+            source === "project" ? ".kimiflare/commands/" : "~/.config/kimiflare/commands/",
+            name,
+            ".md"
+          ] }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, flexDirection: "column", children: previewContent().split("\n").map((line, i) => /* @__PURE__ */ jsx14(Text14, { color: theme.info.color, dimColor: true, children: line || " " }, i)) }),
+          /* @__PURE__ */ jsx14(Box13, { marginTop: 1, children: /* @__PURE__ */ jsx14(
+            SelectInput5,
+            {
+              items,
+              onSelect: (item) => handleConfirm(item.value)
+            }
+          ) })
+        ] });
+      }
+    }
+  };
+  return /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: renderStep() });
+}
+var NAME_RE;
+var init_command_wizard = __esm({
+  "src/ui/command-wizard.tsx"() {
+    "use strict";
+    init_text_input();
+    NAME_RE = /^[a-zA-Z][a-zA-Z0-9_\-/]*$/;
+  }
+});
+
+// src/ui/command-picker.tsx
+import { Box as Box14, Text as Text15 } from "ink";
+import SelectInput6 from "ink-select-input";
+import { jsx as jsx15, jsxs as jsxs14 } from "react/jsx-runtime";
+function CommandPicker({ theme, commands, title, onPick }) {
+  const items = commands.map((cmd) => ({
+    label: `/${cmd.name.padEnd(20)} ${cmd.description ?? ""}`,
+    value: cmd,
+    key: cmd.name
+  }));
+  items.push({ label: "\u2190 Cancel", value: null, key: "__cancel__" });
+  return /* @__PURE__ */ jsxs14(Box14, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+    /* @__PURE__ */ jsx15(Text15, { color: theme.accent, bold: true, children: title }),
+    /* @__PURE__ */ jsx15(Text15, { color: theme.info.color, dimColor: false, children: "Arrow keys to navigate, Enter to select." }),
+    /* @__PURE__ */ jsx15(Box14, { marginTop: 1, children: /* @__PURE__ */ jsx15(
+      SelectInput6,
+      {
+        items,
+        onSelect: (item) => {
+          if (item.key === "__cancel__") {
+            onPick(null);
+          } else {
+            onPick(item.value);
+          }
+        }
+      }
+    ) })
+  ] });
+}
+var init_command_picker = __esm({
+  "src/ui/command-picker.tsx"() {
+    "use strict";
+  }
+});
+
+// src/ui/command-list.tsx
+import { Box as Box15, Text as Text16, useInput as useInput4 } from "ink";
+import { jsx as jsx16, jsxs as jsxs15 } from "react/jsx-runtime";
+function CommandList({ theme, commands, onDone }) {
+  useInput4((_input, key) => {
+    if (key.escape) {
+      onDone();
+    }
+  });
+  return /* @__PURE__ */ jsxs15(Box15, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+    /* @__PURE__ */ jsx16(Text16, { color: theme.accent, bold: true, children: "Custom commands" }),
+    /* @__PURE__ */ jsx16(Text16, { color: theme.info.color, dimColor: false, children: "Esc to close." }),
+    /* @__PURE__ */ jsxs15(Box15, { marginTop: 1, flexDirection: "column", children: [
+      commands.length === 0 && /* @__PURE__ */ jsx16(Text16, { color: theme.info.color, dimColor: true, children: "No custom commands found." }),
+      commands.map((cmd) => /* @__PURE__ */ jsxs15(Box15, { flexDirection: "column", marginBottom: 1, children: [
+        /* @__PURE__ */ jsxs15(Text16, { color: theme.accent, bold: true, children: [
+          "/",
+          cmd.name
+        ] }),
+        /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "source:  ",
+          cmd.source
+        ] }),
+        /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "path:    ",
+          cmd.filepath
+        ] }),
+        cmd.description && /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "desc:    ",
+          cmd.description
+        ] }),
+        cmd.mode && /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "mode:    ",
+          cmd.mode
+        ] }),
+        cmd.effort && /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "effort:  ",
+          cmd.effort
+        ] }),
+        cmd.model && /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "model:   ",
+          cmd.model
+        ] }),
+        /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "  ",
+          "template:"
+        ] }),
+        cmd.template.split("\n").slice(0, 5).map((line, i) => /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "    ",
+          line || " "
+        ] }, i)),
+        cmd.template.split("\n").length > 5 && /* @__PURE__ */ jsxs15(Text16, { color: theme.info.color, dimColor: true, children: [
+          "    ",
+          "..."
+        ] })
+      ] }, cmd.name))
+    ] })
+  ] });
+}
+var init_command_list = __esm({
+  "src/ui/command-list.tsx"() {
+    "use strict";
+  }
+});
+
+// src/app.tsx
+var app_exports = {};
+__export(app_exports, {
+  renderApp: () => renderApp
+});
+import { useState as useState8, useRef as useRef3, useEffect as useEffect4, useCallback } from "react";
+import { Box as Box16, Text as Text17, useApp, useInput as useInput5, render } from "ink";
+import SelectInput7 from "ink-select-input";
+import { existsSync } from "fs";
+import { join as join13 } from "path";
+import { unlink as unlink3 } from "fs/promises";
+import { spawn as spawn2 } from "child_process";
+import { platform as platform2 } from "os";
+import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
+function gatewayFromConfig(cfg) {
+  if (!cfg.aiGatewayId) return void 0;
+  return {
+    id: cfg.aiGatewayId,
+    cacheTtl: cfg.aiGatewayCacheTtl,
+    skipCache: cfg.aiGatewaySkipCache,
+    collectLogPayload: cfg.aiGatewayCollectLogPayload,
+    metadata: cfg.aiGatewayMetadata
+  };
+}
+function gatewayUsageLookupFromConfig(cfg, meta) {
+  if (!cfg.aiGatewayId || !meta) return void 0;
+  return {
+    accountId: cfg.accountId,
+    apiToken: cfg.apiToken,
+    gatewayId: cfg.aiGatewayId,
+    meta
+  };
+}
+function openBrowser(url) {
+  const cmd = platform2() === "darwin" ? "open" : platform2() === "win32" ? "start" : "xdg-open";
+  const child = spawn2(cmd, [url], { detached: true, stdio: "ignore" });
+  child.unref();
+}
+function capEvents(prev) {
+  if (prev.length <= MAX_EVENTS) return prev;
+  return prev.slice(prev.length - MAX_EVENTS);
+}
+function compactEventsVisual(prev, keepLastTurns) {
+  let seen = 0;
+  let cutoff = -1;
+  for (let i = prev.length - 1; i >= 0; i--) {
+    if (prev[i].kind === "user") {
+      seen++;
+      if (seen === keepLastTurns + 1) {
+        cutoff = i;
+        break;
+      }
+    }
+  }
+  if (cutoff <= 0) return prev;
+  const kept = prev.slice(cutoff);
+  return [
+    { kind: "info", key: mkKey(), text: `\xB7\xB7\xB7 ${cutoff} earlier messages compacted \xB7\xB7\xB7` },
+    ...kept
+  ];
+}
+function makePrefixMessages(cacheStable, model, mode, tools) {
+  if (cacheStable) {
+    return buildSystemMessages({ cwd: process.cwd(), tools, model, mode });
+  }
+  return [
+    {
+      role: "system",
+      content: buildSystemPrompt({ cwd: process.cwd(), tools, model, mode })
+    }
+  ];
+}
+function findImagePaths(text) {
+  const paths = [];
+  for (const token of text.split(/\s+/)) {
+    const clean = token.replace(/^["']|["',;:!?]$/g, "").replace(/[.,;:!?]$/, "");
+    if (isImagePath(clean) && existsSync(clean)) {
+      paths.push(clean);
+    }
+  }
+  return [...new Set(paths)];
+}
+function App({ initialCfg, initialUpdateResult }) {
+  const { exit } = useApp();
+  const [cfg, setCfg] = useState8(initialCfg);
+  const [events, setRawEvents] = useState8([]);
+  const setEvents = useCallback(
+    (updater) => {
+      setRawEvents((prev) => {
+        const next = typeof updater === "function" ? updater(prev) : updater;
+        return capEvents(next);
+      });
+    },
+    []
+  );
+  const [input, setInput] = useState8("");
+  const [busy, setBusy] = useState8(false);
+  const [usage, setUsage] = useState8(null);
+  const [sessionUsage, setSessionUsage] = useState8(null);
+  const [gatewayMeta, setGatewayMeta] = useState8(null);
+  const [showReasoning, setShowReasoning] = useState8(false);
+  const [perm, setPerm] = useState8(null);
+  const [queue, setQueue] = useState8([]);
+  const [history, setHistory] = useState8([]);
+  const [historyIndex, setHistoryIndex] = useState8(-1);
+  const [draftInput, setDraftInput] = useState8("");
+  const [mode, setMode] = useState8("edit");
+  const [codeMode, setCodeMode] = useState8(initialCfg?.codeMode ?? false);
+  const [effort, setEffort] = useState8(
+    initialCfg?.reasoningEffort ?? DEFAULT_REASONING_EFFORT
+  );
+  const [theme, setTheme] = useState8(resolveTheme(initialCfg?.theme));
+  const [resumeSessions, setResumeSessions] = useState8(null);
+  const [showThemePicker, setShowThemePicker] = useState8(false);
+  const [showHelpMenu, setShowHelpMenu] = useState8(false);
+  const [originalTheme, setOriginalTheme] = useState8(null);
+  const [commandWizard, setCommandWizard] = useState8(null);
+  const [commandPicker, setCommandPicker] = useState8(null);
+  const [commandToDelete, setCommandToDelete] = useState8(null);
+  const [showCommandList, setShowCommandList] = useState8(false);
+  const [tasks, setTasks] = useState8([]);
+  const [tasksStartedAt, setTasksStartedAt] = useState8(null);
+  const [tasksStartTokens, setTasksStartTokens] = useState8(0);
+  const [turnStartedAt, setTurnStartedAt] = useState8(null);
+  const [verbose, setVerbose] = useState8(false);
+  const [hasUpdate, setHasUpdate] = useState8(initialUpdateResult?.hasUpdate ?? false);
+  const [latestVersion, setLatestVersion] = useState8(initialUpdateResult?.latestVersion ?? null);
+  const cacheStableRef = useRef3(initialCfg?.cacheStablePrompts !== false);
+  const messagesRef = useRef3(
+    makePrefixMessages(cacheStableRef.current, cfg?.model ?? DEFAULT_MODEL, "edit", ALL_TOOLS)
+  );
+  const executorRef = useRef3(new ToolExecutor(ALL_TOOLS));
+  const activeAsstIdRef = useRef3(null);
   const activeControllerRef = useRef3(null);
   const sessionIdRef = useRef3(null);
   const modeRef = useRef3(mode);
@@ -7076,8 +8359,10 @@ function App({ initialCfg, initialUpdateResult }) {
   const mcpToolsRef = useRef3([]);
   const mcpInitRef = useRef3(false);
   const memoryManagerRef = useRef3(null);
+  const sessionStartRecallRef = useRef3(null);
   const pendingTextRef = useRef3(/* @__PURE__ */ new Map());
   const flushTimeoutRef = useRef3(null);
+  const customCommandsRef = useRef3([]);
   useEffect4(() => {
     if (!cfg) return;
     void Promise.resolve().then(() => (init_sessions(), sessions_exports)).then(
@@ -7104,12 +8389,13 @@ function App({ initialCfg, initialUpdateResult }) {
       }
     });
     if (cfg.memoryEnabled) {
-      const dbPath = cfg.memoryDbPath ?? join12(process.cwd(), ".kimiflare", "memory.db");
+      const dbPath = cfg.memoryDbPath ?? join13(process.cwd(), ".kimiflare", "memory.db");
       const manager = new MemoryManager({
         dbPath,
         accountId: cfg.accountId,
         apiToken: cfg.apiToken,
         model: cfg.model,
+        plumbingModel: cfg.plumbingModel,
         embeddingModel: cfg.memoryEmbeddingModel,
         gateway: gatewayFromConfig(cfg),
         maxAgeDays: cfg.memoryMaxAgeDays ?? RETENTION.memoryMaxAgeDays,
@@ -7122,7 +8408,7 @@ function App({ initialCfg, initialUpdateResult }) {
         if (total > 0) {
           setEvents((e) => [
             ...e,
-            { kind: "info", key: mkKey(), text: `memory cleanup: removed ${total} stale entries` }
+            { kind: "memory", key: mkKey(), text: `memory cleanup: removed ${total} stale entries` }
           ]);
         }
       });
@@ -7130,15 +8416,59 @@ function App({ initialCfg, initialUpdateResult }) {
         if (fixed > 0) {
           setEvents((e) => [
             ...e,
-            { kind: "info", key: mkKey(), text: `memory backfill: embedded ${fixed} un-vectorized entries` }
+            { kind: "memory", key: mkKey(), text: `memory backfill: embedded ${fixed} un-vectorized entries` }
           ]);
         }
       });
+      const cwd = process.cwd();
+      sessionStartRecallRef.current = (async () => {
+        try {
+          const results = await manager.recall({ text: cwd, repoPath: cwd, limit: 5 });
+          if (results.length > 0) {
+            const text = await manager.synthesizeRecalled(results);
+            const lastSystemIdx = messagesRef.current.findLastIndex((m) => m.role === "system");
+            const insertIdx = lastSystemIdx >= 0 ? lastSystemIdx + 1 : messagesRef.current.length;
+            messagesRef.current.splice(insertIdx, 0, { role: "system", content: text });
+            setEvents((e) => [
+              ...e,
+              { kind: "memory", key: mkKey(), text: `recalled ${results.length} memory${results.length === 1 ? "" : "ies"} about this repo` }
+            ]);
+          }
+        } catch {
+        }
+      })();
     } else {
       memoryManagerRef.current?.close();
       memoryManagerRef.current = null;
     }
-  }, [cfg]);
+    void loadCustomCommands(process.cwd()).then(({ commands, warnings }) => {
+      customCommandsRef.current = commands;
+      for (const w of warnings) {
+        setEvents((e) => [...e, { kind: "info", key: mkKey(), text: `commands: ${w}` }]);
+      }
+      const shadowed = commands.filter((c) => BUILTIN_COMMAND_NAMES.has(c.name.toLowerCase()));
+      for (const c of shadowed) {
+        setEvents((e) => [
+          ...e,
+          { kind: "info", key: mkKey(), text: `commands: /${c.name} (${c.filepath}) shadowed by built-in \u2014 will not run` }
+        ]);
+      }
+    });
+  }, [cfg, setEvents]);
+  const reloadCustomCommands = useCallback(async () => {
+    const { commands, warnings } = await loadCustomCommands(process.cwd());
+    customCommandsRef.current = commands;
+    for (const w of warnings) {
+      setEvents((e) => [...e, { kind: "info", key: mkKey(), text: `commands: ${w}` }]);
+    }
+    const shadowed = commands.filter((c) => BUILTIN_COMMAND_NAMES.has(c.name.toLowerCase()));
+    for (const c of shadowed) {
+      setEvents((e) => [
+        ...e,
+        { kind: "info", key: mkKey(), text: `commands: /${c.name} (${c.filepath}) shadowed by built-in \u2014 will not run` }
+      ]);
+    }
+  }, [setEvents]);
   useEffect4(() => {
     if (!cfg || updateCheckedRef.current) return;
     updateCheckedRef.current = true;
@@ -7341,12 +8671,13 @@ function App({ initialCfg, initialUpdateResult }) {
         createdAt: (/* @__PURE__ */ new Date()).toISOString(),
         updatedAt: (/* @__PURE__ */ new Date()).toISOString(),
         messages: messagesRef.current,
-        sessionState: compiledContextRef.current ? sessionStateRef.current : void 0
+        sessionState: compiledContextRef.current ? sessionStateRef.current : void 0,
+        artifactStore: serializeArtifactStore(artifactStoreRef.current)
       });
     } catch {
     }
   }, [cfg, ensureSessionId]);
-  useInput2((inputChar, key) => {
+  useInput5((inputChar, key) => {
     if (key.ctrl && inputChar === "c") {
       if (busy && activeControllerRef.current) {
         activeControllerRef.current.abort();
@@ -7537,13 +8868,13 @@ function App({ initialCfg, initialUpdateResult }) {
     }
     const cwd = process.cwd();
     for (const name of ["KIMI.md", "KIMIFLARE.md", "AGENT.md"]) {
-      if (existsSync(join12(cwd, name))) {
+      if (existsSync(join13(cwd, name))) {
         setEvents((e) => [
           ...e,
           {
             kind: "info",
             key: mkKey(),
-            text: `${name} already exists at ${join12(cwd, name)} \u2014 delete it first if you want to regenerate`
+            text: `${name} already exists at ${join13(cwd, name)} \u2014 delete it first if you want to regenerate`
           }
         ]);
         return;
@@ -7671,7 +9002,7 @@ function App({ initialCfg, initialUpdateResult }) {
           })
         }
       });
-      if (existsSync(join12(cwd, "KIMI.md"))) {
+      if (existsSync(join13(cwd, "KIMI.md"))) {
         if (cacheStableRef.current) {
           messagesRef.current[1] = {
             role: "system",
@@ -7722,8 +9053,26 @@ function App({ initialCfg, initialUpdateResult }) {
         sessionIdRef.current = file.id;
         if (file.sessionState && compiledContextRef.current) {
           sessionStateRef.current = file.sessionState;
+        }
+        if (file.artifactStore) {
+          artifactStoreRef.current = deserializeArtifactStore(file.artifactStore);
+        } else {
           artifactStoreRef.current = new ArtifactStore();
         }
+        const manager = memoryManagerRef.current;
+        if (manager) {
+          try {
+            const cwd = process.cwd();
+            const results = await manager.recall({ text: cwd, repoPath: cwd, limit: 5 });
+            if (results.length > 0) {
+              const text = await manager.synthesizeRecalled(results);
+              const lastSystemIdx = messagesRef.current.findLastIndex((m) => m.role === "system");
+              const insertIdx = lastSystemIdx >= 0 ? lastSystemIdx + 1 : messagesRef.current.length;
+              messagesRef.current.splice(insertIdx, 0, { role: "system", content: text });
+            }
+          } catch {
+          }
+        }
         setEvents([
           {
             kind: "info",
@@ -8035,13 +9384,30 @@ use: /thinking low | medium | high`
         return true;
       }
       if (c === "/memory") {
-        if (!cfg?.memoryEnabled) {
-          setEvents((e) => [...e, { kind: "info", key: mkKey(), text: "memory is disabled. Enable with KIMIFLARE_MEMORY_ENABLED=1" }]);
+        if (!cfg) return true;
+        if (arg === "on") {
+          const next = { ...cfg, memoryEnabled: true };
+          setCfg(next);
+          void saveConfig(next).catch(() => {
+          });
+          setEvents((e) => [...e, { kind: "memory", key: mkKey(), text: "memory enabled" }]);
+          return true;
+        }
+        if (arg === "off") {
+          const next = { ...cfg, memoryEnabled: false };
+          setCfg(next);
+          void saveConfig(next).catch(() => {
+          });
+          setEvents((e) => [...e, { kind: "memory", key: mkKey(), text: "memory disabled" }]);
+          return true;
+        }
+        if (!cfg.memoryEnabled) {
+          setEvents((e) => [...e, { kind: "info", key: mkKey(), text: "memory is disabled. Use /memory on to enable it, or set KIMIFLARE_MEMORY_ENABLED=1" }]);
           return true;
         }
         if (arg === "clear") {
           const cleared = memoryManagerRef.current?.clearRepo(process.cwd()) ?? 0;
-          setEvents((e) => [...e, { kind: "info", key: mkKey(), text: `cleared ${cleared} memories for this repo` }]);
+          setEvents((e) => [...e, { kind: "memory", key: mkKey(), text: `cleared ${cleared} memories for this repo` }]);
           return true;
         }
         if (arg.startsWith("search ")) {
@@ -8176,7 +9542,7 @@ ${lines.join("\n")}` }]);
         return true;
       }
       if (c === "/logout") {
-        unlink2(configPath()).catch(() => {
+        unlink3(configPath()).catch(() => {
         });
         setEvents((e) => [
           ...e,
@@ -8185,28 +9551,123 @@ ${lines.join("\n")}` }]);
         setCfg(null);
         return true;
       }
-      if (c === "/help") {
+      if (c === "/command") {
+        const sub = rest[0]?.toLowerCase() ?? "";
+        if (sub === "create") {
+          setCommandWizard({ mode: "create" });
+          return true;
+        }
+        if (sub === "edit") {
+          setCommandPicker({ mode: "edit" });
+          return true;
+        }
+        if (sub === "delete") {
+          setCommandPicker({ mode: "delete" });
+          return true;
+        }
+        if (sub === "list") {
+          setShowCommandList(true);
+          return true;
+        }
         setEvents((e) => [
           ...e,
-          {
-            kind: "info",
-            key: mkKey(),
-            text: "commands:\n  /mode edit|plan|auto    switch mode (or shift+tab to cycle)\n  /plan /auto /edit       shortcuts for /mode\n  /thinking low|med|high  set reasoning effort (quality vs speed)\n  /theme                  interactive theme picker (or ctrl+t)\n  /theme NAME             set theme by name\n  /resume                 pick a past conversation\n  /compact                summarize old turns to free context\n  /init                   scan this repo and write a KIMI.md for future agents\n  /memory                 show memory stats\n  /memory search <query>  search stored memories\n  /memory clear           wipe memories for this repo\n  /mcp list               list connected MCP servers and tools\n  /mcp reload             reconnect all configured MCP servers\n  /reasoning              toggle show/hide model reasoning\n  /clear                  clear current conversation\n  /hello                  send a voice note to the creator\n  /community              join our Discord server\n  /gateway                show gateway status\n  /gateway ID             enable AI Gateway\n  /gateway off            disable AI Gateway (direct Workers AI)\n  /gateway cache-ttl N    set gateway cache TTL in seconds\n  /gateway skip-cache T|F set gateway skip-cache flag\n  /gateway collect-logs T|F  include payload in gateway logs\n  /gateway metadata K=V   add metadata key-value pair\n  /gateway metadata clear remove all metadata\n  /cost /model /update /logout /help /exit\nkeys: ctrl-c interrupt/exit \xB7 ctrl-r toggle reasoning \xB7 ctrl-o verbose \xB7 ctrl+t theme \xB7 shift+tab cycle mode \xB7 \u2191/\u2193 history"
-          }
+          { kind: "info", key: mkKey(), text: "usage: /command create | edit | delete | list" }
         ]);
         return true;
       }
+      if (c === "/help") {
+        setShowHelpMenu(true);
+        return true;
+      }
       return false;
     },
     [cfg, exit, usage, effort, theme, mode, openResumePicker, runCompact, runInit, initMcp, setCfg]
   );
+  const handleHelpCommand = useCallback(
+    (command) => {
+      setShowHelpMenu(false);
+      const executed = handleSlash(command);
+      if (!executed) {
+        setEvents((e) => [...e, { kind: "error", key: mkKey(), text: `unknown command: ${command}` }]);
+      }
+    },
+    [handleSlash]
+  );
+  const handleCommandSave = useCallback(
+    async (opts2) => {
+      setCommandWizard(null);
+      try {
+        if (commandWizard?.mode === "edit" && commandWizard.initial && commandWizard.initial.name !== opts2.name) {
+          await deleteCustomCommand(commandWizard.initial);
+        }
+        const result = await saveCustomCommand(opts2);
+        await reloadCustomCommands();
+        setEvents((e) => [
+          ...e,
+          { kind: "info", key: mkKey(), text: `saved /${opts2.name} \u2192 ${result.filepath}` }
+        ]);
+      } catch (err) {
+        setEvents((e) => [
+          ...e,
+          { kind: "error", key: mkKey(), text: `failed to save /${opts2.name}: ${err.message}` }
+        ]);
+      }
+    },
+    [commandWizard, reloadCustomCommands, setEvents]
+  );
+  const handleCommandDelete = useCallback(
+    async (cmd) => {
+      setCommandToDelete(null);
+      try {
+        await deleteCustomCommand(cmd);
+        await reloadCustomCommands();
+        setEvents((e) => [
+          ...e,
+          { kind: "info", key: mkKey(), text: `deleted /${cmd.name} (${cmd.filepath})` }
+        ]);
+      } catch (err) {
+        setEvents((e) => [
+          ...e,
+          { kind: "error", key: mkKey(), text: `failed to delete /${cmd.name}: ${err.message}` }
+        ]);
+      }
+    },
+    [reloadCustomCommands, setEvents]
+  );
   const processMessage = useCallback(
     async (text, displayText) => {
       if (!cfg) return;
-      const trimmed = text.trim();
+      let trimmed = text.trim();
       if (!trimmed) return;
-      if (trimmed.startsWith("/") && handleSlash(trimmed)) return;
-      const display = displayText?.trim() || trimmed;
+      let overrideModel;
+      let overrideEffort;
+      let display = displayText?.trim() || trimmed;
+      if (trimmed.startsWith("/")) {
+        if (handleSlash(trimmed)) return;
+        const head = trimmed.split(/\s+/)[0].slice(1);
+        const custom = customCommandsRef.current.find((c) => c.name === head);
+        if (custom) {
+          const info = (text2) => setEvents((e) => [...e, { kind: "info", key: mkKey(), text: text2 }]);
+          const { prompt: rendered, warnings } = await renderCommand(custom, trimmed, {
+            cwd: process.cwd()
+          });
+          for (const w of warnings) info(`${custom.name}: ${w}`);
+          if (!rendered.trim()) return;
+          const parts = [];
+          if (custom.model) {
+            overrideModel = custom.model;
+            parts.push(`model=${custom.model}`);
+          }
+          if (custom.effort) {
+            overrideEffort = custom.effort;
+            parts.push(`effort=${custom.effort}`);
+          }
+          if (parts.length > 0) info(`command '${custom.name}' \u2192 ${parts.join(", ")} (this turn)`);
+          if (custom.mode) info(`note: mode override (${custom.mode}) is not yet wired; current mode applies`);
+          display = trimmed;
+          trimmed = rendered;
+        }
+      }
       const imagePaths = findImagePaths(trimmed).slice(0, MAX_IMAGES_PER_MESSAGE);
       let images = [];
       let content = sanitizeString(trimmed);
@@ -8235,6 +9696,10 @@ ${lines.join("\n")}` }]);
           content = parts;
         }
       }
+      if (sessionStartRecallRef.current) {
+        await sessionStartRecallRef.current;
+        sessionStartRecallRef.current = null;
+      }
       setEvents((e) => [...e, { kind: "user", key: mkKey(), text: display, images: images.length > 0 ? images : void 0 }]);
       messagesRef.current.push({ role: "user", content });
       if (compiledContextRef.current) {
@@ -8258,14 +9723,14 @@ ${lines.join("\n")}` }]);
         await runAgentTurn({
           accountId: cfg.accountId,
           apiToken: cfg.apiToken,
-          model: cfg.model,
+          model: overrideModel ?? cfg.model,
           gateway: gatewayFromConfig(cfg),
           messages: messagesRef.current,
           tools: [...ALL_TOOLS, ...mcpToolsRef.current],
           executor: executorRef.current,
           cwd: process.cwd(),
           signal: controller.signal,
-          reasoningEffort: effortRef.current,
+          reasoningEffort: overrideEffort ?? effortRef.current,
           coauthor: cfg.coauthor !== false ? { name: cfg.coauthorName || "kimiflare", email: cfg.coauthorEmail || "kimiflare@proton.me" } : void 0,
           sessionId: ensureSessionId(),
           memoryManager: memoryManagerRef.current,
@@ -8370,24 +9835,84 @@ ${lines.join("\n")}` }]);
           }
         });
         await saveSessionSafe();
-        if (compiledContextRef.current && shouldCompact({ messages: messagesRef.current })) {
-          const result = compactMessages2({
-            messages: messagesRef.current,
-            state: sessionStateRef.current,
-            store: artifactStoreRef.current
-          });
-          if (result.metrics.rawTurnsRemoved > 0) {
-            messagesRef.current = result.newMessages;
-            sessionStateRef.current = result.newState;
-            setEvents((e) => [
-              ...e,
-              {
-                kind: "info",
-                key: mkKey(),
-                text: `auto-compacted: ${result.metrics.estimatedTokensBefore} \u2192 ${result.metrics.estimatedTokensAfter} tokens (${result.metrics.archivedArtifacts} artifacts)`
+        if (shouldCompact({ messages: messagesRef.current })) {
+          if (compiledContextRef.current) {
+            const result = compactMessages2({
+              messages: messagesRef.current,
+              state: sessionStateRef.current,
+              store: artifactStoreRef.current
+            });
+            if (result.metrics.rawTurnsRemoved > 0) {
+              messagesRef.current = result.newMessages;
+              sessionStateRef.current = result.newState;
+              setEvents((e) => [
+                ...e,
+                {
+                  kind: "info",
+                  key: mkKey(),
+                  text: `auto-compacted: ${result.metrics.estimatedTokensBefore} \u2192 ${result.metrics.estimatedTokensAfter} tokens (${result.metrics.archivedArtifacts} artifacts)`
+                }
+              ]);
+              await saveSessionSafe();
+            }
+          } else {
+            try {
+              const result = await compactMessages({
+                accountId: cfg.accountId,
+                apiToken: cfg.apiToken,
+                model: cfg.model,
+                messages: messagesRef.current,
+                signal: controller.signal,
+                gateway: gatewayFromConfig(cfg)
+              });
+              if (result.replacedCount > 0) {
+                messagesRef.current = result.newMessages;
+                setEvents((e) => [
+                  ...e,
+                  {
+                    kind: "info",
+                    key: mkKey(),
+                    text: `auto-compacted: ${result.replacedCount} messages summarized`
+                  }
+                ]);
+                await saveSessionSafe();
               }
-            ]);
-            await saveSessionSafe();
+            } catch (compactErr) {
+              if (compactErr.name !== "AbortError") {
+                setEvents((es) => [
+                  ...es,
+                  {
+                    kind: "info",
+                    key: mkKey(),
+                    text: `auto-compact failed: ${compactErr.message ?? String(compactErr)}`
+                  }
+                ]);
+              }
+            }
+          }
+        }
+        const manager = memoryManagerRef.current;
+        if (manager) {
+          try {
+            const cwd = process.cwd();
+            const queryText = sessionStateRef.current.task || cwd;
+            const results = await manager.recall({ text: queryText, repoPath: cwd, limit: 5 });
+            if (results.length > 0) {
+              const text2 = await manager.synthesizeRecalled(results);
+              const lastSystemIdx = messagesRef.current.findLastIndex((m) => m.role === "system");
+              const insertIdx = lastSystemIdx >= 0 ? lastSystemIdx + 1 : messagesRef.current.length;
+              messagesRef.current.splice(insertIdx, 0, { role: "system", content: text2 });
+              setEvents((e) => [
+                ...e,
+                {
+                  kind: "memory",
+                  key: mkKey(),
+                  text: `recalled ${results.length} memory${results.length === 1 ? "" : "ies"} after compaction`
+                }
+              ]);
+              await saveSessionSafe();
+            }
+          } catch {
           }
         }
       } catch (e) {
@@ -8463,7 +9988,7 @@ ${lines.join("\n")}` }]);
     }
   }, [usage]);
   if (!cfg) {
-    return /* @__PURE__ */ jsx13(
+    return /* @__PURE__ */ jsx17(
       Onboarding,
       {
         onDone: (newCfg) => {
@@ -8477,15 +10002,97 @@ ${lines.join("\n")}` }]);
     );
   }
   if (resumeSessions !== null) {
-    return /* @__PURE__ */ jsx13(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsx13(ResumePicker, { sessions: resumeSessions, onPick: handleResumePick, theme }) });
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(ResumePicker, { sessions: resumeSessions, onPick: handleResumePick, theme }) });
   }
   if (showThemePicker) {
-    return /* @__PURE__ */ jsx13(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsx13(ThemePicker, { themes: themeList(), current: theme, onPick: handleThemePick, onPreview: (t) => setTheme(t) }) });
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(ThemePicker, { themes: themeList(), current: theme, onPick: handleThemePick, onPreview: (t) => setTheme(t) }) });
+  }
+  if (showHelpMenu) {
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(
+      HelpMenu,
+      {
+        theme,
+        themes: themeList().map((t) => ({ name: t.name, label: t.label })),
+        currentThemeName: theme.name,
+        customCommands: customCommandsRef.current.filter((c) => !BUILTIN_COMMAND_NAMES.has(c.name.toLowerCase())).map((c) => ({ name: c.name, description: c.description })),
+        onDone: () => setShowHelpMenu(false),
+        onCommand: handleHelpCommand
+      }
+    ) });
+  }
+  if (commandWizard) {
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(
+      CommandWizard,
+      {
+        theme,
+        mode: commandWizard.mode,
+        initial: commandWizard.initial,
+        existingNames: customCommandsRef.current.map((c) => c.name),
+        builtinNames: BUILTIN_COMMAND_NAMES,
+        onDone: () => setCommandWizard(null),
+        onSave: handleCommandSave
+      }
+    ) });
+  }
+  if (commandPicker) {
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(
+      CommandPicker,
+      {
+        theme,
+        commands: customCommandsRef.current,
+        title: commandPicker.mode === "edit" ? "Edit custom command" : "Delete custom command",
+        onPick: (cmd) => {
+          setCommandPicker(null);
+          if (!cmd) return;
+          if (commandPicker.mode === "edit") {
+            setCommandWizard({ mode: "edit", initial: cmd });
+          } else {
+            setCommandToDelete(cmd);
+          }
+        }
+      }
+    ) });
+  }
+  if (commandToDelete) {
+    return /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", borderStyle: "round", borderColor: theme.accent, paddingX: 1, children: [
+      /* @__PURE__ */ jsxs16(Text17, { color: theme.accent, bold: true, children: [
+        "Delete /",
+        commandToDelete.name,
+        "?"
+      ] }),
+      /* @__PURE__ */ jsx17(Text17, { color: theme.info.color, dimColor: true, children: commandToDelete.filepath }),
+      /* @__PURE__ */ jsx17(Box16, { marginTop: 1, children: /* @__PURE__ */ jsx17(
+        SelectInput7,
+        {
+          items: [
+            { label: "Yes, delete", value: "yes", key: "yes" },
+            { label: "Cancel", value: "cancel", key: "cancel" }
+          ],
+          onSelect: (item) => {
+            if (item.value === "yes") {
+              void handleCommandDelete(commandToDelete);
+            } else {
+              setCommandToDelete(null);
+            }
+          }
+        }
+      ) })
+    ] });
+  }
+  if (showCommandList) {
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(
+      CommandList,
+      {
+        theme,
+        commands: customCommandsRef.current,
+        onDone: () => setShowCommandList(false)
+      }
+    ) });
   }
   const hasConversation = events.some((e) => e.kind === "user" || e.kind === "assistant");
-  return /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", children: [
-    !hasConversation && events.length === 0 ? /* @__PURE__ */ jsx13(Welcome, { theme, accountId: cfg.accountId }) : /* @__PURE__ */ jsx13(ChatView, { events, showReasoning, theme, verbose }),
-    perm ? /* @__PURE__ */ jsx13(
+  return /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", children: [
+    !hasConversation && events.length === 0 ? /* @__PURE__ */ jsx17(Welcome, { theme, accountId: cfg.accountId }) : /* @__PURE__ */ jsx17(ChatView, { events, showReasoning, theme, verbose }),
+    perm ? /* @__PURE__ */ jsx17(
       PermissionModal,
       {
         tool: perm.tool,
@@ -8496,8 +10103,8 @@ ${lines.join("\n")}` }]);
           setPerm(null);
         }
       }
-    ) : /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", marginTop: 1, children: [
-      tasks.length > 0 && /* @__PURE__ */ jsx13(
+    ) : /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", marginTop: 1, children: [
+      tasks.length > 0 && /* @__PURE__ */ jsx17(
         TaskList,
         {
           tasks,
@@ -8506,11 +10113,11 @@ ${lines.join("\n")}` }]);
           tokensDelta: Math.max(0, (usage?.prompt_tokens ?? 0) - tasksStartTokens)
         }
       ),
-      queue.length > 0 && /* @__PURE__ */ jsx13(Box12, { flexDirection: "column", marginBottom: 1, children: queue.map((q, i) => /* @__PURE__ */ jsxs12(Text13, { color: theme.queue.color, dimColor: theme.queue.dim, children: [
+      queue.length > 0 && /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", marginBottom: 1, children: queue.map((q, i) => /* @__PURE__ */ jsxs16(Text17, { color: theme.queue.color, dimColor: theme.queue.dim, children: [
         "\u23F3 ",
         q.display
       ] }, `queue_${i}`)) }),
-      /* @__PURE__ */ jsx13(
+      /* @__PURE__ */ jsx17(
         StatusBar,
         {
           model: cfg.model,
@@ -8528,9 +10135,9 @@ ${lines.join("\n")}` }]);
           codeMode
         }
       ),
-      /* @__PURE__ */ jsxs12(Box12, { marginTop: 1, children: [
-        /* @__PURE__ */ jsx13(Text13, { color: theme.accent, children: "\u203A " }),
-        /* @__PURE__ */ jsx13(
+      /* @__PURE__ */ jsxs16(Box16, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx17(Text17, { color: theme.accent, children: "\u203A " }),
+        /* @__PURE__ */ jsx17(
           CustomTextInput,
           {
             value: input,
@@ -8579,12 +10186,12 @@ ${lines.join("\n")}` }]);
   ] });
 }
 async function renderApp(cfg, updateResult) {
-  const instance = render(/* @__PURE__ */ jsx13(App, { initialCfg: cfg, initialUpdateResult: updateResult }), {
+  const instance = render(/* @__PURE__ */ jsx17(App, { initialCfg: cfg, initialUpdateResult: updateResult }), {
     incrementalRendering: true
   });
   await instance.waitUntilExit();
 }
-var FEEDBACK_WORKER_URL, CONTEXT_LIMIT, AUTO_COMPACT_SUGGEST_PCT, MAX_EVENTS, nextAssistantId, nextKey, mkKey, MAX_IMAGES_PER_MESSAGE, EFFORT_DESCRIPTIONS;
+var FEEDBACK_WORKER_URL, CONTEXT_LIMIT, AUTO_COMPACT_SUGGEST_PCT, MAX_EVENTS, nextAssistantId, nextKey, mkKey, MAX_IMAGES_PER_MESSAGE, BUILTIN_COMMAND_NAMES, EFFORT_DESCRIPTIONS;
 var init_app = __esm({
   "src/app.tsx"() {
     "use strict";
@@ -8607,6 +10214,7 @@ var init_app = __esm({
     init_update_check();
     init_onboarding();
     init_welcome();
+    init_help_menu();
     init_config();
     init_theme();
     init_mode();
@@ -8617,6 +10225,12 @@ var init_app = __esm({
     init_storage_limits();
     init_state();
     init_version();
+    init_loader();
+    init_renderer();
+    init_save();
+    init_command_wizard();
+    init_command_picker();
+    init_command_list();
     FEEDBACK_WORKER_URL = "https://kimiflare-feedback.sina-b35.workers.dev";
     CONTEXT_LIMIT = 262e3;
     AUTO_COMPACT_SUGGEST_PCT = 0.8;
@@ -8625,6 +10239,32 @@ var init_app = __esm({
     nextKey = 1;
     mkKey = () => `evt_${nextKey++}`;
     MAX_IMAGES_PER_MESSAGE = 10;
+    BUILTIN_COMMAND_NAMES = /* @__PURE__ */ new Set([
+      "exit",
+      "quit",
+      "clear",
+      "reasoning",
+      "cost",
+      "model",
+      "thinking",
+      "effort",
+      "theme",
+      "mode",
+      "plan",
+      "auto",
+      "edit",
+      "resume",
+      "compact",
+      "init",
+      "update",
+      "mcp",
+      "logout",
+      "help",
+      "memory",
+      "gateway",
+      "hello",
+      "community"
+    ]);
     EFFORT_DESCRIPTIONS = {
       low: "low \u2014 fastest; lightest reasoning. Best for simple Q&A, small edits, quick coordination.",
       medium: "medium \u2014 balanced (default). Solid quality on most edits, fast on trivial prompts.",