kimiflare 0.25.0 → 0.26.0

package/dist/index.js

@@ -83,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 {
@@ -107,6 +108,7 @@ async function loadConfig() {
       memoryMaxAgeDays: envMemoryMaxAgeDays,
       memoryMaxEntries: envMemoryMaxEntries,
       memoryEmbeddingModel: envMemoryEmbeddingModel,
+      plumbingModel: envPlumbingModel,
       codeMode: envCodeMode
     };
   }
@@ -137,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
       };
     }
@@ -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   * ")}`);
@@ -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();
   }
 });
 
@@ -3236,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]"];
@@ -4101,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
@@ -5427,7 +5508,7 @@ function HelpMenu({ theme, themes, currentThemeName, customCommands, onDone, onC
       key: cat.key
     }));
     if (customs.length > 0) {
-      items2.push({ label: "Custom commands", value: "custom", key: "custom" });
+      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: [
@@ -5611,6 +5692,16 @@ var init_help_menu = __esm({
           { 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",
@@ -6425,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];
@@ -6442,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);
@@ -6889,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";
@@ -6917,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) {
@@ -6957,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;
       }
@@ -6977,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);
@@ -7029,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.
        */
@@ -7088,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 },
@@ -7112,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 },
@@ -7194,6 +7313,18 @@ var init_state = __esm({
 });
 
 // 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)) {
@@ -7532,19 +7663,566 @@ var init_renderer = __esm({
   }
 });
 
+// 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 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 { 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 unlink2 } from "fs/promises";
+import { unlink as unlink3 } from "fs/promises";
 import { spawn as spawn2 } from "child_process";
 import { platform as platform2 } from "os";
-import { jsx as jsx14, jsxs as jsxs13 } from "react/jsx-runtime";
+import { jsx as jsx17, jsxs as jsxs16 } from "react/jsx-runtime";
 function gatewayFromConfig(cfg) {
   if (!cfg.aiGatewayId) return void 0;
   return {
@@ -7615,8 +8293,8 @@ function findImagePaths(text) {
 }
 function App({ initialCfg, initialUpdateResult }) {
   const { exit } = useApp();
-  const [cfg, setCfg] = useState7(initialCfg);
-  const [events, setRawEvents] = useState7([]);
+  const [cfg, setCfg] = useState8(initialCfg);
+  const [events, setRawEvents] = useState8([]);
   const setEvents = useCallback(
     (updater) => {
       setRawEvents((prev) => {
@@ -7626,34 +8304,38 @@ function App({ initialCfg, initialUpdateResult }) {
     },
     []
   );
-  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(
+  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] = 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 [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)
@@ -7677,6 +8359,7 @@ 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([]);
@@ -7712,6 +8395,7 @@ function App({ initialCfg, initialUpdateResult }) {
         accountId: cfg.accountId,
         apiToken: cfg.apiToken,
         model: cfg.model,
+        plumbingModel: cfg.plumbingModel,
         embeddingModel: cfg.memoryEmbeddingModel,
         gateway: gatewayFromConfig(cfg),
         maxAgeDays: cfg.memoryMaxAgeDays ?? RETENTION.memoryMaxAgeDays,
@@ -7724,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` }
           ]);
         }
       });
@@ -7732,10 +8416,27 @@ 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;
@@ -7754,6 +8455,20 @@ function App({ initialCfg, initialUpdateResult }) {
       }
     });
   }, [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;
@@ -7956,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]);
-  useInput3((inputChar, key) => {
+  useInput5((inputChar, key) => {
     if (key.ctrl && inputChar === "c") {
       if (busy && activeControllerRef.current) {
         activeControllerRef.current.abort();
@@ -8337,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",
@@ -8656,7 +9390,7 @@ use: /thinking low | medium | high`
           setCfg(next);
           void saveConfig(next).catch(() => {
           });
-          setEvents((e) => [...e, { kind: "info", key: mkKey(), text: "memory enabled" }]);
+          setEvents((e) => [...e, { kind: "memory", key: mkKey(), text: "memory enabled" }]);
           return true;
         }
         if (arg === "off") {
@@ -8664,7 +9398,7 @@ use: /thinking low | medium | high`
           setCfg(next);
           void saveConfig(next).catch(() => {
           });
-          setEvents((e) => [...e, { kind: "info", key: mkKey(), text: "memory disabled" }]);
+          setEvents((e) => [...e, { kind: "memory", key: mkKey(), text: "memory disabled" }]);
           return true;
         }
         if (!cfg.memoryEnabled) {
@@ -8673,7 +9407,7 @@ use: /thinking low | medium | high`
         }
         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 ")) {
@@ -8808,7 +9542,7 @@ ${lines.join("\n")}` }]);
         return true;
       }
       if (c === "/logout") {
-        unlink2(configPath()).catch(() => {
+        unlink3(configPath()).catch(() => {
         });
         setEvents((e) => [
           ...e,
@@ -8817,6 +9551,30 @@ ${lines.join("\n")}` }]);
         setCfg(null);
         return true;
       }
+      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: "usage: /command create | edit | delete | list" }
+        ]);
+        return true;
+      }
       if (c === "/help") {
         setShowHelpMenu(true);
         return true;
@@ -8835,6 +9593,47 @@ ${lines.join("\n")}` }]);
     },
     [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;
@@ -8897,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) {
@@ -9088,6 +9891,30 @@ ${lines.join("\n")}` }]);
             }
           }
         }
