kimiflare 0.24.0 → 0.25.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;
@@ -152,10 +151,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 +173,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 +209,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";
@@ -1027,8 +1027,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 +1110,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 +1119,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);
@@ -1711,6 +1711,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 +2842,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 +2954,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 +3114,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;
@@ -3577,11 +3608,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);
       }
     }
   }
@@ -4153,14 +4185,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 +4942,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 +5399,235 @@ 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: "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: "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];
@@ -6932,19 +7193,358 @@ var init_state = __esm({
   }
 });
 
+// src/commands/frontmatter.ts
+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 };
+}
+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 {
+    commands: [...byName.values()].sort((a, b) => a.name.localeCompare(b.name)),
+    warnings
+  };
+}
+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;
+}
+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;
+  }
+  const name = filenameToCommandName(file, rootDir);
+  if (!name) {
+    warnings.push(`invalid command name from ${file}`);
+    return null;
+  }
+  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`);
+    }
+  }
+  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 cmd;
+}
+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/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 { useState as useState7, useRef as useRef3, useEffect as useEffect4, useCallback } from "react";
+import { Box as Box13, Text as Text14, useApp, useInput as useInput3, render } from "ink";
 import { existsSync } from "fs";
-import { join as join12 } from "path";
+import { join as join13 } 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";
+import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
 function gatewayFromConfig(cfg) {
   if (!cfg.aiGatewayId) return void 0;
   return {
@@ -7015,8 +7615,8 @@ function findImagePaths(text) {
 }
 function App({ initialCfg, initialUpdateResult }) {
   const { exit } = useApp();
-  const [cfg, setCfg] = useState6(initialCfg);
-  const [events, setRawEvents] = useState6([]);
+  const [cfg, setCfg] = useState7(initialCfg);
+  const [events, setRawEvents] = useState7([]);
   const setEvents = useCallback(
     (updater) => {
       setRawEvents((prev) => {
@@ -7026,33 +7626,34 @@ function App({ initialCfg, initialUpdateResult }) {
     },
     []
   );
-  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(
+  const [input, setInput] = useState7("");
+  const [busy, setBusy] = useState7(false);
+  const [usage, setUsage] = useState7(null);
+  const [sessionUsage, setSessionUsage] = useState7(null);
+  const [gatewayMeta, setGatewayMeta] = useState7(null);
+  const [showReasoning, setShowReasoning] = useState7(false);
+  const [perm, setPerm] = useState7(null);
+  const [queue, setQueue] = useState7([]);
+  const [history, setHistory] = useState7([]);
+  const [historyIndex, setHistoryIndex] = useState7(-1);
+  const [draftInput, setDraftInput] = useState7("");
+  const [mode, setMode] = useState7("edit");
+  const [codeMode, setCodeMode] = useState7(initialCfg?.codeMode ?? false);
+  const [effort, setEffort] = useState7(
     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 [theme, setTheme] = useState7(resolveTheme(initialCfg?.theme));
+  const [resumeSessions, setResumeSessions] = useState7(null);
+  const [showThemePicker, setShowThemePicker] = useState7(false);
+  const [showHelpMenu, setShowHelpMenu] = useState7(false);
+  const [originalTheme, setOriginalTheme] = useState7(null);
+  const [tasks, setTasks] = useState7([]);
+  const [tasksStartedAt, setTasksStartedAt] = useState7(null);
+  const [tasksStartTokens, setTasksStartTokens] = useState7(0);
+  const [turnStartedAt, setTurnStartedAt] = useState7(null);
+  const [verbose, setVerbose] = useState7(false);
+  const [hasUpdate, setHasUpdate] = useState7(initialUpdateResult?.hasUpdate ?? false);
+  const [latestVersion, setLatestVersion] = useState7(initialUpdateResult?.latestVersion ?? null);
   const cacheStableRef = useRef3(initialCfg?.cacheStablePrompts !== false);
   const messagesRef = useRef3(
     makePrefixMessages(cacheStableRef.current, cfg?.model ?? DEFAULT_MODEL, "edit", ALL_TOOLS)
@@ -7078,6 +7679,7 @@ function App({ initialCfg, initialUpdateResult }) {
   const memoryManagerRef = 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,7 +7706,7 @@ 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,
@@ -7138,7 +7740,20 @@ function App({ initialCfg, initialUpdateResult }) {
       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]);
   useEffect4(() => {
     if (!cfg || updateCheckedRef.current) return;
     updateCheckedRef.current = true;
@@ -7346,7 +7961,7 @@ function App({ initialCfg, initialUpdateResult }) {
     } catch {
     }
   }, [cfg, ensureSessionId]);
-  useInput2((inputChar, key) => {
+  useInput3((inputChar, key) => {
     if (key.ctrl && inputChar === "c") {
       if (busy && activeControllerRef.current) {
         activeControllerRef.current.abort();
@@ -7537,13 +8152,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 +8286,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",
@@ -8035,8 +8650,25 @@ 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: "info", 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: "info", 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") {
@@ -8186,27 +8818,57 @@ ${lines.join("\n")}` }]);
         return true;
       }
       if (c === "/help") {
-        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"
-          }
-        ]);
+        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 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);
@@ -8258,14 +8920,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 +9032,60 @@ ${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)}`
+                  }
+                ]);
+              }
+            }
           }
         }
       } catch (e) {
@@ -8463,7 +9161,7 @@ ${lines.join("\n")}` }]);
     }
   }, [usage]);
   if (!cfg) {
-    return /* @__PURE__ */ jsx13(
+    return /* @__PURE__ */ jsx14(
       Onboarding,
       {
         onDone: (newCfg) => {
@@ -8477,15 +9175,28 @@ ${lines.join("\n")}` }]);
     );
   }
   if (resumeSessions !== null) {
-    return /* @__PURE__ */ jsx13(Box12, { flexDirection: "column", children: /* @__PURE__ */ jsx13(ResumePicker, { sessions: resumeSessions, onPick: handleResumePick, theme }) });
+    return /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(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__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(ThemePicker, { themes: themeList(), current: theme, onPick: handleThemePick, onPreview: (t) => setTheme(t) }) });
+  }
+  if (showHelpMenu) {
+    return /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(
+      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
+      }
+    ) });
   }
   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__ */ jsxs13(Box13, { flexDirection: "column", children: [
+    !hasConversation && events.length === 0 ? /* @__PURE__ */ jsx14(Welcome, { theme, accountId: cfg.accountId }) : /* @__PURE__ */ jsx14(ChatView, { events, showReasoning, theme, verbose }),
+    perm ? /* @__PURE__ */ jsx14(
       PermissionModal,
       {
         tool: perm.tool,
@@ -8496,8 +9207,8 @@ ${lines.join("\n")}` }]);
           setPerm(null);
         }
       }
