@kryvenaiofficial/kryven 0.2.2 → 0.2.3

package/dist/cli.mjs

@@ -37700,9 +37700,18 @@ function renderInline(s) {
   return s.replace(/`([^`]+)`/g, "$1").replace(/\*\*([^*]+)\*\*/g, "$1").replace(/__([^_]+)__/g, "$1");
 }
 
+// src/tui/MessageList.tsx
+var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
+var MessageList = ({ message: m }) => {
+  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { bold: true, color: m.role === "user" ? "blue" : "green", children: m.role === "user" ? "you" : "kryven" }),
+    /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Box_default, { paddingLeft: 2, flexDirection: "column", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Markdown, { text: m.content ?? "" }) })
+  ] });
+};
+
 // src/tui/MarkdownStream.tsx
 var import_react22 = __toESM(require_react(), 1);
-var import_jsx_runtime2 = __toESM(require_jsx_runtime(), 1);
+var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
 var LIVE_LINE_COUNT = 6;
 var MAX_FPS = 20;
 var FRAME_INTERVAL_MS = Math.floor(1e3 / MAX_FPS);
@@ -37780,55 +37789,21 @@ var MarkdownStream = ({
       }
     };
   }, []);
-  const { stableChunks, liveText } = (0, import_react22.useMemo)(() => {
-    if (!displayText) return { stableChunks: [], liveText: "" };
-    const { stable, live } = splitAtBoundary(displayText);
-    const chunks = [];
-    let carry = "";
-    if (stable) {
-      const paragraphs = stable.split(/\n{2,}/);
-      const carryIdx = paragraphs.length - 1;
-      carry = paragraphs[carryIdx] ?? "";
-      let offset = 0;
-      for (let i2 = 0; i2 < carryIdx; i2++) {
-        const para = paragraphs[i2];
-        if (para.trim()) {
-          chunks.push({ id: `s-${offset}`, text: para });
-        }
-        offset += para.length + 2;
-      }
-    }
-    const liveText2 = carry ? `${carry}
-${live}` : live;
-    return { stableChunks: chunks, liveText: liveText2 };
-  }, [displayText]);
+  const liveText = (0, import_react22.useMemo)(
+    () => displayText ? splitAtBoundary(displayText).live : "",
+    [displayText]
+  );
   const liveInsideFence = (0, import_react22.useMemo)(() => isInsideCodeFence(liveText), [liveText]);
   if (streamingText === void 0) return null;
-  return /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
-    stableChunks.length > 0 && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Static, { items: stableChunks, children: (chunk) => /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Box_default, { flexDirection: "column", children: /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Markdown, { text: chunk.text }) }, chunk.id) }),
-    liveText ? /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Box_default, { flexDirection: "column", children: [
-      /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Markdown, { text: liveText }),
-      liveInsideFence && /* @__PURE__ */ (0, import_jsx_runtime2.jsxs)(Text, { color: "gray", dimColor: true, children: [
+  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", children: [
+    liveText ? /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", children: [
+      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Markdown, { text: liveText }),
+      liveInsideFence && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Text, { color: "gray", dimColor: true, children: [
         "```",
         " "
       ] })
     ] }) : null,
-    !done && /* @__PURE__ */ (0, import_jsx_runtime2.jsx)(Text, { color: "magentaBright", dimColor: true, children: "\u258B" })
-  ] });
-};
-
-// src/tui/MessageList.tsx
-var import_jsx_runtime3 = __toESM(require_jsx_runtime(), 1);
-var MessageList = ({ messages, streaming }) => {
-  return /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
-    messages.map((m, i2) => /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { bold: true, color: m.role === "user" ? "blue" : "green", children: m.role === "user" ? "you" : "kryven" }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Box_default, { paddingLeft: 2, flexDirection: "column", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Markdown, { text: m.content ?? "" }) })
-    ] }, i2)),
-    streaming !== void 0 && /* @__PURE__ */ (0, import_jsx_runtime3.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { bold: true, color: "green", children: "kryven" }),
-      /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Box_default, { paddingLeft: 2, flexDirection: "column", children: /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(MarkdownStream, { streamingText: streaming }) })
-    ] })
+    !done && /* @__PURE__ */ (0, import_jsx_runtime3.jsx)(Text, { color: "magentaBright", dimColor: true, children: "\u258B" })
   ] });
 };
 