+        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) {
         if (e.name === "AbortError") {
           setEvents((es) => [...es, { kind: "info", key: mkKey(), text: "(aborted)" }]);
@@ -9161,7 +9988,7 @@ ${lines.join("\n")}` }]);
     }
   }, [usage]);
   if (!cfg) {
-    return /* @__PURE__ */ jsx14(
+    return /* @__PURE__ */ jsx17(
       Onboarding,
       {
         onDone: (newCfg) => {
@@ -9175,13 +10002,13 @@ ${lines.join("\n")}` }]);
     );
   }
   if (resumeSessions !== null) {
-    return /* @__PURE__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(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__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(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__ */ jsx14(Box13, { flexDirection: "column", children: /* @__PURE__ */ jsx14(
+    return /* @__PURE__ */ jsx17(Box16, { flexDirection: "column", children: /* @__PURE__ */ jsx17(
       HelpMenu,
       {
         theme,
@@ -9193,10 +10020,79 @@ ${lines.join("\n")}` }]);
       }
     ) });
   }
+  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__ */ 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(
+  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,
@@ -9207,8 +10103,8 @@ ${lines.join("\n")}` }]);
           setPerm(null);
         }
       }
-    ) : /* @__PURE__ */ jsxs13(Box13, { flexDirection: "column", marginTop: 1, children: [
-      tasks.length > 0 && /* @__PURE__ */ jsx14(
+    ) : /* @__PURE__ */ jsxs16(Box16, { flexDirection: "column", marginTop: 1, children: [
+      tasks.length > 0 && /* @__PURE__ */ jsx17(
         TaskList,
         {
           tasks,
@@ -9217,11 +10113,11 @@ ${lines.join("\n")}` }]);
           tokensDelta: Math.max(0, (usage?.prompt_tokens ?? 0) - tasksStartTokens)
         }
       ),
-      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: [
+      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__ */ jsx14(
+      /* @__PURE__ */ jsx17(
         StatusBar,
         {
           model: cfg.model,
@@ -9239,9 +10135,9 @@ ${lines.join("\n")}` }]);
           codeMode
         }
       ),
-      /* @__PURE__ */ jsxs13(Box13, { marginTop: 1, children: [
-        /* @__PURE__ */ jsx14(Text14, { color: theme.accent, children: "\u203A " }),
-        /* @__PURE__ */ jsx14(
+      /* @__PURE__ */ jsxs16(Box16, { marginTop: 1, children: [
+        /* @__PURE__ */ jsx17(Text17, { color: theme.accent, children: "\u203A " }),
+        /* @__PURE__ */ jsx17(
           CustomTextInput,
           {
             value: input,
@@ -9290,7 +10186,7 @@ ${lines.join("\n")}` }]);
   ] });
 }
 async function renderApp(cfg, updateResult) {
-  const instance = render(/* @__PURE__ */ jsx14(App, { initialCfg: cfg, initialUpdateResult: updateResult }), {
+  const instance = render(/* @__PURE__ */ jsx17(App, { initialCfg: cfg, initialUpdateResult: updateResult }), {
     incrementalRendering: true
   });
   await instance.waitUntilExit();
@@ -9331,6 +10227,10 @@ var init_app = __esm({
     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;