-    ) : /* @__PURE__ */ jsxs12(Box12, { flexDirection: "column", marginTop: 1, children: [
-      tasks.length > 0 && /* @__PURE__ */ jsx13(
+    ) : /* @__PURE__ */ jsxs13(Box13, { flexDirection: "column", marginTop: 1, children: [
+      tasks.length > 0 && /* @__PURE__ */ jsx14(
         TaskList,
         {
           tasks,
@@ -8506,11 +9217,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__ */ jsx14(Box13, { flexDirection: "column", marginBottom: 1, children: queue.map((q, i) => /* @__PURE__ */ jsxs13(Text14, { color: theme.queue.color, dimColor: theme.queue.dim, children: [
         "\u23F3 ",
         q.display
       ] }, `queue_${i}`)) }),
-      /* @__PURE__ */ jsx13(
+      /* @__PURE__ */ jsx14(
         StatusBar,
         {
           model: cfg.model,
@@ -8528,9 +9239,9 @@ ${lines.join("\n")}` }]);
           codeMode
         }
       ),
-      /* @__PURE__ */ jsxs12(Box12, { marginTop: 1, children: [
-        /* @__PURE__ */ jsx13(Text13, { color: theme.accent, children: "\u203A " }),
-        /* @__PURE__ */ jsx13(
+      /* @__PURE__ */ jsxs13(Box13, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx14(Text14, { color: theme.accent, children: "\u203A " }),
+        /* @__PURE__ */ jsx14(
           CustomTextInput,
           {
             value: input,
@@ -8579,12 +9290,12 @@ ${lines.join("\n")}` }]);
   ] });
 }
 async function renderApp(cfg, updateResult) {
-  const instance = render(/* @__PURE__ */ jsx13(App, { initialCfg: cfg, initialUpdateResult: updateResult }), {
+  const instance = render(/* @__PURE__ */ jsx14(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 +9318,7 @@ var init_app = __esm({
     init_update_check();
     init_onboarding();
     init_welcome();
+    init_help_menu();
     init_config();
     init_theme();
     init_mode();
@@ -8617,6 +9329,8 @@ var init_app = __esm({
     init_storage_limits();
     init_state();
     init_version();
+    init_loader();
+    init_renderer();
     FEEDBACK_WORKER_URL = "https://kimiflare-feedback.sina-b35.workers.dev";
     CONTEXT_LIMIT = 262e3;
     AUTO_COMPACT_SUGGEST_PCT = 0.8;
@@ -8625,6 +9339,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.",