@@ -43637,7 +43612,7 @@ async function runBgAgent(id) {
     apiKey: cfg.apiKey,
     baseUrl: cfg.apiBaseUrl,
     clientType: "ide",
-    userAgent: `kryven-cli-bg/${"0.2.2"}`
+    userAgent: `kryven-cli-bg/${"0.2.3"}`
   });
   const transcriptPath = join25(dir, "transcript.jsonl");
   const appendTranscript = async (m) => {
@@ -44571,6 +44546,47 @@ function handleVimKey(state, buffer, key) {
 
 // src/tui/REPL.tsx
 init_modes();
+
+// src/utils/update-check.ts
+var PACKAGE = "@kryvenaiofficial/kryven";
+var REGISTRY_LATEST = `https://registry.npmjs.org/${PACKAGE}/latest`;
+var SEMVER = /^(\d+)\.(\d+)\.(\d+)/;
+function compareSemver(a2, b) {
+  const pa = SEMVER.exec(a2);
+  const pb = SEMVER.exec(b);
+  if (!pa || !pb) return 0;
+  for (let i2 = 1; i2 <= 3; i2++) {
+    const da = Number(pa[i2]);
+    const db = Number(pb[i2]);
+    if (da !== db) return da - db;
+  }
+  return 0;
+}
+async function checkForUpdate(current, timeoutMs = 2500) {
+  if (!current || !SEMVER.test(current)) return null;
+  try {
+    const ac = new AbortController();
+    const timer = setTimeout(() => ac.abort(), timeoutMs);
+    let res;
+    try {
+      res = await fetch(REGISTRY_LATEST, {
+        signal: ac.signal,
+        headers: { accept: "application/json" }
+      });
+    } finally {
+      clearTimeout(timer);
+    }
+    if (!res.ok) return null;
+    const j = await res.json();
+    const latest = String(j?.version ?? "");
+    if (!SEMVER.test(latest)) return null;
+    return { updateAvailable: compareSemver(latest, current) > 0, latest };
+  } catch {
+    return null;
+  }
+}
+
+// src/tui/REPL.tsx
 var import_jsx_runtime36 = __toESM(require_jsx_runtime(), 1);
 import fs4 from "node:fs";
 import path8 from "node:path";
@@ -44622,6 +44638,7 @@ var REPL = ({
   const abortRef = (0, import_react27.useRef)(null);
   const permissionResolveRef = (0, import_react27.useRef)(null);
   const readPathsRef = (0, import_react27.useRef)(/* @__PURE__ */ new Set());
+  const toolMetaRef = (0, import_react27.useRef)(/* @__PURE__ */ new Map());
   (0, import_react27.useEffect)(() => {
     if (isGuest) return;
     const cfg = resolveConfig();
@@ -44652,6 +44669,8 @@ var REPL = ({
   const [sessionTokens, setSessionTokens] = (0, import_react27.useState)(0);
   const [toolEntries, setToolEntries] = (0, import_react27.useState)([]);
   const [permissionReq, setPermissionReq] = (0, import_react27.useState)(null);
+  const [staticGen, setStaticGen] = (0, import_react27.useState)(0);
+  const prevCommittedCountRef = (0, import_react27.useRef)(0);
   const cfgRef = (0, import_react27.useRef)(resolveConfig());
   const vimEnabledRef = (0, import_react27.useRef)(cfgRef.current.vim === true);
   const vimRef = (0, import_react27.useRef)(initialVim());
@@ -44694,6 +44713,18 @@ var REPL = ({
   }, []);
   const toolsEnabled = (0, import_react27.useMemo)(() => listTools().length > 0, []);
   (0, import_react27.useEffect)(() => {
+    void checkForUpdate("0.2.3").then((info) => {
+      if (info?.updateAvailable) {
+        setNotes((p) => [
+          ...p,
+          {
+            kind: "system",
+            text: `Update available: ${"0.2.3"} \u2192 ${info.latest}. Run \`kryven update\` to update.`
+          }
+        ]);
+      }
+    }).catch(() => {
+    });
     void (async () => {
       if (resumeMessages?.length) {
         for (const m of resumeMessages) conversationRef.current.append(m);
@@ -44950,6 +44981,8 @@ var REPL = ({
       ts: Date.now()
     };
     conversationRef.current.append(assistant);
+    setStreaming(null);
+    forceRender((n2) => n2 + 1);
     void sessionRef.current.appendMessage(assistant);
     const remaining = res.kryven_guest?.messagesRemaining;
     if (typeof remaining === "number") {
@@ -44987,6 +45020,8 @@ var REPL = ({
       usage
     };
     conversationRef.current.append(assistant);
+    setStreaming(null);
+    forceRender((n2) => n2 + 1);
     void sessionRef.current.appendMessage(assistant);
     if (remoteSessionRef.current) {
       void remoteSessionRef.current.appendMessage(assistant).catch(() => {
@@ -45042,44 +45077,58 @@ var REPL = ({
           setStreaming(null);
           streamAcc = "";
           flushPersistableTurns();
-          setToolEntries((prev) => [
-            ...prev,
-            {
+          {
+            const entry = {
               callId: ev.call.id,
               toolName: ev.call.function.name,
               argsPreview: shortArgs(ev.call.function.arguments),
               status: "running",
               risk: ev.risk
-            }
-          ]);
-          break;
-        case "tool_result":
-          setToolEntries(
-            (prev) => prev.map(
-              (e) => e.callId === ev.callId ? { ...e, status: ev.ok ? "ok" : "error", output: ev.output, truncated: ev.truncated, renderHint: ev.renderHint } : e
-            )
-          );
-          {
-            const toolMsg = {
-              role: "tool",
-              content: ev.output,
-              tool_call_id: ev.callId,
-              ts: Date.now()
             };
-            void sessionRef.current.appendMessage(toolMsg);
-            if (remoteSessionRef.current) {
-              void remoteSessionRef.current.appendMessage(toolMsg).catch(() => {
-              });
-            }
+            toolMetaRef.current.set(entry.callId, entry);
+            setToolEntries((prev) => [...prev, entry]);
           }
           break;
-        case "tool_blocked":
-          setToolEntries(
-            (prev) => prev.map(
-              (e) => e.callId === ev.callId ? { ...e, status: "blocked", output: ev.reason } : e
-            )
-          );
+        case "tool_result": {
+          const finalStatus = ev.ok ? "ok" : "error";
+          const prevMeta = toolMetaRef.current.get(ev.callId);
+          toolMetaRef.current.set(ev.callId, {
+            callId: ev.callId,
+            toolName: prevMeta?.toolName ?? ev.toolName,
+            argsPreview: prevMeta?.argsPreview ?? "",
+            risk: prevMeta?.risk,
+            status: finalStatus,
+            output: ev.output,
+            truncated: ev.truncated,
+            renderHint: ev.renderHint
+          });
+          setToolEntries((prev) => prev.filter((e) => e.callId !== ev.callId));
+          const toolMsg = {
+            role: "tool",
+            content: ev.output,
+            tool_call_id: ev.callId,
+            ts: Date.now()
+          };
+          void sessionRef.current.appendMessage(toolMsg);
+          if (remoteSessionRef.current) {
+            void remoteSessionRef.current.appendMessage(toolMsg).catch(() => {
+            });
+          }
+          break;
+        }
+        case "tool_blocked": {
+          const prevMeta = toolMetaRef.current.get(ev.callId);
+          toolMetaRef.current.set(ev.callId, {
+            callId: ev.callId,
+            toolName: prevMeta?.toolName ?? ev.toolName,
+            argsPreview: prevMeta?.argsPreview ?? "",
+            risk: prevMeta?.risk,
+            status: "blocked",
+            output: ev.reason
+          });
+          setToolEntries((prev) => prev.filter((e) => e.callId !== ev.callId));
           break;
+        }
         case "end_turn":
           endedNormally = true;
           setStreaming(null);
@@ -45115,6 +45164,7 @@ var REPL = ({
       logger.debug("tools turn ended without end_turn event");
     }
   };
+  const convSize = conversationRef.current.size();
   const status = {
     model,
     mood,
@@ -45122,28 +45172,75 @@ var REPL = ({
     branch: git.branch,
     dirty: git.dirty,
     sessionTokens,
-    sessionMessages: conversationRef.current.size(),
+    sessionMessages: convSize,
     costUsd: sessionCostUsd(conversationRef.current.all(), model),
     mode: getPermissionMode()
   };
-  return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", children: [
-    /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
-      KRYVEN_PIXEL_WORDMARK.map((line) => /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { color: "magentaBright", children: line }, line)),
-      /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Text, { bold: true, color: "cyan", children: [
-        "Kryven CLI ",
-        "0.2.2",
-        toolsEnabled ? " \xB7 tools enabled" : ""
-      ] }),
-      /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { color: "gray", children: "Powered by KRY-5.2 Extended \xB7 type /help \xB7 Ctrl+D to exit" })
-    ] }),
-    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(
-      MessageList,
+  const staticItems = (0, import_react27.useMemo)(() => {
+    const gen = `g${staticGen}`;
+    const items = [
       {
-        messages: conversationRef.current.all().filter((m) => m.role !== "tool"),
-        streaming: streaming ?? void 0
+        id: `${gen}-header`,
+        node: /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
+          KRYVEN_PIXEL_WORDMARK.map((line) => /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { color: "magentaBright", children: line }, line)),
+          /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Text, { bold: true, color: "cyan", children: [
+            "Kryven CLI ",
+            "0.2.3",
+            toolsEnabled ? " \xB7 tools enabled" : ""
+          ] }),
+          /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { color: "gray", children: "Powered by KRY-5.2 Extended \xB7 type /help \xB7 Ctrl+D to exit" })
+        ] })
       }
-    ),
-    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ToolCallList, { entries: toolEntries, collapseCompleted: false }),
+    ];
+    const all = conversationRef.current.all();
+    const callInfo = /* @__PURE__ */ new Map();
+    for (const mm of all) {
+      if (mm.role === "assistant" && Array.isArray(mm.tool_calls)) {
+        for (const c3 of mm.tool_calls) {
+          callInfo.set(c3.id, {
+            toolName: c3.function?.name ?? "tool",
+            argsPreview: shortArgs(c3.function?.arguments ?? "")
+          });
+        }
+      }
+    }
+    for (let i2 = 0; i2 < all.length; i2++) {
+      const m = all[i2];
+      if (m.role === "user") {
+        items.push({ id: `${gen}-m${i2}`, node: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(MessageList, { message: m }) });
+      } else if (m.role === "assistant") {
+        if (typeof m.content === "string" && m.content.trim().length > 0) {
+          items.push({ id: `${gen}-m${i2}`, node: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(MessageList, { message: m }) });
+        }
+      } else if (m.role === "tool") {
+        const meta = m.tool_call_id ? toolMetaRef.current.get(m.tool_call_id) : void 0;
+        const info = m.tool_call_id ? callInfo.get(m.tool_call_id) : void 0;
+        const entry = meta ?? {
+          callId: m.tool_call_id ?? `t${i2}`,
+          toolName: info?.toolName ?? "tool",
+          argsPreview: info?.argsPreview ?? "",
+          status: "ok",
+          output: typeof m.content === "string" ? m.content : ""
+        };
+        items.push({ id: `${gen}-t${i2}`, node: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ToolCall, { ...entry }) });
+      }
+    }
+    return items;
+  }, [convSize, staticGen, toolsEnabled]);
+  const committedCount = staticItems.length;
+  (0, import_react27.useEffect)(() => {
+    if (committedCount < prevCommittedCountRef.current) {
+      setStaticGen((g) => g + 1);
+    }
+    prevCommittedCountRef.current = committedCount;
+  }, [committedCount]);
+  return /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", children: [
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Static, { items: staticItems, children: (item) => /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Box_default, { flexDirection: "column", children: item.node }, item.id) }, staticGen),
+    streaming != null && /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, children: [
+      /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { bold: true, color: "green", children: "kryven" }),
+      /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Box_default, { paddingLeft: 2, flexDirection: "column", children: /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(MarkdownStream, { streamingText: streaming, done: !busy }) })
+    ] }),
+    /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(ToolCallList, { entries: toolEntries }),
     permissionReq && /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Box_default, { flexDirection: "column", marginBottom: 1, borderStyle: "round", borderColor: "yellow", paddingX: 1, children: [
       /* @__PURE__ */ (0, import_jsx_runtime36.jsx)(Text, { bold: true, children: "Permission required" }),
       /* @__PURE__ */ (0, import_jsx_runtime36.jsxs)(Text, { children: [
@@ -45467,7 +45564,7 @@ async function chatCommand(opts = {}) {
     client = new GuestKryvenClient({
       baseUrl: cfg.apiBaseUrl,
       shareFingerprint: cfg.shareFingerprint !== false,
-      userAgent: `kryven-cli/${"0.2.2"}`
+      userAgent: `kryven-cli/${"0.2.3"}`
     });
     console.log(source_default.cyan("Guest mode \u2014 3 free prompts. Run `kryven login` for unlimited chat."));
   } else {
@@ -45475,7 +45572,7 @@ async function chatCommand(opts = {}) {
       apiKey: cfg.apiKey,
       baseUrl: cfg.apiBaseUrl,
       clientType: "ide",
-      userAgent: `kryven-cli/${"0.2.2"}`
+      userAgent: `kryven-cli/${"0.2.3"}`
     });
   }
   let resumeMessages;
@@ -45559,6 +45656,38 @@ async function chatCommand(opts = {}) {
   await waitUntilExit();
 }
 
+// src/commands/update.ts
+init_execa();
+
+// src/shims/version.ts
+var KRYVEN_VERSION = "0.2.3";
+
+// src/commands/update.ts
+var PACKAGE2 = "@kryvenaiofficial/kryven";
+async function updateCommand() {
+  console.log(source_default.bold(`Updating ${PACKAGE2} to the latest version\u2026`));
+  console.log(source_default.dim(`  current: ${KRYVEN_VERSION}`));
+  try {
+    await execa("npm", ["install", "-g", `${PACKAGE2}@latest`], { stdio: "inherit" });
+    console.log(
+      source_default.green(`
+\u2713 Update complete. Run `) + source_default.bold(`kryven --version`) + source_default.green(` to confirm, then start with `) + source_default.bold(`kryven`) + source_default.green(`.`)
+    );
+  } catch (err) {
+    console.error(source_default.red(`
+\u2717 Update failed: ${err.message}`));
+    console.error(
+      source_default.yellow(
+        `Update manually with:
+  npm install -g ${PACKAGE2}@latest
+On macOS/Linux a global install may need sudo:
+  sudo npm install -g ${PACKAGE2}@latest`
+      )
+    );
+    process.exit(1);
+  }
+}
+
 // src/commands/skills.ts
 import { writeFile as writeFile11, mkdir as mkdir13 } from "node:fs/promises";
 import { existsSync as existsSync23 } from "node:fs";
@@ -45839,9 +45968,6 @@ async function bgWait(id, timeoutMs = 30 * 60 * 1e3) {
   process.exit(124);
 }
 
-// src/shims/version.ts
-var KRYVEN_VERSION = "0.2.2";
-
 // src/main.tsx
 async function main(argv2) {
   const bgRunIdx = argv2.indexOf("--bg-run");
@@ -45863,6 +45989,9 @@ async function main(argv2) {
   program2.command("models").description("List models exposed by /v1/models").action(async () => {
     await modelsCommand();
   });
+  program2.command("update").description("Update the Kryven CLI to the latest published version").action(async () => {
+    await updateCommand();
+  });
   program2.command("chat", { isDefault: true }).description("Launch the chat REPL (default subcommand)").argument("[prompt...]", "Optional inline prompt to seed the session").action(async (promptParts, _options, cmd) => {
     const opts = cmd.optsWithGlobals();
     const seed = promptParts && promptParts.length ? promptParts.join(" ") : void 0;
@@ -45912,13 +46041,13 @@ async function main(argv2) {
 var argv = process.argv.slice(2);
 var first = argv[0];
 if (first === "--version" || first === "-v" || first === "-V") {
-  const v = "0.2.2";
+  const v = "0.2.3";
   process.stdout.write(v + "\n");
   process.exit(0);
 }
 if (first === "--help" || first === "-h") {
   process.stdout.write(
-    "Usage: kryven [command] [options]\n\nCommands:\n  kryven                Launch chat REPL in current directory\n  kryven login          Save your kry_sk_* API key\n  kryven logout         Remove stored key\n  kryven status         Show config + model availability\n  kryven models         List /v1/models\n\nOptions:\n  -v, --version         Print version\n  -h, --help            Show this help\n      --api-key <key>   Override stored key for this run\n      --model <id>      Override default model\n      --mood <name>     Override default mood\n      --resume <id>     Resume a prior session\n\nDocs: https://kryven.cc/docs/cli\n"
+    "Usage: kryven [command] [options]\n\nCommands:\n  kryven                Launch chat REPL in current directory\n  kryven login          Save your kry_sk_* API key\n  kryven logout         Remove stored key\n  kryven status         Show config + model availability\n  kryven models         List /v1/models\n  kryven update         Update the CLI to the latest version\n\nOptions:\n  -v, --version         Print version\n  -h, --help            Show this help\n      --api-key <key>   Override stored key for this run\n      --model <id>      Override default model\n      --mood <name>     Override default mood\n      --resume <id>     Resume a prior session\n\nDocs: https://kryven.cc/docs/cli\n"
   );
   process.exit(0);
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kryvenaiofficial/kryven",
-  "version": "0.2.2",
+  "version": "0.2.3",
   "description": "Kryven Agent CLI — terminal AI coding assistant powered by the Kryven platform.",
   "type": "module",
   "bin": {
@@ -8,6 +8,7 @@
   },
   "files": [
     "dist/cli.mjs",
+    "scripts/postinstall.cjs",
     "README.md",
     "LICENSE"
   ],
@@ -21,6 +22,7 @@
     "typecheck": "tsc --noEmit",
     "smoke:offline": "tsx scripts/smoke-offline.ts",
     "smoke:online": "tsx scripts/smoke-online.ts",
+    "postinstall": "node scripts/postinstall.cjs",
     "prepublishOnly": "npm run build && npm run smoke:offline"
   },
   "dependencies": {

package/scripts/postinstall.cjs

@@ -0,0 +1,48 @@
+#!/usr/bin/env node
+/*
+ * Post-install banner for the Kryven CLI.
+ *
+ * Shown only after a GLOBAL install (`npm install -g @kryvenaiofficial/kryven`)
+ * — the case the kryven.cc/agent install command uses. Scoped to global so the
+ * banner never spams users who pull the package in as a dependency or in CI.
+ *
+ * Bulletproof by design: any failure is swallowed and the process still exits 0
+ * so a cosmetic banner can never break `npm install`.
+ */
+'use strict';
+
+try {
+  // npm sets npm_config_global=true for `-g` installs. yarn/pnpm globals also
+  // set it. If it's anything else (local dep install, CI), stay silent.
+  const isGlobal = String(process.env.npm_config_global || '').toLowerCase() === 'true';
+  // Allow forcing the banner for manual testing.
+  const forced = process.env.KRYVEN_FORCE_POSTINSTALL === '1';
+  if (!isGlobal && !forced) return;
+
+  // Only colorize when attached to a TTY that isn't explicitly NO_COLOR.
+  const useColor = process.stdout.isTTY && !process.env.NO_COLOR;
+  const wrap = (code, s) => (useColor ? `\x1b[${code}m${s}\x1b[0m` : s);
+  const purple = (s) => wrap('38;5;141', s);
+  const bold = (s) => wrap('1', s);
+  const dim = (s) => wrap('2', s);
+  const green = (s) => wrap('32', s);
+
+  const out = [
+    '',
+    '  ' + purple('────────────────────────────────────────────'),
+    '  ' + green('✓') + '  ' + bold('Kryven CLI installed.'),
+    '',
+    '  Run ' + bold(purple('kryven')) + ' in your terminal to enable the CLI.',
+    '  ' + purple('────────────────────────────────────────────'),
+    '',
+    '  ' + bold('kryven') + '         ' + dim('start chatting + coding (3 free prompts)'),
+    '  ' + bold('kryven login') + '   ' + dim('save your API key (kry_sk_…)'),
+    '  ' + bold('kryven --help') + '  ' + dim('all commands'),
+    '',
+    '  ' + dim('Docs: https://kryven.cc/docs/cli'),
+    '',
+  ];
+  process.stdout.write(out.join('\n') + '\n');
+} catch {
+  /* never fail an install over a banner */
+}