clixad 0.0.1-beta.22 → 0.0.1-beta.24

package/dist/clixad.mjs

@@ -327,6 +327,13 @@ function extraFormatIds(raw) {
 function imagePart(image) {
   return { type: "image_url", image_url: { url: `data:${image.mimeType};base64,${image.data}` } };
 }
+function withoutReasoning(messages) {
+  return messages.map((message) => {
+    if (!message.reasoning_details) return message;
+    const { reasoning_details: _dropped, ...rest } = message;
+    return rest;
+  });
+}
 function messageText(message) {
   const content = message.content;
   if (typeof content === "string") return content;
@@ -350,12 +357,48 @@ function asSignupClosed(status, data) {
   const d = data;
   return d && d.error === "signup_closed" && typeof d.message === "string" ? { error: d.error, message: d.message, waitlist_url: d.waitlist_url ?? "https://clixad.io" } : void 0;
 }
+function shortfallHeadline(err, model) {
+  const n = (v) => Math.max(0, Math.round(v)).toLocaleString("en-US");
+  if (err.balance <= 0) return `Out of credits (this needs about ${n(err.estimatedCost)}).`;
+  return `Not enough credits for this turn${model ? ` on ${model}` : ""}: it needs about ${n(err.estimatedCost)}, and the balance is ${n(err.balance)}.`;
+}
 function paywallError(body) {
   const free = Array.isArray(body.free_models) ? body.free_models.filter(
     (m) => !!m && typeof m.id === "string" && m.id.length > 0 && Number.isFinite(m.turns_left)
   ).map((m) => ({ id: m.id, turnsLeft: Math.max(0, Math.floor(m.turns_left)) })).filter((m) => m.turnsLeft > 0) : [];
   return new PaywallError(body.balance, body.estimated_cost, body.grant_per_ad, free);
 }
+function neverConnected(code) {
+  return code !== void 0 && NEVER_CONNECTED.has(code);
+}
+function networkCode(err) {
+  let cause = err?.cause;
+  for (let depth = 0; depth < 3 && cause; depth++) {
+    const code = cause.code;
+    if (typeof code === "string" && code) return code;
+    const inner = cause.errors;
+    if (Array.isArray(inner)) {
+      const first = inner.find((e) => typeof e?.code === "string");
+      if (first) return first.code;
+    }
+    cause = cause.cause;
+  }
+  return void 0;
+}
+async function gatewayFetch(url, init) {
+  try {
+    return await fetch(url, init);
+  } catch (err) {
+    const aborted = init?.signal?.aborted || err?.name === "AbortError";
+    if (aborted || !(err instanceof TypeError)) throw err;
+    let host = String(url);
+    try {
+      host = new URL(url).host;
+    } catch {
+    }
+    throw new GatewayUnreachableError(host, networkCode(err));
+  }
+}
 async function authFailure(res, what) {
   const body = await res.text().catch(() => "");
   const isJson = (res.headers.get("content-type") ?? "").includes("json");
@@ -411,6 +454,26 @@ function accumulateToolCall(calls, part, fallbackIndex) {
   if (part.function?.arguments) current.function.arguments += part.function.arguments;
   calls.set(index, current);
 }
+function mergeReasoningDetails(acc, delta) {
+  if (!Array.isArray(delta)) return;
+  for (const piece of delta) {
+    if (!piece || typeof piece !== "object") continue;
+    const part = piece;
+    const existing = typeof part.index === "number" ? acc.find((block) => block.index === part.index) : void 0;
+    if (!existing) {
+      acc.push({ ...part });
+      continue;
+    }
+    for (const [key, value] of Object.entries(part)) {
+      if (value === null || value === void 0) continue;
+      if ((key === "text" || key === "summary" || key === "data") && typeof value === "string") {
+        existing[key] = `${typeof existing[key] === "string" ? existing[key] : ""}${value}`;
+      } else {
+        existing[key] = value;
+      }
+    }
+  }
+}
 async function* parseSSE(body) {
   const reader = body.getReader();
   const decoder = new TextDecoder();
@@ -429,7 +492,7 @@ async function* parseSSE(body) {
     }
   }
 }
-var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, AuthError, GatewayClient;
+var CHAT_ENCODED_CONTENT_TYPE, LEDGER_REASONS, SignupClosedError, PaywallError, GatewayUnreachableError, NEVER_CONNECTED, AuthError, GatewayClient;
 var init_client = __esm({
   "src/client.ts"() {
     "use strict";
@@ -478,6 +541,33 @@ var init_client = __esm({
       grantPerAd;
       freeModels;
     };
+    GatewayUnreachableError = class extends Error {
+      constructor(host, code) {
+        const where = `${host}${code ? ` (${code})` : ""}`;
+        super(
+          neverConnected(code) ? `Can't reach the Clixad gateway at ${where}. Nothing was sent, so nothing was charged. Check your connection and try again.` : `The connection to the Clixad gateway at ${where} broke before an answer arrived. If that was a model call it may still have been charged, so check your balance before sending it again.`
+        );
+        this.host = host;
+        this.code = code;
+        this.name = "GatewayUnreachableError";
+      }
+      host;
+      code;
+    };
+    NEVER_CONNECTED = /* @__PURE__ */ new Set([
+      "ENOTFOUND",
+      "EAI_AGAIN",
+      "ECONNREFUSED",
+      "ENETUNREACH",
+      "EHOSTUNREACH",
+      "EADDRNOTAVAIL",
+      "UND_ERR_CONNECT_TIMEOUT",
+      "CERT_HAS_EXPIRED",
+      "DEPTH_ZERO_SELF_SIGNED_CERT",
+      "SELF_SIGNED_CERT_IN_CHAIN",
+      "UNABLE_TO_VERIFY_LEAF_SIGNATURE",
+      "ERR_TLS_CERT_ALTNAME_INVALID"
+    ]);
     AuthError = class extends Error {
       constructor() {
         super("Not logged in. Run `clixad login` first.");
@@ -518,7 +608,7 @@ var init_client = __esm({
       }
       /** Dev-only signup shortcut (production replaces this with GitHub OAuth). */
       async signupDev(email, invite) {
-        const res = await fetch(`${this.config.gatewayUrl}/dev/users`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/dev/users`, {
           method: "POST",
           headers: this.headers(false),
           body: JSON.stringify({ ...email ? { email } : {}, ...invite ? { invite } : {} })
@@ -534,7 +624,7 @@ var init_client = __esm({
       /** Begin GitHub device-flow login. Returns null if the gateway has no GitHub
        *  configured (501), so the caller can fall back to the dev shortcut. */
       async deviceStart() {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/auth/device/start`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/device/start`, {
           method: "POST",
           headers: this.headers(false)
         });
@@ -544,7 +634,7 @@ var init_client = __esm({
       }
       /** Poll once for device-flow completion. `invite` unlocks a gated signup. */
       async devicePoll(session, invite) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/auth/device/poll`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/device/poll`, {
           method: "POST",
           headers: this.headers(false),
           body: JSON.stringify(invite ? { session, invite } : { session })
@@ -566,7 +656,7 @@ var init_client = __esm({
        */
       async handoffCode() {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/auth/handoff`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/auth/handoff`, {
             method: "POST",
             headers: this.headers()
           });
@@ -593,7 +683,7 @@ var init_client = __esm({
        */
       async claimStreak(signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/streak/claim`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/streak/claim`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {}
@@ -628,7 +718,7 @@ var init_client = __esm({
        */
       async sendFeedback(report, signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/feedback`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/feedback`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {},
@@ -663,7 +753,7 @@ var init_client = __esm({
        * that did not run, and saying so beats printing an empty summary.
        */
       async referral(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/referrals`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/referrals`, {
           headers: this.headers(),
           ...signal ? { signal } : {}
         });
@@ -694,7 +784,7 @@ var init_client = __esm({
        * 200 with a status, because that is an answer rather than a failure.
        */
       async redeem(code, signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/redeem`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/redeem`, {
           method: "POST",
           headers: this.headers(),
           ...signal ? { signal } : {},
@@ -715,7 +805,7 @@ var init_client = __esm({
        * them with the input box locked and "esc to stop" on screen.
        */
       async creditPacks(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/billing/packs`, { signal });
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/billing/packs`, { signal });
         if (!res.ok) throw new Error(`packs failed: ${res.status}`);
         return res.json();
       }
@@ -726,7 +816,7 @@ var init_client = __esm({
        * could not deliver instantly is worse than not starting one.
        */
       async checkout(pack, consent, signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/billing/checkout`, {
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/billing/checkout`, {
           method: "POST",
           headers: this.headers(),
           ...signal ? { signal } : {},
@@ -742,13 +832,37 @@ var init_client = __esm({
       // the better part of a minute) would otherwise be indistinguishable from a
       // hung terminal. Nothing else passes one — a one-shot CLI command has Ctrl+C.
       async models(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/models`, { signal });
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/models`, { signal });
         if (!res.ok) throw new Error(`models failed: ${res.status}`);
         const data = await res.json();
         this.seen = { web_search: data.capabilities?.web_search === true };
         this.shape = parseTaskShape(data.task_shape);
+        this.latest = typeof data.cli_latest === "string" ? data.cli_latest : void 0;
+        const live = new Set(data.data.map((m) => m.id));
+        this.retired = {};
+        if (data.retired_models && typeof data.retired_models === "object") {
+          for (const [from, to] of Object.entries(data.retired_models)) {
+            if (typeof to === "string" && live.has(to) && !live.has(from)) this.retired[from] = to;
+          }
+        }
         return data.data;
       }
+      /**
+       * Model ids that were retired, and the live model that serves each one, as of
+       * the last catalog fetch. Empty from a gateway that does not send the map.
+       */
+      get retiredModels() {
+        return this.retired;
+      }
+      retired = {};
+      /**
+       * The newest `clixad` published to npm, as the gateway last read it, or
+       * undefined when it did not say. Undefined means unknown, never up to date.
+       */
+      get latestCli() {
+        return this.latest;
+      }
+      latest;
       /**
        * The task shape the cost preview assumes, as of the last catalog fetch, or
        * undefined when the gateway sent none (or one that did not parse). Undefined
@@ -773,7 +887,7 @@ var init_client = __esm({
       }
       seen = { web_search: false };
       async wallet(signal) {
-        const res = await fetch(`${this.config.gatewayUrl}/v1/wallet`, { headers: this.headers(), signal });
+        const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/wallet`, { headers: this.headers(), signal });
         if (res.status === 401) throw await authFailure(res, "wallet");
         if (!res.ok) throw new Error(`wallet failed: ${res.status}`);
         return res.json();
@@ -809,7 +923,7 @@ var init_client = __esm({
        */
       async sponsorConfig(signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/sponsor/config`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/sponsor/config`, {
             headers: this.headers(),
             ...signal ? { signal } : {}
           });
@@ -847,7 +961,7 @@ var init_client = __esm({
        */
       async reportImpression(report, signal) {
         try {
-          const res = await fetch(`${this.config.gatewayUrl}/v1/sponsor/impression`, {
+          const res = await gatewayFetch(`${this.config.gatewayUrl}/v1/sponsor/impression`, {
             method: "POST",
             headers: this.headers(),
             ...signal ? { signal } : {},
@@ -880,7 +994,7 @@ var init_client = __esm({
         const url = new URL(`${this.config.gatewayUrl}/v1/web/search`);
         url.searchParams.set("q", query);
         if (opts.count) url.searchParams.set("count", String(opts.count));
-        const res = await fetch(url, {
+        const res = await gatewayFetch(url, {
           headers: this.headers(),
           ...opts.signal ? { signal: opts.signal } : {}
         });
@@ -920,7 +1034,7 @@ var init_client = __esm({
       /** One POST to the chat route, in whichever transport is currently in use. */
       sendChat(payload, encoded, signal) {
         const json = JSON.stringify(payload);
-        return fetch(`${this.config.gatewayUrl}/v1/chat/completions`, {
+        return gatewayFetch(`${this.config.gatewayUrl}/v1/chat/completions`, {
           method: "POST",
           headers: encoded ? { ...this.headers(), "Content-Type": CHAT_ENCODED_CONTENT_TYPE } : this.headers(),
           body: encoded ? encodeChatBody(json) : json,
@@ -1063,6 +1177,7 @@ var init_client = __esm({
         let balance = 0;
         let streamError;
         const calls = /* @__PURE__ */ new Map();
+        const reasoning = [];
         for await (const evt of parseSSE(res.body)) {
           if (evt === "[DONE]") break;
           let json;
@@ -1080,6 +1195,7 @@ var init_client = __esm({
           for (const [index, part] of (choice?.delta?.tool_calls ?? []).entries()) {
             accumulateToolCall(calls, part, index);
           }
+          mergeReasoningDetails(reasoning, choice?.delta?.reasoning_details);
           if (choice?.finish_reason) finishReason = choice.finish_reason;
           if (json.error) streamError = json.error.message || "the model stream failed";
           if (json.clixad) {
@@ -1092,6 +1208,7 @@ var init_client = __esm({
         const message = { role: "assistant", content: content || null };
         if (calls.size > 0) {
           message.tool_calls = [...calls.entries()].sort(([a], [b]) => a - b).map(([, c2]) => c2);
+          if (reasoning.length) message.reasoning_details = reasoning;
         }
         return { message, finishReason, creditsCharged, balance, ...free };
       }
@@ -3973,6 +4090,19 @@ ${NO_SEARCH_INSTRUCTION}`,
 
 (the sub-agent hit its step limit \u2014 this answer may be incomplete)` : answer;
   }
+  function emitUsage(turn) {
+    emit({
+      type: "usage",
+      creditsCharged: turn.creditsCharged,
+      balance: turn.balance,
+      ...turn.free ? {
+        free: true,
+        creditsWaived: turn.creditsWaived ?? 0,
+        freeCreditsLeft: turn.freeCreditsLeft ?? 0
+      } : {}
+    });
+  }
+  let retriedEmpty = false;
   for (let step = 0; step < maxSteps; step++) {
     if (opts.signal?.aborted) return stop("aborted");
     let turn;
@@ -3990,23 +4120,27 @@ ${NO_SEARCH_INSTRUCTION}`,
     creditsWaived += turn.creditsWaived ?? 0;
     if (turn.freeCreditsLeft !== void 0) freeCreditsLeft = turn.freeCreditsLeft;
     balance = turn.balance;
-    emit({
-      type: "usage",
-      creditsCharged: turn.creditsCharged,
-      balance: turn.balance,
-      ...turn.free ? {
-        free: true,
-        creditsWaived: turn.creditsWaived ?? 0,
-        freeCreditsLeft: turn.freeCreditsLeft ?? 0
-      } : {}
-    });
-    messages.push(turn.message);
+    emitUsage(turn);
     const content = messageText(turn.message);
-    if (content) lastText = content;
     const calls = turn.message.tool_calls ?? [];
+    if (calls.length === 0 && !content.trim() && !retriedEmpty) {
+      retriedEmpty = true;
+      continue;
+    }
+    retriedEmpty = false;
+    messages.push(turn.message);
+    if (content) lastText = content;
     if (calls.length === 0) {
       emit({ type: "final", content, creditsCharged, balance });
-      return { content, messages, creditsCharged, balance, creditsWaived, freeCreditsLeft, steps: step + 1 };
+      return {
+        content,
+        messages: withoutReasoning(messages),
+        creditsCharged,
+        balance,
+        creditsWaived,
+        freeCreditsLeft,
+        steps: step + 1
+      };
     }
     if (content) emit({ type: "message", content });
     pendingImages = [];
@@ -4030,7 +4164,7 @@ ${NO_SEARCH_INSTRUCTION}`,
   emit({ type: "max_steps" });
   return {
     content: lastText || "(stopped: reached max steps)",
-    messages,
+    messages: withoutReasoning(messages),
     creditsCharged,
     balance,
     creditsWaived,
@@ -4040,7 +4174,16 @@ ${NO_SEARCH_INSTRUCTION}`,
   };
   function stop(reason) {
     emit({ type: reason });
-    return { content: lastText, messages, creditsCharged, balance, creditsWaived, freeCreditsLeft, steps: 0, stopped: reason };
+    return {
+      content: lastText,
+      messages: withoutReasoning(messages),
+      creditsCharged,
+      balance,
+      creditsWaived,
+      freeCreditsLeft,
+      steps: 0,
+      stopped: reason
+    };
   }
 }
 function toolMessage(call, content) {
@@ -4143,7 +4286,7 @@ var init_agent = __esm({
     init_mcp();
     init_client();
     SUBAGENT_MAX_STEPS = 12;
-    SYSTEM_PROMPT = "You are Clixad, a terminal coding agent. You can read, search, write and edit files and run shell commands, all confined to the user's workspace. Find your way around with glob and grep before reading whole files. Prefer edit_file over write_file for existing files. Make minimal correct edits, verify them when a test or build command is available, and stop when the task is complete. Keep your final message short: say what you did and why.\n\nNot every message is a task. If the user asks a question, or asks you to say something, answer in plain text and call no tools at all. Reach for a file or a command only when the request is actually about one, and when a message is ambiguous, prefer the reading of it that changes nothing.\n\nA tool call that was refused did not happen. Never describe it as done, and do not repeat it on a later message unless the user asks for it again.\n\nReach outside the workspace when the answer is outside it: web_search for current documentation, releases and error messages, then web_fetch to read the page. Do not guess at an API you could look up.\n\nStart anything that does not exit on its own \u2014 dev servers, watchers, tailed logs \u2014 with run_command background: true, and read it with read_output. A foreground command is killed after its timeout.\n\nWhen finding something out means opening many files, give it to task instead: the sub-agent reads them in its own context and reports back, which keeps this conversation short. Use todo_write for work with several distinct steps, and keep it current as you go.";
+    SYSTEM_PROMPT = "You are Clixad, a terminal coding agent. You can read, search, write and edit files and run shell commands, all confined to the user's workspace. When someone asks who or what you are, answer that you are Clixad, in their language; do not introduce yourself as the underlying language model or as a product of the company that trained it. If asked which model you run on, say it is the one selected with /model, shown under the input box. Find your way around with glob and grep before reading whole files. Prefer edit_file over write_file for existing files. Make minimal correct edits, verify them when a test or build command is available, and stop when the task is complete. Keep your final message short: say what you did and why.\n\nNot every message is a task. If the user asks a question, or asks you to say something, answer in plain text and call no tools at all. Reach for a file or a command only when the request is actually about one, and when a message is ambiguous, prefer the reading of it that changes nothing.\n\nA tool call that was refused did not happen. Never describe it as done, and do not repeat it on a later message unless the user asks for it again.\n\nReach outside the workspace when the answer is outside it: web_search for current documentation, releases and error messages, then web_fetch to read the page. Do not guess at an API you could look up.\n\nStart anything that does not exit on its own \u2014 dev servers, watchers, tailed logs \u2014 with run_command background: true, and read it with read_output. A foreground command is killed after its timeout.\n\nWhen finding something out means opening many files, give it to task instead: the sub-agent reads them in its own context and reports back, which keeps this conversation short. Use todo_write for work with several distinct steps, and keep it current as you go.";
     NO_SEARCH_INSTRUCTION = [
       "# Web search is not available on this gateway",
       "There is no web_search tool. web_fetch works normally and needs no key, so fetch a URL directly",
@@ -4528,17 +4671,28 @@ var init_kimi = __esm({
       "gpt-5-nano": 4e5,
       "gemini-2.5-flash-lite": 1048576,
       "deepseek-v4-flash": 1048576,
-      "gemini-3.1-flash-lite": 1048576,
-      "kimi-k2": 131072,
+      "gemini-3.5-flash-lite": 1048576,
+      "kimi-k2.5": 262144,
+      "gemini-3.8-flash": 1048576,
       "kimi-k2.7-code": 262144,
       "claude-haiku-4.5": 2e5,
-      "gemini-3.6-flash": 1048576,
-      "claude-sonnet-5": 1e6,
-      "gpt-5.2": 4e5,
+      "claude-sonnet-5.5": 1e6,
+      "gpt-6-sol": 105e4,
       "kimi-k3": 1048576,
+      "claude-opus-5.5": 1e6,
+      "claude-fable-5.1": 1e6,
+      // Retired on 2026-09-27 and served by their successor (`RETIRED_MODELS` in
+      // packages/pricing), so an install still configured with one compacts
+      // against the window of the model that actually answers.
+      "gemini-3.1-flash-lite": 1048576,
+      "kimi-k2": 262144,
+      "gemini-3.6-flash": 1048576,
+      "gpt-5.2": 105e4,
       "claude-opus-5": 1e6,
       "gpt-5.5": 105e4,
-      "gpt-5.2-pro": 4e5
+      "gpt-5.2-pro": 105e4,
+      // Retired on 2026-09-29 for Claude Sonnet 5.5, same window.
+      "claude-sonnet-5": 1e6
     };
     DEFAULT_CONTEXT_TOKENS = 256e3;
     INSTALL_HELP = `Kimi CLI is not installed (or not on PATH).
@@ -4588,6 +4742,14 @@ function bannerTip(index) {
   const i = index ?? Math.floor(Math.random() * BANNER_TIPS.length);
   return BANNER_TIPS[(i % BANNER_TIPS.length + BANNER_TIPS.length) % BANNER_TIPS.length];
 }
+function greeting(opts, nameWidth) {
+  if (!opts.name) return "Welcome to Clixad!";
+  const name = nameWidth === void 0 ? opts.name : truncate(opts.name, nameWidth);
+  return opts.newAccount ? `Welcome to Clixad, ${name}!` : `Welcome back, ${name}!`;
+}
+function balanceLabel(opts) {
+  return opts.balance === void 0 ? "balance unavailable" : `${opts.balance.toLocaleString("en-US")} credits`;
+}
 function earnedLabel(opts) {
   return `$${opts.earnedUsdToday.toFixed(2)}/$${opts.maxRewardUsd.toFixed(2)} today`;
 }
@@ -4597,7 +4759,7 @@ function welcomeBanner(opts) {
   const rightW = Math.min(RIGHT_MAX, Math.max(26, inner - 30));
   const leftW = inner - rightW;
   const cwd = opts.cwd.replace(homedir6(), "~").replace(/\\/g, "/");
-  const welcome = opts.name ? `Welcome back, ${truncate(opts.name, 18)}!` : "Welcome to Clixad!";
+  const welcome = greeting(opts, Math.max(1, Math.min(18, leftW - (opts.newAccount ? 20 : 15))));
   const duck = duckLines();
   const home = truncate(cwd, leftW);
   const hint = bannerTip(opts.tipIndex);
@@ -4623,8 +4785,10 @@ function welcomeBanner(opts) {
     tip("/wallet", "balance & ads"),
     cell("", 0),
     cell(BOLD + MANGO + "Wallet" + R2, 6),
-    cell(TEXT + `${opts.balance.toLocaleString("en-US")} credits` + R2, `${opts.balance.toLocaleString("en-US")} credits`.length),
-    cell(MUTED + earnedLabel(opts) + R2, earnedLabel(opts).length)
+    cell(TEXT + balanceLabel(opts) + R2, balanceLabel(opts).length),
+    // Without a wallet there is no earned figure either, and "$0.00/$0.00" is
+    // two invented numbers rather than a statement of what is unknown.
+    opts.balance === void 0 ? cell("", 0) : cell(MUTED + earnedLabel(opts) + R2, earnedLabel(opts).length)
   ];
   const rows = Math.max(left.length, right.length);
   const out = [];
@@ -4642,9 +4806,9 @@ function welcomeBanner(opts) {
 }
 function compactBanner(opts) {
   const width = Math.max(1, opts.width ?? MIN_BANNER_WIDTH);
-  const welcome = truncate(opts.name ? `Welcome back, ${opts.name}!` : "Welcome to Clixad!", Math.max(1, width - 2));
+  const welcome = truncate(greeting(opts), Math.max(1, width - 2));
   const hint = bannerTip(opts.tipIndex);
-  const balance = `${opts.balance.toLocaleString("en-US")} credits`;
+  const balance = balanceLabel(opts);
   const room = width - (4 + stringWidth(hint.key) + 1 + 4 + stringWidth(balance));
   const desc = room >= 3 ? truncate(hint.desc, room) : "";
   const tipRow = desc ? `  ${MANGO}\u25C6${R2} ${BOLD}${TEXT}${hint.key}${R2} ${FAINT}${desc}${R2}  ${FAINT}\xB7${R2} ${balance}` : truncate(`  ${MANGO}\u25C6${R2} ${BOLD}${TEXT}${hint.key}${R2}  ${FAINT}\xB7${R2} ${balance}`, width);
@@ -4778,6 +4942,34 @@ function readVersion() {
     return "unknown";
   }
 }
+function isNewerVersion(candidate, current) {
+  const parse2 = (v) => {
+    const m = /^(\d+)\.(\d+)\.(\d+)(?:-([0-9A-Za-z.-]+))?$/.exec(v.trim());
+    if (!m) return void 0;
+    return { core: [Number(m[1]), Number(m[2]), Number(m[3])], pre: m[4] ? m[4].split(".") : [] };
+  };
+  const a = parse2(candidate);
+  const b = parse2(current);
+  if (!a || !b) return false;
+  for (let i = 0; i < 3; i++) {
+    if (a.core[i] !== b.core[i]) return a.core[i] > b.core[i];
+  }
+  if (!a.pre.length || !b.pre.length) return !a.pre.length && b.pre.length > 0;
+  for (let i = 0; i < Math.max(a.pre.length, b.pre.length); i++) {
+    const x = a.pre[i];
+    const y = b.pre[i];
+    if (x === void 0) return false;
+    if (y === void 0) return true;
+    if (x === y) continue;
+    const nx = /^\d+$/.test(x) ? Number(x) : void 0;
+    const ny = /^\d+$/.test(y) ? Number(y) : void 0;
+    if (nx !== void 0 && ny !== void 0) return nx > ny;
+    if (nx !== void 0) return false;
+    if (ny !== void 0) return true;
+    return x > y;
+  }
+  return false;
+}
 var VERSION, VERSION_LABEL;
 var init_version = __esm({
   "src/version.ts"() {
@@ -5617,7 +5809,7 @@ var init_views = __esm({
 });
 
 // src/tui/app.tsx
-import { useCallback, useEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
+import { useCallback, useEffect, useLayoutEffect, useMemo, useRef, useState, useSyncExternalStore } from "react";
 import { Box as Box2, Static, Text as Text2, useApp, useInput, usePaste, useStdout } from "ink";
 import { Fragment, jsx as jsx2, jsxs as jsxs2 } from "react/jsx-runtime";
 function buyDeclarationLines(pack) {
@@ -5668,6 +5860,7 @@ function App({
   wallet,
   streak,
   session,
+  newAccount,
   initialTask,
   notices: notices2,
   sponsorServe,
@@ -5690,8 +5883,11 @@ function App({
       text: (cols >= MIN_BANNER_WIDTH ? welcomeBanner : compactBanner)({
         width: cols,
         name: config.login ?? config.email?.split("@")[0],
+        ...newAccount ? { newAccount: true } : {},
         model: config.model,
-        balance: wallet?.balance ?? 0,
+        // Undefined when the wallet could not be read: the banner says so
+        // rather than drawing "0 credits", which reads as an empty account.
+        balance: wallet?.balance,
         adsToday: wallet?.ads_today ?? 0,
         earnedUsdToday: wallet?.earned_usd_today ?? 0,
         maxRewardUsd: wallet?.max_reward_usd_per_day ?? 0,
@@ -5705,7 +5901,7 @@ function App({
   const [editor, setEditor] = useState(EMPTY);
   const [busy, setBusy] = useState(false);
   const [live, setLive] = useState(null);
-  const [balance, setBalance] = useState(wallet?.balance ?? 0);
+  const [balance, setBalance] = useState(wallet?.balance);
   const [spent, setSpent] = useState(0);
   const [freeTier, setFreeTier] = useState(wallet?.free_tier);
   const [model, setModel2] = useState(config.model);
@@ -5761,6 +5957,7 @@ function App({
   const pendingTaskRef = useRef(null);
   const pendingFreeRef = useRef([]);
   const pendingGrantRef = useRef(0);
+  const pendingBalanceRef = useRef(void 0);
   const mcpRef = useRef(McpHub.empty());
   const todosRef = useRef(new TodoList());
   const lastTurnRef = useRef(null);
@@ -5826,6 +6023,9 @@ function App({
   );
   const tallyRef = useRef(createTally());
   const heightCacheRef = useRef(/* @__PURE__ */ new Map());
+  const screenRef = useRef(
+    null
+  );
   const push = useCallback((e) => {
     const id = idRef.current++;
     setEntries((prev) => [...prev, { ...e, id }]);
@@ -5862,11 +6062,32 @@ function App({
     deltaBufRef.current = "";
   }, []);
   useEffect(() => dropDelta, [dropDelta]);
+  useEffect(() => {
+    if (wallet) return;
+    const ctl = new AbortController();
+    void client.wallet(ctl.signal).then((w) => {
+      setBalance((current) => current ?? w.balance);
+      setFreeTier((current) => current ?? w.free_tier);
+    }).catch(() => void 0);
+    return () => ctl.abort();
+  }, []);
   useEffect(() => {
     client.onNotice = (text2) => push({ kind: "notice", tone: "warn", text: text2 });
     for (const text2 of notices2 ?? []) push({ kind: "notice", tone: "warn", text: `  ${text2}` });
     const files = contextRef.current.files;
     if (files.length) push({ kind: "notice", text: `  context: ${files.join(", ")}` });
+    if (!wallet) {
+      let host = config.gatewayUrl;
+      try {
+        host = new URL(config.gatewayUrl).host;
+      } catch {
+      }
+      push({
+        kind: "notice",
+        tone: "warn",
+        text: `  ${host} did not answer, so the balance is unknown for now. It fills in once a request gets through.`
+      });
+    }
     const streakLine = streak && streak.claimed ? streakLabel(streak) : null;
     if (streakLine) push({ kind: "notice", tone: "good", text: `  ${streakLine}` });
     const freeLine = freeTierNotice({ model: config.model, balance: wallet?.balance ?? 0, free: wallet?.free_tier });
@@ -5883,6 +6104,24 @@ function App({
     client.models().then((m) => {
       catalogRef.current = m;
       searchRef.current = client.capabilities?.web_search === true;
+      const successor = client.retiredModels[modelRef.current];
+      if (successor) {
+        const from = modelRef.current;
+        config.model = successor;
+        saveConfig(config);
+        switchModel(successor);
+        push({
+          kind: "notice",
+          text: `  ${from} was retired; now using its successor, ${successor}. /model picks another.`
+        });
+      }
+      const latest = client.latestCli;
+      if (latest && isNewerVersion(latest, VERSION)) {
+        push({
+          kind: "notice",
+          text: `  clixad ${latest} is out (you have ${VERSION}). Update with: npm install -g clixad@latest`
+        });
+      }
     }).catch(() => void 0);
   }, []);
   useEffect(() => {
@@ -6122,7 +6361,7 @@ function App({
             setSpent((s) => s + res.creditsCharged);
             push({
               kind: "notice",
-              text: `  compacted context: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged} credits)`
+              text: `  compacted context: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged.toLocaleString("en-US")} credits)`
             });
           }
         }
@@ -6231,19 +6470,29 @@ ${NO_SEARCH_INSTRUCTION}`),
           pendingTaskRef.current = { task, images };
           pendingFreeRef.current = err.freeModels;
           pendingGrantRef.current = err.grantPerAd;
+          pendingBalanceRef.current = err.balance;
           const free = err.freeModels[0];
           push({
             kind: "notice",
             tone: "warn",
-            text: free ? `  Out of credits on ${model2} (balance ${err.balance}, need ~${err.estimatedCost}).
+            text: free ? `  ${shortfallHeadline(err, model2)}
   Press enter \u2014 ${free.id} is still free today (~${free.turnsLeft} turn${free.turnsLeft === 1 ? "" : "s"} left), or take an offer instead.
   Your request is kept either way, so you will not have to type it again.
   Offers you are screened out of pay nothing; that is normal, just start another.
-  /buy is there too, if you would rather pay than do an offer.` : `  Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).
+  /buy is there too, if you would rather pay than do an offer.` : `  ${shortfallHeadline(err, model2)}
   Press enter to open the ad wall \u2014 offers pay ${grantLabel(err.grantPerAd)}.
   I'll continue automatically. Offers you are screened out of pay nothing;
   that is normal, just start another.
-  /buy is there too, if you would rather pay than do an offer.`
+` + // A wallet that is short rather than empty has a third way on,
+            // and it is the cheapest: the same credits on a smaller model.
+            // It names the command and no figure, since what a model costs
+            // is the gateway's to say and `/model` says it.
+            (err.balance > 0 ? `  Or pick a cheaper model with /model, which shows what each one costs.
+` : "") + // One clause, last, and it stays last. The wall is how this product
+            // is meant to be paid for and the offer is free; naming /buy here
+            // is discoverability rather than a pitch, and it is the moment
+            // somebody actually wants to know the command exists.
+            `  /buy is there too, if you would rather pay than do an offer.`
           });
         } else if (err instanceof AuthError) {
           push({ kind: "notice", tone: "error", text: NOT_SIGNED_IN });
@@ -6370,7 +6619,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   const runAdWall = useCallback(async () => {
     const pending = pendingTaskRef.current;
     pendingTaskRef.current = null;
-    const before = balance;
+    let before = balance ?? (await client.wallet().catch(() => void 0))?.balance;
     const code = await client.handoffCode();
     const base = config.dashboardUrl.replace(/\/+$/, "");
     openBrowser(code ? `${base}/?c=${encodeURIComponent(code)}` : base);
@@ -6388,7 +6637,10 @@ ${NO_SEARCH_INSTRUCTION}`),
         await sleep4(3e3, signal);
         if (signal.aborted) break;
         const w = await client.wallet(signal).catch(() => void 0);
-        if (w && w.balance > before) {
+        if (w && before === void 0) {
+          before = w.balance;
+          setBalance(w.balance);
+        } else if (w && before !== void 0 && w.balance > before) {
           setBalance(w.balance);
           credited = true;
         }
@@ -6431,7 +6683,7 @@ ${NO_SEARCH_INSTRUCTION}`),
     ];
     setPickerSel(0);
     setPicker({
-      title: "Out of credits",
+      title: (pendingBalanceRef.current ?? 0) > 0 ? "Not enough credits" : "Out of credits",
       subtitle: "Pick a free model to carry on with, or earn credits at the wall.",
       items,
       onPick: (choice) => {
@@ -6482,7 +6734,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   }, [client, push, runBusy]);
   const runCheckout = useCallback(
     async (pack) => {
-      const before = balance;
+      let before = balance ?? (await client.wallet().catch(() => void 0))?.balance;
       let credited = false;
       let stopped = false;
       await runBusy(WAITING_FOR_PAYMENT, async (signal) => {
@@ -6506,7 +6758,10 @@ ${NO_SEARCH_INSTRUCTION}`),
           await sleep4(3e3, signal);
           if (signal.aborted) break;
           const w = await client.wallet(signal).catch(() => void 0);
-          if (w && w.balance > before) {
+          if (w && before === void 0) {
+            before = w.balance;
+            setBalance(w.balance);
+          } else if (w && before !== void 0 && w.balance > before) {
             setBalance(w.balance);
             credited = true;
           }
@@ -6589,7 +6844,7 @@ ${NO_SEARCH_INSTRUCTION}`),
             setSpent((s) => s + res.creditsCharged);
             push({
               kind: "notice",
-              text: `  compacted: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged} credits)`
+              text: `  compacted: ~${Math.round(res.before / 1e3)}k \u2192 ~${Math.round(res.after / 1e3)}k tokens (${res.creditsCharged.toLocaleString("en-US")} credits)`
             });
           });
           return;
@@ -7275,7 +7530,16 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
     }, 0);
   }, [entries, cols]);
   const used = chromeHeight + menu.length + pickerHeight + askHeight + planHeight + buyHeight + busyHeight + liveHeight;
-  const spacer = Math.max(0, viewport - printed - used);
+  const lastScreen = screenRef.current;
+  const freshScreen = !lastScreen || lastScreen.epoch !== staticEpoch || lastScreen.rows !== rows || lastScreen.cols !== cols || printed < lastScreen.printed;
+  const onScreen = Math.max(
+    0,
+    Math.min(freshScreen ? printed : lastScreen.onScreen + (printed - lastScreen.printed), viewport - used)
+  );
+  const spacer = Math.max(0, viewport - onScreen - used);
+  useLayoutEffect(() => {
+    screenRef.current = { epoch: staticEpoch, rows, cols, printed, onScreen };
+  });
   const labelW = Math.min(
     Math.max(1, Math.floor(cols * 0.5)),
     menu.reduce((w, c2) => Math.max(w, visibleLength(c2.label)), 0)
@@ -7299,7 +7563,7 @@ ${dropped.map((l) => `  \xB7 ${l}`).join("\n")}`
   let estimate;
   const info = catalogRef.current.find((m) => m.id === model);
   const shape = client.taskShape;
-  if (!busy && info && shape && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
+  if (!busy && info && shape && balance !== void 0 && typed.trim() !== "" && !/^[/!]/.test(typed.trimStart())) {
     const range = estimateTask(info, conversationUsed + schemaTokens + estimateTokens(typed), shape);
     const onFree = Boolean(info.free && freeTier?.models.includes(model));
     const verdict = taskVerdict(range, { balance, ...onFree ? { freeLeft: freeTier.credits_left } : {} });
@@ -7489,7 +7753,7 @@ function modelHint(m, free) {
 function turnMeta(result) {
   const n = (v) => v.toLocaleString("en-US");
   const balance = `balance ${n(result.balance)}`;
-  if (result.creditsWaived <= 0) return `[${result.creditsCharged} credits \xB7 ${balance}]`;
+  if (result.creditsWaived <= 0) return `[${n(result.creditsCharged)} credits \xB7 ${balance}]`;
   const left = result.freeCreditsLeft === void 0 ? "" : ` \xB7 ${n(result.freeCreditsLeft)} free credits left`;
   if (result.creditsCharged > 0) {
     return `[free: ${n(result.creditsWaived)} credits \xB7 then ${n(result.creditsCharged)} charged \xB7 ${balance}]`;
@@ -7508,7 +7772,12 @@ function statusRow(o, estimate, cols) {
   const burn = o.spent > 0 && o.minutes >= 1 ? `${Math.round(o.spent / o.minutes).toLocaleString("en-US")} cr/min` : void 0;
   const clauses = [
     { text: o.model, rank: KEEP_ALWAYS },
-    { text: `${o.balance.toLocaleString("en-US")} cr`, rank: KEEP_ALWAYS },
+    {
+      // "? cr" rather than "0 cr": unknown is not empty, and an empty-looking
+      // wallet is the one misreading on this row that frightens somebody.
+      text: o.balance === void 0 ? "? cr" : `${o.balance.toLocaleString("en-US")} cr`,
+      rank: KEEP_ALWAYS
+    },
     // Above the context warning, below the balance. It is the second number
     // deciding whether the next turn costs anything, and unlike the spend it is
     // *news* — it only exists while a free model is selected and it counts down.
@@ -7746,7 +8015,7 @@ async function main() {
   for (const text of configNotices) console.error(c.yellow(text));
   switch (cmd) {
     case "login":
-      return login(client, config, rest);
+      return void await login(client, config, rest, { nextStep: true });
     case "logout":
       return logout(config);
     case "whoami":
@@ -7810,7 +8079,7 @@ async function main() {
       return repl(client, config, { task: [cmd, ...rest].join(" ").trim(), notices: configNotices });
   }
 }
-async function login(client, config, args) {
+async function login(client, config, args, opts = {}) {
   const parsed = parseLoginArgs(args);
   for (const line2 of TERMS_NOTICE.split("\n")) console.log(c.dim(`  ${line2}`));
   const outcome = await performLogin(client, config, parsed, {
@@ -7836,20 +8105,25 @@ async function login(client, config, args) {
       if (account.model) console.log(`  model: ${c.bold(account.model)} ${c.dim("(the default for new accounts)")}`);
       await showStreak(client);
       console.log(c.dim(`  token stored in ${configPath()}`));
-      return;
+      if (opts.nextStep) {
+        console.log(`
+  Next: open a project folder and run ${c.cyan("clixad")} to start coding.`);
+      }
+      return { created: account.created };
     }
     case "closed":
       reportSignupClosed(outcome.message, outcome.hadInvite);
       process.exitCode = 1;
-      return;
+      return void 0;
     case "timeout":
       console.log(c.red("\n  login timed out \u2014 run `clixad login` again."));
-      return;
+      return void 0;
     case "aborted":
-      return;
+      return void 0;
     default:
       console.log(c.red(`
   login failed: ${outcome.error}`));
+      return void 0;
   }
 }
 function reportSignupClosed(message, hadInvite) {
@@ -8051,7 +8325,7 @@ ${NO_SEARCH_INSTRUCTION}`),
   } catch (err) {
     if (err instanceof PaywallError) {
       console.log(c.yellow(`
-Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+${shortfallHeadline(err, config.model)}`));
       const freeLine = freeAlternativeLine(err.freeModels);
       if (freeLine) console.log(c.green(freeLine));
       console.log(
@@ -8102,7 +8376,7 @@ async function codeCmd(client, config, rest) {
   const w = await safeWallet(client);
   if (w) {
     console.log(
-      c.dim(`  wallet: ${w.balance} credits \xB7 model ${config.model} \xB7 gateway ${config.gatewayUrl}`)
+      c.dim(`  wallet: ${credits(w.balance)} credits \xB7 model ${config.model} \xB7 gateway ${config.gatewayUrl}`)
     );
     if (w.balance <= 0) {
       console.log(c.yellow("  You're out of credits \u2014 run `clixad earn` first, or the agent will hit a paywall."));
@@ -8137,8 +8411,9 @@ async function repl(client, config, opts = {}) {
     console.log(c.yellow('Interactive mode needs a terminal. Use `clixad -p "..."` for scripted runs.'));
     return;
   }
+  let newAccount = false;
   if (!config.token) {
-    await login(client, config, []);
+    newAccount = Boolean((await login(client, config, []))?.created);
     if (!config.token) return;
   }
   let session;
@@ -8149,8 +8424,7 @@ async function repl(client, config, opts = {}) {
     session = loadSession(opts.resume);
     if (!session) return console.log(c.red(`no such session: ${opts.resume}`));
   }
-  const streak = await client.claimStreak();
-  const wallet = await safeWallet(client);
+  const { streak, wallet } = await startupReads(client, config.gatewayUrl);
   const cwd = process.cwd();
   const initHint = shouldSuggestInit(cwd) ? { returning: hasSessionIn(cwd) } : void 0;
   clearScreen();
@@ -8161,24 +8435,30 @@ async function repl(client, config, opts = {}) {
     wallet,
     streak,
     session,
+    newAccount,
     initialTask: opts.task,
     ...opts.notices?.length ? { notices: opts.notices } : {},
     ...initHint ? { initHint } : {}
   });
 }
 async function runTurn(client, config, messages) {
+  let started = false;
   try {
-    process.stdout.write(c.green("assistant ") + "");
     const result = await client.chatStream(messages, config.model, {
-      onDelta: (chunk) => process.stdout.write(chunk)
+      onDelta: (chunk) => {
+        if (!started) process.stdout.write(c.green("assistant "));
+        started = true;
+        process.stdout.write(chunk);
+      }
     });
+    if (!started) process.stdout.write(c.green("assistant "));
     process.stdout.write("\n");
-    console.log(c.dim(`  [${result.creditsCharged} credits \xB7 balance ${result.balance}]`));
+    console.log(c.dim(`  [${credits(result.creditsCharged)} credits \xB7 balance ${credits(result.balance)}]`));
     return result;
   } catch (err) {
-    process.stdout.write("\n");
+    if (started) process.stdout.write("\n");
     if (err instanceof PaywallError) {
-      console.log(c.yellow(`Out of credits (balance ${err.balance}, need ~${err.estimatedCost}).`));
+      console.log(c.yellow(shortfallHeadline(err, config.model)));
       const freeLine = freeAlternativeLine(err.freeModels);
       if (freeLine) console.log(c.green(freeLine));
       console.log(
@@ -8208,29 +8488,69 @@ async function safeWallet(client) {
     return void 0;
   }
 }
+var CONNECTING_AFTER_MS = 700;
+var WAKING_AFTER_MS = 6e3;
+async function startupReads(client, gatewayUrl) {
+  const host = (() => {
+    try {
+      return new URL(gatewayUrl).host;
+    } catch {
+      return gatewayUrl;
+    }
+  })();
+  const say = (text) => {
+    if (process.stdout.isTTY) console.log(c.dim(text));
+  };
+  const timers = [
+    setTimeout(() => say(`  connecting to ${host}\u2026`), CONNECTING_AFTER_MS),
+    setTimeout(
+      () => say("  still waiting: the server sleeps after a quiet spell and takes up to a minute to wake. ctrl+c cancels."),
+      WAKING_AFTER_MS
+    )
+  ];
+  try {
+    const [streak, wallet] = await Promise.all([client.claimStreak(), safeWallet(client)]);
+    const balance = streak?.claimed ? streak.balance : wallet?.balance;
+    return {
+      streak,
+      wallet: wallet && balance !== void 0 ? { ...wallet, balance } : wallet
+    };
+  } finally {
+    for (const t of timers) clearTimeout(t);
+  }
+}
 function printHelp() {
-  console.log(`${c.bold("clixad")} \u2014 free AI coding in your terminal, funded by ads
+  const rows = [
+    ["", "", "start the interactive coding agent here (signs you in if needed)"],
+    ['"<task>"', "", "the same, with a task already running"],
+    ["--continue", "", "resume the last session in this directory"],
+    ["--resume", "[id]", "list saved sessions, or resume one"],
+    ["-p", '"<task>"', "headless agent run (read-only tools)"],
+    ["ask", '"<prompt>"', "one-shot answer, no tools"],
+    ["models", "", "models with credit prices, and which are free today"],
+    ["model", "<id>", "set the default model"],
+    ["wallet", "", "balance, offers today, recent activity"],
+    ["earn", "", "open the offer wall to earn credits"],
+    ["refer", "", "your invite code, and what it has earned"],
+    ["redeem", "<code>", "spend a code you were given"],
+    ["login", "[email]", "sign in or create an account (--invite <code> if you have one)"],
+    ["logout", "", "forget the stored token"],
+    ["whoami", "", "account and balance"],
+    ["code", '["<task>"]', "launch the Kimi CLI coding agent on this directory"],
+    ["--version", "", "print the version and exit"]
+  ];
+  const plain = (name, arg) => `clixad${name ? ` ${name}` : ""}${arg ? ` ${arg}` : ""}`;
+  const width = Math.max(...rows.map(([name, arg]) => plain(name, arg).length)) + 2;
+  const lines = rows.map(([name, arg, desc]) => {
+    const shown = `${c.cyan("clixad")}${name ? ` ${c.cyan(name)}` : ""}${arg ? ` ${arg}` : ""}`;
+    return `  ${shown}${" ".repeat(width - plain(name, arg).length)}${desc}`;
+  });
+  console.log(`${c.bold("clixad")}: free AI coding in your terminal, funded by ads
 
-  ${c.cyan("login")} [email]      create/attach an account (${c.dim("--invite <code>")} if you have one)
-  ${c.cyan("logout")}            forget the stored token
-  ${c.cyan("whoami")}            show account + balance
-  ${c.cyan("models")}            list models with credit prices, and which are free today
-  ${c.cyan("model")} <id>        set default model
-  ${c.cyan("wallet")}            balance, ads today, ledger
-  ${c.cyan("earn")}              open the ad wall to earn credits
-  ${c.cyan("refer")}             your invite code, and what it has earned
-  ${c.cyan("redeem")} <code>     spend a code you were given
-  ${c.cyan("ask")} "<prompt>"    one-shot completion (no tools)
-  ${c.cyan("agent")} "<task>"    open the REPL with a task already running
-  ${c.cyan("-p")} "<task>"       headless agent run (read-only tools)
-  ${c.cyan("code")} ["<task>"]   launch the full Kimi CLI coding agent on the current dir
-  ${c.cyan("--continue")}        resume the last session in this directory
-  ${c.cyan("--resume")} [id]     list saved sessions, or resume one
-  ${c.cyan("--version")}         print the version and exit
-  (no command)        interactive coding REPL ${c.dim("(signs you in if needed)")}
-  "<task>"            same as ${c.cyan("agent")} \u2014 anything that is not a command is a task
+${lines.join("\n")}
 
-  ${c.dim("Discord: https://discord.gg/pwxPM3QyF \u2014 bugs and feature requests are read there")}`);
+  Inside the agent, ${c.cyan("/help")} lists everything else, including ${c.cyan("/buy")} for credit packs.
+  ${c.dim("Discord: https://discord.gg/pwxPM3QyF (bugs and feature requests are read there)")}`);
 }
 main().catch((err) => {
   console.error(c.red(err.message));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clixad",
-  "version": "0.0.1-beta.22",
+  "version": "0.0.1-beta.24",
   "description": "Free AI coding agent in your terminal, funded by rewarded ads.",
   "license": "UNLICENSED",
   "type": "module",