@raegent/earshot 0.1.0 → 0.3.0

package/dist/main.js

@@ -17094,6 +17094,7 @@ class Agent {
   readFiles = new Set;
   queued = [];
   rules;
+  resolved;
   mode;
   totalCostUsd = 0;
   maxCostUsd;
@@ -17129,6 +17130,18 @@ class Agent {
     this.askFn = options.ask;
     this.systemPrompt = options.system;
     this.maxCostUsd = options.maxCostUsd;
+    this.resolved = options.model;
+  }
+  get model() {
+    return this.resolved;
+  }
+  async changeModel(ref) {
+    const resolved = await resolveModel(this.options.registry, ref);
+    this.resolved = resolved;
+    return resolved;
+  }
+  get permissionRules() {
+    return [...this.rules];
   }
   get budgetUsd() {
     return this.maxCostUsd;
@@ -17176,7 +17189,7 @@ ${renderPlan(this.plan)}`;
     this.options.onCost?.(costUsd);
   }
   get contextUse() {
-    return { tokens: this.lastRequestTokens, window: this.options.model.model.contextWindow ?? 0 };
+    return { tokens: this.lastRequestTokens, window: this.resolved.model.contextWindow ?? 0 };
   }
   get touchedFiles() {
     return [...this.readFiles];
@@ -17204,12 +17217,12 @@ ${renderPlan(this.plan)}`;
     this.checksThisTurn = 0;
     const promptText = userPromptText(prompt);
     const promptParts = typeof prompt === "string" ? [{ type: "text", text: prompt }] : prompt.map((part) => ({ ...part }));
-    if (promptParts.some((part) => part.type === "image") && !this.options.model.model.capabilities.vision) {
+    if (promptParts.some((part) => part.type === "image") && !this.resolved.model.capabilities.vision) {
       yield {
         type: "error",
         error: {
           kind: "invalid_request",
-          message: `${this.options.model.model.name} does not support image input`,
+          message: `${this.resolved.model.name} does not support image input`,
           retryable: false
         }
       };
@@ -17254,7 +17267,7 @@ ${context.join(`
       content
     });
     const maxSteps = this.options.maxSteps ?? DEFAULT_MAX_STEPS;
-    const modelName = `${this.options.model.provider.id}/${this.options.model.model.id}`;
+    const modelName = `${this.resolved.provider.id}/${this.resolved.model.id}`;
     for (let step = 0;step < maxSteps; step++) {
       if (signal.aborted) {
         yield { type: "turn_end", reason: "aborted" };
@@ -17278,7 +17291,7 @@ ${context.join(`
       yield { type: "model_start", model: modelName };
       let assistant;
       let failed;
-      for await (const event of streamModel(this.options.registry, this.options.model, {
+      for await (const event of streamModel(this.options.registry, this.resolved, {
         system: this.effectiveSystem,
         messages,
         tools: this.offeredTools(),
@@ -17293,7 +17306,7 @@ ${context.join(`
             break;
           case "finish": {
             assistant = event.message;
-            const costUsd = turnCost(this.options.model.model, event.usage);
+            const costUsd = turnCost(this.resolved.model, event.usage);
             this.addCost(costUsd);
             yield { type: "usage", usage: event.usage, costUsd };
             break;
@@ -17598,11 +17611,20 @@ If something is failing, fix it or say what is ` + `failing and why - do not des
     return shapeMessages(base, { ...DEFAULT_SHAPER_OPTIONS, ...this.options.shapers });
   }
   async* prepareRequest(signal) {
-    const window = this.options.model.model.contextWindow ?? 0;
+    const window = this.resolved.model.contextWindow ?? 0;
     const policy = { threshold: 0.8, keepRecentMessages: 8, ...this.options.compaction };
     const shaped = this.requestMessages();
     if (!shouldCompact(shaped, this.effectiveSystem, window, policy))
       return;
+    yield* this.runCompaction(signal);
+  }
+  async* compactNow(signal) {
+    yield* this.runCompaction(signal);
+  }
+  async* runCompaction(signal) {
+    const window = this.resolved.model.contextWindow ?? 0;
+    const policy = { threshold: 0.8, keepRecentMessages: 8, ...this.options.compaction };
+    const shaped = this.requestMessages();
     const result = await compact({
       messages: shaped,
       system: this.effectiveSystem,
@@ -17625,7 +17647,7 @@ If something is failing, fix it or say what is ` + `failing and why - do not des
   }
   async summarise(messages, signal) {
     let text2 = "";
-    for await (const event of streamModel(this.options.registry, this.options.model, {
+    for await (const event of streamModel(this.options.registry, this.resolved, {
       system: SUMMARY_PROMPT,
       messages: [...messages, { role: "user", content: [{ type: "text", text: SUMMARY_PROMPT }] }],
       abortSignal: signal
@@ -18359,7 +18381,7 @@ class ShadowGit {
 }
 
 // packages/core/src/version.ts
-var VERSION = "0.1.0";
+var VERSION = "0.3.0";
 
 // packages/core/src/session/repair.ts
 var REPAIR_TEXT = "No result was recorded for this call: earshot exited before the tool finished. " + "The call may or may not have run, so treat its effect as unknown and check " + "the current state rather than assuming either outcome.";
@@ -18620,7 +18642,16 @@ function parseArgs(argv) {
       positionals.push(arg);
     }
   }
-  const known = new Set(["auth", "mcp", "extensions", "config", "models", "acp", "doctor"]);
+  const known = new Set([
+    "auth",
+    "mcp",
+    "extensions",
+    "config",
+    "models",
+    "acp",
+    "doctor",
+    "update"
+  ]);
   const command = positionals[0] !== undefined && known.has(positionals[0]) ? positionals[0] : undefined;
   return { command, flags, positionals: command ? positionals.slice(1) : positionals };
 }
@@ -20256,10 +20287,124 @@ run \`earshot models\` to see what is available
 }
 
 // packages/tui/src/app.tsx
-import { Box as Box8, Static, Text as Text9, useApp, useInput as useInput4 } from "ink";
+import { Box as Box9, Static, Text as Text10, useApp, useInput as useInput4 } from "ink";
 import { useCallback, useEffect as useEffect2, useRef as useRef2, useState as useState3 } from "react";
 
-// packages/tui/src/components/markdown.tsx
+// packages/tui/src/commands.ts
+var SPECS = [
+  {
+    name: "help",
+    summary: "List the commands you can type"
+  },
+  {
+    name: "model",
+    args: "[ref]",
+    summary: "Show the model in use, or switch to another for the rest of the session"
+  },
+  {
+    name: "mode",
+    args: "<plan|ask|accept-edits|auto|yolo>",
+    summary: "Change the permission mode"
+  },
+  {
+    name: "plan",
+    args: "<task>",
+    summary: "Draft a plan in plan mode and write it to a file",
+    idleOnly: true,
+    verbs: [
+      { name: "edit", summary: "Open the plan in $VISUAL/$EDITOR, or print its path" },
+      { name: "approve", summary: "Pin the plan as the file now reads for the rest of the run" },
+      { name: "show", summary: "Read the plan back" },
+      { name: "clear", summary: "Unpin the plan" }
+    ]
+  },
+  {
+    name: "compact",
+    summary: "Summarise the session so far and free up the context window",
+    idleOnly: true
+  },
+  {
+    name: "context",
+    summary: "Show what is in the context window and what compaction has dropped"
+  },
+  {
+    name: "cost",
+    args: "[usd]",
+    summary: "Show what this session has spent, or set the budget ceiling; 0 removes it"
+  },
+  {
+    name: "todo",
+    summary: "Show the agent's current todo list"
+  },
+  {
+    name: "permissions",
+    summary: "Show the permission mode and the rules in force"
+  },
+  {
+    name: "init",
+    summary: "Write an AGENTS.md describing this project",
+    idleOnly: true
+  },
+  {
+    name: "skills",
+    summary: "List discovered skills and user-defined commands"
+  },
+  {
+    name: "memory",
+    summary: "List remembered preferences, each with the sentence it came from",
+    verbs: [{ name: "forget", args: "<id>", summary: "Delete one remembered preference" }]
+  },
+  {
+    name: "tree",
+    summary: "List this session's prompts, numbered",
+    idleOnly: true
+  },
+  {
+    name: "rewind",
+    args: "<n>",
+    summary: "Go back to the state before prompt n; nothing is deleted",
+    idleOnly: true
+  },
+  {
+    name: "fork",
+    args: "<n>",
+    summary: "Branch from prompt n into a new transcript",
+    idleOnly: true
+  },
+  {
+    name: "undo",
+    summary: "Revert the last tool batch's file changes; again to step back further"
+  },
+  {
+    name: "exit",
+    aliases: ["quit"],
+    summary: "Quit"
+  }
+];
+var COMMANDS = SPECS;
+function findCommand(name) {
+  return COMMANDS.find((command) => command.name === name || command.aliases?.includes(name));
+}
+function commandRows() {
+  const rows = [];
+  for (const spec of COMMANDS) {
+    rows.push({
+      command: spec.args ? `/${spec.name} ${spec.args}` : `/${spec.name}`,
+      summary: spec.summary,
+      spec
+    });
+    for (const verb of spec.verbs ?? []) {
+      rows.push({
+        command: `/${spec.name} ${verb.name}${verb.args ? ` ${verb.args}` : ""}`,
+        summary: verb.summary,
+        spec
+      });
+    }
+  }
+  return rows;
+}
+
+// packages/tui/src/components/command-menu.tsx
 import { Box, Text } from "ink";
 
 // packages/tui/src/theme.ts
@@ -20292,13 +20437,123 @@ var MODE_COLOR = {
   yolo: theme.danger
 };
 
+// packages/tui/src/components/command-menu.tsx
+import { jsxDEV } from "react/jsx-dev-runtime";
+var SUMMARY_WIDTH = 58;
+var VISIBLE = 10;
+function menuEntries(query, commands, busy) {
+  const entries = [];
+  for (const spec of ranked(COMMANDS, query)) {
+    if (!matches2(spec.name, query))
+      continue;
+    const disabled = busy && spec.idleOnly === true;
+    const expanded = query !== "" && spec.name.startsWith(query);
+    for (const row of commandRows()) {
+      if (row.spec.name !== spec.name)
+        continue;
+      const isBase = row.command === (spec.args ? `/${spec.name} ${spec.args}` : `/${spec.name}`);
+      if (!isBase && !expanded)
+        continue;
+      entries.push({
+        insert: insertFor(row.command, spec),
+        label: row.command,
+        summary: row.summary,
+        ...disabled ? { disabled: true } : {}
+      });
+    }
+  }
+  for (const command of ranked(commands, query)) {
+    if (!matches2(command.name, query))
+      continue;
+    entries.push({
+      insert: `/${command.name}`,
+      label: `/${command.name}`,
+      summary: command.description,
+      scope: command.scope
+    });
+  }
+  return entries;
+}
+function insertFor(command, spec) {
+  const withoutArgs = spec.args ? command.replace(` ${spec.args}`, "") : command;
+  return withoutArgs.replace(/\s<[^>]*>$/, "");
+}
+var clamp = (text2) => text2.length <= SUMMARY_WIDTH ? text2 : `${text2.slice(0, SUMMARY_WIDTH - 1)}…`;
+function rowColor(entry, active) {
+  if (entry.disabled)
+    return { color: theme.muted };
+  if (active)
+    return { color: theme.user };
+  return {};
+}
+function matches2(name, query) {
+  return query === "" || name.includes(query);
+}
+function ranked(items, query) {
+  if (query === "")
+    return [...items];
+  return [
+    ...items.filter((item) => item.name.startsWith(query)),
+    ...items.filter((item) => !item.name.startsWith(query))
+  ];
+}
+function CommandMenu({ entries, selected }) {
+  if (entries.length === 0) {
+    return /* @__PURE__ */ jsxDEV(Box, {
+      marginTop: 1,
+      children: /* @__PURE__ */ jsxDEV(Text, {
+        color: theme.muted,
+        children: "no command matches"
+      }, undefined, false, undefined, this)
+    }, undefined, false, undefined, this);
+  }
+  const start = Math.min(Math.max(0, selected - VISIBLE + 1), Math.max(0, entries.length - VISIBLE));
+  const shown = entries.slice(start, start + VISIBLE);
+  const hidden = entries.length - shown.length;
+  return /* @__PURE__ */ jsxDEV(Box, {
+    flexDirection: "column",
+    marginTop: 1,
+    children: [
+      shown.map((entry, index) => {
+        const active = start + index === selected;
+        return /* @__PURE__ */ jsxDEV(Box, {
+          children: [
+            /* @__PURE__ */ jsxDEV(Text, {
+              color: active ? theme.user : theme.muted,
+              children: active ? "› " : "  "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV(Text, {
+              ...rowColor(entry, active),
+              children: entry.label.padEnd(34)
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV(Text, {
+              color: theme.muted,
+              children: clamp(`${entry.scope ? `[${entry.scope}] ` : ""}${entry.summary}${entry.disabled ? " (not while a turn is running)" : ""}`)
+            }, undefined, false, undefined, this)
+          ]
+        }, entry.label, true, undefined, this);
+      }),
+      /* @__PURE__ */ jsxDEV(Box, {
+        children: /* @__PURE__ */ jsxDEV(Text, {
+          color: theme.muted,
+          children: [
+            hidden > 0 ? `  ${hidden} more · ` : "  ",
+            "↑↓ choose · tab complete · enter run · esc close"
+          ]
+        }, undefined, true, undefined, this)
+      }, undefined, false, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+
 // packages/tui/src/components/markdown.tsx
-import { jsxDEV, Fragment } from "react/jsx-dev-runtime";
+import { Box as Box2, Text as Text2 } from "ink";
+import { jsxDEV as jsxDEV2, Fragment } from "react/jsx-dev-runtime";
 function Markdown({ text: text2 }) {
   const blocks = splitBlocks(text2);
-  return /* @__PURE__ */ jsxDEV(Box, {
+  return /* @__PURE__ */ jsxDEV2(Box2, {
     flexDirection: "column",
-    children: blocks.map((block, index) => /* @__PURE__ */ jsxDEV(Block, {
+    children: blocks.map((block, index) => /* @__PURE__ */ jsxDEV2(Block, {
       block
     }, index, false, undefined, this))
   }, undefined, false, undefined, this);
@@ -20377,19 +20632,19 @@ function splitBlocks(text2) {
 function Block({ block }) {
   switch (block.kind) {
     case "code":
-      return /* @__PURE__ */ jsxDEV(Box, {
+      return /* @__PURE__ */ jsxDEV2(Box2, {
         flexDirection: "column",
         marginY: 1,
         paddingLeft: 2,
-        children: block.lines.map((line, index) => /* @__PURE__ */ jsxDEV(Text, {
+        children: block.lines.map((line, index) => /* @__PURE__ */ jsxDEV2(Text2, {
           color: theme.tool,
           children: line
         }, index, false, undefined, this))
       }, undefined, false, undefined, this);
     case "heading":
-      return /* @__PURE__ */ jsxDEV(Box, {
+      return /* @__PURE__ */ jsxDEV2(Box2, {
         marginTop: block.level <= 2 ? 1 : 0,
-        children: /* @__PURE__ */ jsxDEV(Text, {
+        children: /* @__PURE__ */ jsxDEV2(Text2, {
           bold: true,
           underline: block.level === 1,
           color: theme.assistant,
@@ -20397,29 +20652,29 @@ function Block({ block }) {
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this);
     case "rule":
-      return /* @__PURE__ */ jsxDEV(Text, {
+      return /* @__PURE__ */ jsxDEV2(Text2, {
         color: theme.muted,
         children: "─".repeat(40)
       }, undefined, false, undefined, this);
     case "list":
-      return /* @__PURE__ */ jsxDEV(Box, {
+      return /* @__PURE__ */ jsxDEV2(Box2, {
         flexDirection: "column",
-        children: block.items.map((item, index) => /* @__PURE__ */ jsxDEV(Text, {
+        children: block.items.map((item, index) => /* @__PURE__ */ jsxDEV2(Text2, {
           children: [
             "  ",
             block.ordered ? `${index + 1}.` : "-",
             " ",
-            /* @__PURE__ */ jsxDEV(Inline, {
+            /* @__PURE__ */ jsxDEV2(Inline, {
               text: item
             }, undefined, false, undefined, this)
           ]
         }, index, true, undefined, this))
       }, undefined, false, undefined, this);
     case "quote":
-      return /* @__PURE__ */ jsxDEV(Box, {
+      return /* @__PURE__ */ jsxDEV2(Box2, {
         flexDirection: "column",
         paddingLeft: 1,
-        children: block.lines.map((line, index) => /* @__PURE__ */ jsxDEV(Text, {
+        children: block.lines.map((line, index) => /* @__PURE__ */ jsxDEV2(Text2, {
           color: theme.muted,
           italic: true,
           children: [
@@ -20429,8 +20684,8 @@ function Block({ block }) {
         }, index, true, undefined, this))
       }, undefined, false, undefined, this);
     default:
-      return /* @__PURE__ */ jsxDEV(Text, {
-        children: /* @__PURE__ */ jsxDEV(Inline, {
+      return /* @__PURE__ */ jsxDEV2(Text2, {
+        children: /* @__PURE__ */ jsxDEV2(Inline, {
           text: block.text
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this);
@@ -20442,41 +20697,41 @@ function inlineToText(text2) {
 function Inline({ text: text2 }) {
   const pattern = /(\*\*.+?\*\*|__.+?__|`.+?`|\*.+?\*|_.+?_)/g;
   const parts = text2.split(pattern);
-  return /* @__PURE__ */ jsxDEV(Fragment, {
+  return /* @__PURE__ */ jsxDEV2(Fragment, {
     children: parts.map((part, index) => {
       if (part === "")
         return null;
       if (part.startsWith("**") && part.endsWith("**")) {
-        return /* @__PURE__ */ jsxDEV(Text, {
+        return /* @__PURE__ */ jsxDEV2(Text2, {
           bold: true,
           children: part.slice(2, -2)
         }, index, false, undefined, this);
       }
       if (part.startsWith("__") && part.endsWith("__")) {
-        return /* @__PURE__ */ jsxDEV(Text, {
+        return /* @__PURE__ */ jsxDEV2(Text2, {
           bold: true,
           children: part.slice(2, -2)
         }, index, false, undefined, this);
       }
       if (part.startsWith("`") && part.endsWith("`")) {
-        return /* @__PURE__ */ jsxDEV(Text, {
+        return /* @__PURE__ */ jsxDEV2(Text2, {
           color: theme.tool,
           children: part.slice(1, -1)
         }, index, false, undefined, this);
       }
       if (part.startsWith("*") && part.endsWith("*")) {
-        return /* @__PURE__ */ jsxDEV(Text, {
+        return /* @__PURE__ */ jsxDEV2(Text2, {
           italic: true,
           children: part.slice(1, -1)
         }, index, false, undefined, this);
       }
       if (part.startsWith("_") && part.endsWith("_")) {
-        return /* @__PURE__ */ jsxDEV(Text, {
+        return /* @__PURE__ */ jsxDEV2(Text2, {
           italic: true,
           children: part.slice(1, -1)
         }, index, false, undefined, this);
       }
-      return /* @__PURE__ */ jsxDEV(Text, {
+      return /* @__PURE__ */ jsxDEV2(Text2, {
         children: part
       }, index, false, undefined, this);
     })
@@ -20484,24 +20739,24 @@ function Inline({ text: text2 }) {
 }
 
 // packages/tui/src/components/memory-capture.tsx
-import { Box as Box2, Text as Text2 } from "ink";
-import { jsxDEV as jsxDEV2 } from "react/jsx-dev-runtime";
+import { Box as Box3, Text as Text3 } from "ink";
+import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
 function MemoryCapture({ candidate }) {
-  return /* @__PURE__ */ jsxDEV2(Box2, {
+  return /* @__PURE__ */ jsxDEV3(Box3, {
     marginTop: 1,
     children: [
-      /* @__PURE__ */ jsxDEV2(Text2, {
+      /* @__PURE__ */ jsxDEV3(Text3, {
         color: theme.accent,
         children: "remember "
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV2(Text2, {
+      /* @__PURE__ */ jsxDEV3(Text3, {
         children: [
           "“",
           candidate.text,
           "”"
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV2(Text2, {
+      /* @__PURE__ */ jsxDEV3(Text3, {
         color: theme.muted,
         children: "? ctrl+r for this project · ctrl+g everywhere"
       }, undefined, false, undefined, this)
@@ -20510,12 +20765,12 @@ function MemoryCapture({ candidate }) {
 }
 
 // packages/tui/src/components/permission.tsx
-import { Box as Box4, Text as Text4, useInput } from "ink";
+import { Box as Box5, Text as Text5, useInput } from "ink";
 import { useState } from "react";
 
 // packages/tui/src/components/diff.tsx
-import { Box as Box3, Text as Text3 } from "ink";
-import { jsxDEV as jsxDEV3 } from "react/jsx-dev-runtime";
+import { Box as Box4, Text as Text4 } from "ink";
+import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
 var MAX_LINES = 60;
 function DiffView({ diff: diff2, maxLines = MAX_LINES }) {
   const lines = diff2.split(`
@@ -20523,15 +20778,15 @@ function DiffView({ diff: diff2, maxLines = MAX_LINES }) {
   const body = lines.filter((line) => !line.startsWith("---") && !line.startsWith("+++"));
   const shown = body.slice(0, maxLines);
   const hidden = body.length - shown.length;
-  return /* @__PURE__ */ jsxDEV3(Box3, {
+  return /* @__PURE__ */ jsxDEV4(Box4, {
     flexDirection: "column",
     children: [
-      shown.map((line, index) => /* @__PURE__ */ jsxDEV3(Text3, {
+      shown.map((line, index) => /* @__PURE__ */ jsxDEV4(Text4, {
         color: colorFor(line),
         wrap: "truncate-end",
         children: line === "" ? " " : line
       }, index, false, undefined, this)),
-      hidden > 0 && /* @__PURE__ */ jsxDEV3(Text3, {
+      hidden > 0 && /* @__PURE__ */ jsxDEV4(Text4, {
         color: theme.muted,
         children: [
           "  ",
@@ -20566,7 +20821,7 @@ function diffStat(diff2) {
 }
 
 // packages/tui/src/components/permission.tsx
-import { jsxDEV as jsxDEV4 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
 function PermissionPrompt({ request, reason, onChoice }) {
   const [selected, setSelected] = useState(0);
   const options = [
@@ -20594,32 +20849,32 @@ function PermissionPrompt({ request, reason, onChoice }) {
   });
   const isDiff = request.detail.includes(`
 @@`) || request.detail.startsWith("---");
-  return /* @__PURE__ */ jsxDEV4(Box4, {
+  return /* @__PURE__ */ jsxDEV5(Box5, {
     flexDirection: "column",
     borderStyle: "round",
     borderColor: theme.warning,
     paddingX: 1,
     children: [
-      /* @__PURE__ */ jsxDEV4(Text4, {
+      /* @__PURE__ */ jsxDEV5(Text5, {
         bold: true,
         color: theme.warning,
         children: request.title
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV4(Text4, {
+      /* @__PURE__ */ jsxDEV5(Text5, {
         color: theme.muted,
         children: reason
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV4(Box4, {
+      /* @__PURE__ */ jsxDEV5(Box5, {
         marginY: 1,
         flexDirection: "column",
-        children: isDiff ? /* @__PURE__ */ jsxDEV4(DiffView, {
+        children: isDiff ? /* @__PURE__ */ jsxDEV5(DiffView, {
           diff: request.detail
-        }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV4(Text4, {
+        }, undefined, false, undefined, this) : /* @__PURE__ */ jsxDEV5(Text5, {
           wrap: "wrap",
           children: request.detail
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this),
-      options.map((option, index) => /* @__PURE__ */ jsxDEV4(Text4, {
+      options.map((option, index) => /* @__PURE__ */ jsxDEV5(Text5, {
         color: index === selected ? theme.accent : option.color,
         children: [
           index === selected ? "❯ " : "  ",
@@ -20634,13 +20889,13 @@ function truncate2(value, max) {
 }
 
 // packages/tui/src/components/question.tsx
-import { Box as Box5, Text as Text6, useInput as useInput3 } from "ink";
+import { Box as Box6, Text as Text7, useInput as useInput3 } from "ink";
 import { useState as useState2 } from "react";
 
 // packages/tui/src/components/text-input.tsx
-import { Text as Text5, useInput as useInput2 } from "ink";
+import { Text as Text6, useInput as useInput2 } from "ink";
 import { useEffect, useRef } from "react";
-import { jsxDEV as jsxDEV5 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
 function TextInput({
   value,
   onChange,
@@ -20674,23 +20929,23 @@ function TextInput({
     }
   }, { isActive });
   if (value === "") {
-    return /* @__PURE__ */ jsxDEV5(Text5, {
+    return /* @__PURE__ */ jsxDEV6(Text6, {
       children: [
-        /* @__PURE__ */ jsxDEV5(Text5, {
+        /* @__PURE__ */ jsxDEV6(Text6, {
           inverse: true,
           children: " "
         }, undefined, false, undefined, this),
-        /* @__PURE__ */ jsxDEV5(Text5, {
+        /* @__PURE__ */ jsxDEV6(Text6, {
           color: theme.muted,
           children: placeholder
         }, undefined, false, undefined, this)
       ]
     }, undefined, true, undefined, this);
   }
-  return /* @__PURE__ */ jsxDEV5(Text5, {
+  return /* @__PURE__ */ jsxDEV6(Text6, {
     children: [
       value,
-      /* @__PURE__ */ jsxDEV5(Text5, {
+      /* @__PURE__ */ jsxDEV6(Text6, {
         inverse: true,
         children: " "
       }, undefined, false, undefined, this)
@@ -20699,7 +20954,7 @@ function TextInput({
 }
 
 // packages/tui/src/components/question.tsx
-import { jsxDEV as jsxDEV6 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
 function QuestionPrompt({ question, options = [], onAnswer }) {
   const [selected, setSelected] = useState2(0);
   const [typing, setTyping] = useState2(options.length === 0);
@@ -20716,29 +20971,29 @@ function QuestionPrompt({ question, options = [], onAnswer }) {
       setValue(input);
     }
   }, { isActive: !typing });
-  return /* @__PURE__ */ jsxDEV6(Box5, {
+  return /* @__PURE__ */ jsxDEV7(Box6, {
     flexDirection: "column",
     borderStyle: "round",
     borderColor: theme.accent,
     paddingX: 1,
     children: [
-      /* @__PURE__ */ jsxDEV6(Text6, {
+      /* @__PURE__ */ jsxDEV7(Text7, {
         bold: true,
         color: theme.accent,
         children: question
       }, undefined, false, undefined, this),
-      !typing && options.map((option, index) => /* @__PURE__ */ jsxDEV6(Text6, {
+      !typing && options.map((option, index) => /* @__PURE__ */ jsxDEV7(Text7, {
         color: index === selected ? theme.accent : theme.muted,
         children: [
           index === selected ? "❯ " : "  ",
           option
         ]
       }, option, true, undefined, this)),
-      !typing && /* @__PURE__ */ jsxDEV6(Text6, {
+      !typing && /* @__PURE__ */ jsxDEV7(Text7, {
         color: theme.muted,
         children: "or start typing to answer in your own words"
       }, undefined, false, undefined, this),
-      typing && /* @__PURE__ */ jsxDEV6(TextInput, {
+      typing && /* @__PURE__ */ jsxDEV7(TextInput, {
         value,
         onChange: setValue,
         onSubmit: (answer) => onAnswer(answer.trim()),
@@ -20749,8 +21004,8 @@ function QuestionPrompt({ question, options = [], onAnswer }) {
 }
 
 // packages/tui/src/components/status.tsx
-import { Box as Box6, Text as Text7 } from "ink";
-import { jsxDEV as jsxDEV7 } from "react/jsx-dev-runtime";
+import { Box as Box7, Text as Text8 } from "ink";
+import { jsxDEV as jsxDEV8 } from "react/jsx-dev-runtime";
 function StatusLine({
   model: model2,
   mode,
@@ -20764,27 +21019,27 @@ function StatusLine({
   const done = todos.filter((todo2) => todo2.status === "done").length;
   const current = todos.find((todo2) => todo2.status === "in_progress");
   const used = context2.window > 0 ? Math.min(100, context2.tokens / context2.window * 100) : 0;
-  return /* @__PURE__ */ jsxDEV7(Box6, {
+  return /* @__PURE__ */ jsxDEV8(Box7, {
     children: [
-      /* @__PURE__ */ jsxDEV7(Text7, {
+      /* @__PURE__ */ jsxDEV8(Text8, {
         color: MODE_COLOR[mode] ?? theme.muted,
         children: MODE_LABEL[mode] ?? mode
       }, undefined, false, undefined, this),
-      /* @__PURE__ */ jsxDEV7(Text7, {
+      /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.muted,
         children: [
           " · ",
           model2
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV7(Text7, {
+      /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.muted,
         children: [
           " · $",
           costUsd.toFixed(4)
         ]
       }, undefined, true, undefined, this),
-      context2.window > 0 && /* @__PURE__ */ jsxDEV7(Text7, {
+      context2.window > 0 && /* @__PURE__ */ jsxDEV8(Text8, {
         color: used >= 80 ? theme.warning : theme.muted,
         children: [
           " · ",
@@ -20792,7 +21047,7 @@ function StatusLine({
           "% ctx"
         ]
       }, undefined, true, undefined, this),
-      compacted > 0 && /* @__PURE__ */ jsxDEV7(Text7, {
+      compacted > 0 && /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.muted,
         children: [
           " · ",
@@ -20800,7 +21055,7 @@ function StatusLine({
           " summarised"
         ]
       }, undefined, true, undefined, this),
-      todos.length > 0 && /* @__PURE__ */ jsxDEV7(Text7, {
+      todos.length > 0 && /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.muted,
         children: [
           " ",
@@ -20811,11 +21066,11 @@ function StatusLine({
           current ? ` ${truncate3(current.text, 40)}` : ""
         ]
       }, undefined, true, undefined, this),
-      busy && /* @__PURE__ */ jsxDEV7(Text7, {
+      busy && /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.warning,
         children: " · working (esc to interrupt)"
       }, undefined, false, undefined, this),
-      queued > 0 && /* @__PURE__ */ jsxDEV7(Text7, {
+      queued > 0 && /* @__PURE__ */ jsxDEV8(Text8, {
         color: theme.accent,
         children: [
           " · ",
@@ -20831,8 +21086,8 @@ function truncate3(value, max) {
 }
 
 // packages/tui/src/components/tool-block.tsx
-import { Box as Box7, Text as Text8 } from "ink";
-import { jsxDEV as jsxDEV8 } from "react/jsx-dev-runtime";
+import { Box as Box8, Text as Text9 } from "ink";
+import { jsxDEV as jsxDEV9 } from "react/jsx-dev-runtime";
 var PREVIEW_LINES = 8;
 function ToolBlock({
   name,
@@ -20851,27 +21106,27 @@ function ToolBlock({
   const showAll = expanded || isError;
   const shown = showAll ? lines : lines.slice(0, PREVIEW_LINES);
   const hidden = lines.length - shown.length;
-  return /* @__PURE__ */ jsxDEV8(Box7, {
+  return /* @__PURE__ */ jsxDEV9(Box8, {
     flexDirection: "column",
     marginTop: 1,
     children: [
-      /* @__PURE__ */ jsxDEV8(Text8, {
+      /* @__PURE__ */ jsxDEV9(Text9, {
         color,
         children: [
           marker2,
           " ",
-          /* @__PURE__ */ jsxDEV8(Text8, {
+          /* @__PURE__ */ jsxDEV9(Text9, {
             bold: true,
             children: name
           }, undefined, false, undefined, this),
-          title ? /* @__PURE__ */ jsxDEV8(Text8, {
+          title ? /* @__PURE__ */ jsxDEV9(Text9, {
             color: theme.muted,
             children: [
               " ",
               title
             ]
           }, undefined, true, undefined, this) : null,
-          isDiff && !showAll ? /* @__PURE__ */ jsxDEV8(Text8, {
+          isDiff && !showAll ? /* @__PURE__ */ jsxDEV9(Text9, {
             color: theme.muted,
             children: [
               " ",
@@ -20880,12 +21135,12 @@ function ToolBlock({
           }, undefined, true, undefined, this) : null
         ]
       }, undefined, true, undefined, this),
-      isDiff && showAll ? /* @__PURE__ */ jsxDEV8(Box7, {
+      isDiff && showAll ? /* @__PURE__ */ jsxDEV9(Box8, {
         marginLeft: 2,
-        children: /* @__PURE__ */ jsxDEV8(DiffView, {
+        children: /* @__PURE__ */ jsxDEV9(DiffView, {
           diff: output
         }, undefined, false, undefined, this)
-      }, undefined, false, undefined, this) : shown.map((line, index) => /* @__PURE__ */ jsxDEV8(Text8, {
+      }, undefined, false, undefined, this) : shown.map((line, index) => /* @__PURE__ */ jsxDEV9(Text9, {
         color: theme.muted,
         wrap: "truncate-end",
         children: [
@@ -20893,7 +21148,7 @@ function ToolBlock({
           line
         ]
       }, index, true, undefined, this)),
-      hidden > 0 && !isDiff && /* @__PURE__ */ jsxDEV8(Text8, {
+      hidden > 0 && !isDiff && /* @__PURE__ */ jsxDEV9(Text9, {
         color: theme.muted,
         children: [
           "  ",
@@ -20907,7 +21162,7 @@ function ToolBlock({
 }
 
 // packages/tui/src/app.tsx
-import { jsxDEV as jsxDEV9 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV10 } from "react/jsx-dev-runtime";
 var sequence = 0;
 var nextId = () => `item_${sequence++}`;
 function promptLabel(prompt) {
@@ -20916,9 +21171,10 @@ function promptLabel(prompt) {
   return prompt.map((part) => part.type === "text" ? part.text : `[attached ${part.mediaType} image]`).join(`
 `);
 }
-function App({ session: session2, model: model2, initialPrompt }) {
+function App({ session: session2, model: initialModel, initialPrompt }) {
   const { exit } = useApp();
   const agent3 = session2.agent;
+  const [model2, setModel] = useState3(initialModel);
   const [items, setItems] = useState3(() => session2.problems.map((problem) => ({
     kind: "notice",
     id: nextId(),
@@ -20928,6 +21184,7 @@ function App({ session: session2, model: model2, initialPrompt }) {
   const [live, setLive] = useState3("");
   const [runningTool, setRunningTool] = useState3();
   const [input, setInput] = useState3("");
+  const [menuIndex, setMenuIndex] = useState3(0);
   const [busy, setBusy] = useState3(false);
   const [mode, setMode] = useState3(agent3.permissionMode);
   const [cost, setCost] = useState3(0);
@@ -21154,8 +21411,8 @@ function App({ session: session2, model: model2, initialPrompt }) {
     });
   }, [agent3, candidate, model2, push, session2.skills]);
   const sessionTree = useCallback(async (name, argument) => {
-    const entries = await session2.branch();
-    const prompts = entries.filter((entry) => entry.type === "message" && entry.message.role === "user" && entry.message.content.some((part) => part.type === "text" && !part.text.startsWith("<self-check>")));
+    const entries2 = await session2.branch();
+    const prompts = entries2.filter((entry) => entry.type === "message" && entry.message.role === "user" && entry.message.content.some((part) => part.type === "text" && !part.text.startsWith("<self-check>")));
     if (name === "tree" || !argument) {
       if (prompts.length === 0) {
         push({ kind: "notice", id: nextId(), text: "nothing in this session yet" });
@@ -21187,7 +21444,7 @@ function App({ session: session2, model: model2, initialPrompt }) {
       });
       return;
     }
-    const previous = entries[entries.indexOf(target) - 1] ?? target;
+    const previous = entries2[entries2.indexOf(target) - 1] ?? target;
     if (name === "rewind") {
       const kept = await session2.rewindTo(previous.id);
       push({
@@ -21304,16 +21561,149 @@ ${PLAN_PROMPT}`);
 /plan edit to change it, /plan approve to pin it`
     });
   }, [agent3, push, runTurn, session2.store]);
-  const handleCommand = useCallback((command) => {
-    const body = command.slice(1).trim();
-    const space = body.search(/\s/);
-    const name = space === -1 ? body : body.slice(0, space);
-    const argument = space === -1 ? undefined : body.slice(space + 1).trim();
-    if (name === "exit" || name === "quit") {
-      exit();
+  const switchModel = useCallback(async (ref) => {
+    if (!ref) {
+      const current = agent3.model;
+      const price = current.model.cost;
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: [
+          `  ${current.provider.id}/${current.model.id}`,
+          `  context  ${(current.model.contextWindow ?? 0).toLocaleString()} tokens`,
+          `  price    $${price?.input ?? "?"} in / $${price?.output ?? "?"} out per million`,
+          "",
+          "  /model <provider/model> switches; `earshot models` lists them"
+        ].join(`
+`)
+      });
       return;
     }
-    if (name === "mode") {
+    try {
+      const resolved = await agent3.changeModel(ref);
+      const next = `${resolved.provider.id}/${resolved.model.id}`;
+      setModel(next);
+      await refreshSystemPrompt(agent3, next, session2.skills);
+      push({ kind: "notice", id: nextId(), text: `model: ${next}` });
+    } catch (error) {
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: `${error.message}`,
+        color: theme.warning
+      });
+    }
+  }, [agent3, push, session2.skills]);
+  const compactNow = useCallback(async () => {
+    const abort = new AbortController;
+    controller.current = abort;
+    setBusy(true);
+    try {
+      let compactedAnything = false;
+      for await (const event of agent3.compactNow(abort.signal)) {
+        if (event.type === "compacted") {
+          compactedAnything = true;
+          setCompacted((count) => count + event.replaced);
+          push({
+            kind: "notice",
+            id: nextId(),
+            text: `compacted: ${event.replaced} earlier messages are now a summary`
+          });
+        }
+      }
+      if (!compactedAnything) {
+        push({ kind: "notice", id: nextId(), text: "nothing to compact yet" });
+      }
+    } catch (error) {
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: `could not compact: ${error.message}`,
+        color: theme.warning
+      });
+    } finally {
+      setBusy(false);
+      setContext(agent3.contextUse);
+      controller.current = undefined;
+    }
+  }, [agent3, push]);
+  const handlers = {
+    exit: () => exit(),
+    help: () => push({ kind: "notice", id: nextId(), text: describeCommands(session2) }),
+    model: (argument) => void switchModel(argument),
+    compact: () => void compactNow(),
+    context: () => {
+      const { tokens, window } = agent3.contextUse;
+      const percent = window > 0 ? Math.round(tokens / window * 100) : 0;
+      const files = agent3.touchedFiles;
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: [
+          `  model    ${model2}`,
+          `  context  ~${tokens.toLocaleString()} of ${window.toLocaleString()} tokens (${percent}%)`,
+          `  dropped  ${compacted} earlier message${compacted === 1 ? "" : "s"} replaced by a summary`,
+          `  files    ${files.length === 0 ? "none touched yet" : files.join(", ")}`,
+          "",
+          "  /compact summarises now rather than waiting for 80%"
+        ].join(`
+`)
+      });
+    },
+    cost: (argument) => {
+      if (argument !== undefined && argument !== "") {
+        const amount = Number.parseFloat(argument.replace(/^\$/, ""));
+        if (Number.isNaN(amount)) {
+          push({
+            kind: "notice",
+            id: nextId(),
+            text: `usage: /cost [usd] - "${argument}" is not an amount`,
+            color: theme.warning
+          });
+          return;
+        }
+        agent3.setBudget(amount > 0 ? amount : undefined);
+        push({
+          kind: "notice",
+          id: nextId(),
+          text: amount > 0 ? `budget: $${amount.toFixed(2)}` : "budget removed"
+        });
+        return;
+      }
+      const budget = agent3.budgetUsd;
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: `  spent    $${agent3.costUsd.toFixed(4)}
+` + `  budget   ${budget === undefined ? "none - /cost <usd> sets one" : `$${budget.toFixed(2)}`}`
+      });
+    },
+    todo: () => {
+      const todos2 = agent3.todos.list();
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: todos2.length === 0 ? "no todos in this session" : todos2.map((todo2) => `  ${todo2.status === "done" ? "x" : todo2.status === "in_progress" ? ">" : " "} ${todo2.text}`).join(`
+`)
+      });
+    },
+    permissions: () => {
+      const rules2 = agent3.permissionRules;
+      push({
+        kind: "notice",
+        id: nextId(),
+        text: [
+          `  mode   ${agent3.permissionMode}  (/mode changes it)`,
+          ...rules2.length === 0 ? ["  rules  none configured"] : [
+            "  rules  (deny always wins, whatever the mode or scope)",
+            ...rules2.map((rule) => `    ${rule.effect.padEnd(5)} ${rule.source}  [${rule.scope}]`)
+          ]
+        ].join(`
+`)
+      });
+    },
+    init: () => void runTurn(INIT_PROMPT),
+    mode: (argument) => {
       if (argument && isPermissionMode(argument)) {
         agent3.setPermissionMode(argument);
         setMode(argument);
@@ -21326,31 +21716,25 @@ ${PLAN_PROMPT}`);
           color: theme.warning
         });
       }
-      return;
-    }
-    if (name === "memory") {
-      showMemories(argument);
-      return;
-    }
-    if (name === "tree" || name === "rewind" || name === "fork") {
-      if (busy) {
-        push({
-          kind: "notice",
-          id: nextId(),
-          text: "finish or interrupt the current turn first (esc)",
-          color: theme.warning
-        });
-        return;
-      }
-      sessionTree(name, argument);
-      return;
-    }
-    if (name === "undo") {
-      undoLast();
-      return;
-    }
-    if (name === "plan") {
-      if (busy) {
+    },
+    memory: (argument) => void showMemories(argument),
+    tree: (argument) => void sessionTree("tree", argument),
+    rewind: (argument) => void sessionTree("rewind", argument),
+    fork: (argument) => void sessionTree("fork", argument),
+    undo: () => void undoLast(),
+    plan: (argument) => void plan2(argument),
+    skills: () => push({ kind: "notice", id: nextId(), text: describeExtensions(session2) })
+  };
+  const handlersRef = useRef2(handlers);
+  handlersRef.current = handlers;
+  const handleCommand = useCallback((command) => {
+    const body = command.slice(1).trim();
+    const space = body.search(/\s/);
+    const name = space === -1 ? body : body.slice(0, space);
+    const argument = space === -1 ? undefined : body.slice(space + 1).trim();
+    const spec = findCommand(name);
+    if (spec) {
+      if (spec.idleOnly && busy) {
         push({
           kind: "notice",
           id: nextId(),
@@ -21359,15 +21743,7 @@ ${PLAN_PROMPT}`);
         });
         return;
       }
-      plan2(argument);
-      return;
-    }
-    if (name === "skills") {
-      push({
-        kind: "notice",
-        id: nextId(),
-        text: describeExtensions(session2)
-      });
+      handlersRef.current[spec.name](argument);
       return;
     }
     const custom = session2.commands.find((entry) => entry.name === name);
@@ -21397,8 +21773,15 @@ ${PLAN_PROMPT}`);
       text: `unknown command "${name}"`,
       color: theme.warning
     });
-  }, [agent3, busy, exit, plan2, push, runTurn, session2, sessionTree, showMemories, undoLast]);
+  }, [agent3, busy, push, runTurn, session2]);
   const submit = useCallback((text2) => {
+    const entry = menuOpenRef.current ? menuEntriesRef.current[selectedRef.current] : undefined;
+    if (entry) {
+      setInput("");
+      setMenuIndex(0);
+      handleCommand(entry.insert);
+      return;
+    }
     const trimmed = text2.trim();
     setInput("");
     if (trimmed === "")
@@ -21417,7 +21800,38 @@ ${PLAN_PROMPT}`);
     runTurn(trimmed);
   }, [agent3, busy, push, runTurn, handleCommand]);
   const inputActive = !pending && !question;
+  const menuOpen = inputActive && input.startsWith("/") && !input.includes(" ");
+  const entries = menuOpen ? menuEntries(input.slice(1), session2.commands, busy) : [];
+  const selected = Math.min(menuIndex, Math.max(0, entries.length - 1));
+  const menuOpenRef = useRef2(menuOpen);
+  menuOpenRef.current = menuOpen;
+  const menuEntriesRef = useRef2(entries);
+  menuEntriesRef.current = entries;
+  const selectedRef = useRef2(selected);
+  selectedRef.current = selected;
   useInput4((input_, key2) => {
+    if (menuOpen && entries.length > 0) {
+      if (key2.upArrow) {
+        setMenuIndex((current) => current <= 0 ? entries.length - 1 : current - 1);
+        return;
+      }
+      if (key2.downArrow) {
+        setMenuIndex((current) => current >= entries.length - 1 ? 0 : current + 1);
+        return;
+      }
+      if (key2.tab) {
+        const entry = entries[selected];
+        if (entry)
+          setInput(`${entry.insert} `);
+        setMenuIndex(0);
+        return;
+      }
+      if (key2.escape) {
+        setInput("");
+        setMenuIndex(0);
+        return;
+      }
+    }
     if (key2.escape) {
       setCandidate(undefined);
       if (busy)
@@ -21428,26 +21842,26 @@ ${PLAN_PROMPT}`);
       remember(input_ === "r" ? "project" : "user");
     }
   }, { isActive: inputActive });
-  return /* @__PURE__ */ jsxDEV9(Box8, {
+  return /* @__PURE__ */ jsxDEV10(Box9, {
     flexDirection: "column",
     children: [
-      /* @__PURE__ */ jsxDEV9(Static, {
+      /* @__PURE__ */ jsxDEV10(Static, {
         items,
-        children: (item) => /* @__PURE__ */ jsxDEV9(ScrollRow, {
+        children: (item) => /* @__PURE__ */ jsxDEV10(ScrollRow, {
           item
         }, item.id, false, undefined, this)
       }, undefined, false, undefined, this),
-      live !== "" && /* @__PURE__ */ jsxDEV9(Box8, {
+      live !== "" && /* @__PURE__ */ jsxDEV10(Box9, {
         marginTop: 1,
-        children: /* @__PURE__ */ jsxDEV9(Markdown, {
+        children: /* @__PURE__ */ jsxDEV10(Markdown, {
           text: live
         }, undefined, false, undefined, this)
       }, undefined, false, undefined, this),
-      runningTool && /* @__PURE__ */ jsxDEV9(ToolBlock, {
+      runningTool && /* @__PURE__ */ jsxDEV10(ToolBlock, {
         name: runningTool,
         running: true
       }, undefined, false, undefined, this),
-      pending && /* @__PURE__ */ jsxDEV9(PermissionPrompt, {
+      pending && /* @__PURE__ */ jsxDEV10(PermissionPrompt, {
         request: pending.request,
         reason: pending.reason,
         onChoice: (choice) => {
@@ -21455,7 +21869,7 @@ ${PLAN_PROMPT}`);
           pending.resolve(choice);
         }
       }, undefined, false, undefined, this),
-      question && /* @__PURE__ */ jsxDEV9(QuestionPrompt, {
+      question && /* @__PURE__ */ jsxDEV10(QuestionPrompt, {
         question: question.question,
         ...question.options ? { options: question.options } : {},
         onAnswer: (answer) => {
@@ -21463,25 +21877,32 @@ ${PLAN_PROMPT}`);
           question.resolve(answer);
         }
       }, undefined, false, undefined, this),
-      candidate && inputActive && /* @__PURE__ */ jsxDEV9(MemoryCapture, {
+      candidate && inputActive && /* @__PURE__ */ jsxDEV10(MemoryCapture, {
         candidate
       }, undefined, false, undefined, this),
-      inputActive && /* @__PURE__ */ jsxDEV9(Box8, {
+      menuOpen && /* @__PURE__ */ jsxDEV10(CommandMenu, {
+        entries,
+        selected
+      }, undefined, false, undefined, this),
+      inputActive && /* @__PURE__ */ jsxDEV10(Box9, {
         marginTop: 1,
         children: [
-          /* @__PURE__ */ jsxDEV9(Text9, {
+          /* @__PURE__ */ jsxDEV10(Text10, {
             color: theme.user,
             children: "> "
           }, undefined, false, undefined, this),
-          /* @__PURE__ */ jsxDEV9(TextInput, {
+          /* @__PURE__ */ jsxDEV10(TextInput, {
             value: input,
-            onChange: setInput,
+            onChange: (value) => {
+              setInput(value);
+              setMenuIndex(0);
+            },
             onSubmit: submit,
             placeholder: busy ? "steer the agent, or esc to interrupt" : "what should I do?"
           }, undefined, false, undefined, this)
         ]
       }, undefined, true, undefined, this),
-      /* @__PURE__ */ jsxDEV9(StatusLine, {
+      /* @__PURE__ */ jsxDEV10(StatusLine, {
         model: model2,
         mode,
         costUsd: cost,
@@ -21496,45 +21917,60 @@ ${PLAN_PROMPT}`);
 }
 function ScrollRow({ item }) {
   if (item.kind === "user") {
-    return /* @__PURE__ */ jsxDEV9(Box8, {
+    return /* @__PURE__ */ jsxDEV10(Box9, {
       marginTop: 1,
       children: [
-        /* @__PURE__ */ jsxDEV9(Text9, {
+        /* @__PURE__ */ jsxDEV10(Text10, {
           color: theme.user,
           children: "> "
         }, undefined, false, undefined, this),
-        /* @__PURE__ */ jsxDEV9(Text9, {
+        /* @__PURE__ */ jsxDEV10(Text10, {
           children: item.text
         }, undefined, false, undefined, this)
       ]
     }, undefined, true, undefined, this);
   }
   if (item.kind === "assistant") {
-    return /* @__PURE__ */ jsxDEV9(Box8, {
+    return /* @__PURE__ */ jsxDEV10(Box9, {
       marginTop: 1,
-      children: /* @__PURE__ */ jsxDEV9(Markdown, {
+      children: /* @__PURE__ */ jsxDEV10(Markdown, {
         text: item.text
       }, undefined, false, undefined, this)
     }, undefined, false, undefined, this);
   }
   if (item.kind === "tool") {
-    return /* @__PURE__ */ jsxDEV9(ToolBlock, {
+    return /* @__PURE__ */ jsxDEV10(ToolBlock, {
       name: item.name,
       ...item.title ? { title: item.title } : {},
       ...item.output ? { output: item.output } : {},
       ...item.isError ? { isError: true } : {}
     }, undefined, false, undefined, this);
   }
-  return /* @__PURE__ */ jsxDEV9(Box8, {
+  return /* @__PURE__ */ jsxDEV10(Box9, {
     marginTop: 1,
-    children: /* @__PURE__ */ jsxDEV9(Text9, {
+    children: /* @__PURE__ */ jsxDEV10(Text10, {
       color: item.color ?? theme.muted,
       children: item.text
     }, undefined, false, undefined, this)
   }, undefined, false, undefined, this);
 }
-function describeExtensions(session2) {
-  const lines = [];
+function describeCommands(session2) {
+  const lines = commandRows().map((row) => `  ${row.command.padEnd(34)} ${row.summary}`);
+  if (session2.commands.length > 0) {
+    lines.push("", "  commands from this directory:");
+    for (const command of session2.commands) {
+      lines.push(`  ${`/${command.name}`.padEnd(34)} ${command.description}`);
+    }
+  }
+  lines.push("", "  type / at the prompt to filter this list and pick one");
+  return lines.join(`
+`);
+}
+var INIT_PROMPT = `Write an AGENTS.md at the root of this project for a coding agent that has never seen it.
+
+Read enough of the repository first to be accurate. Cover: what the project is, how it is laid out, the commands to build, test and lint it, and the conventions and rules that are not obvious from the code. Prefer rules that prevent a specific failure, and say what the failure is. If an AGENTS.md or CLAUDE.md already exists, improve it in place rather than replacing it.`;
+function describeExtensions(session2) {
+  const lines = [];
   if (session2.skills.length > 0) {
     lines.push("skills (the agent loads these itself when they fit):");
     for (const skill of session2.skills) {
@@ -21552,14 +21988,347 @@ function describeExtensions(session2) {
   return lines.length === 0 ? "no skills or commands found in .earshot/skills, .earshot/commands or your config directory" : lines.join(`
 `);
 }
+// packages/tui/src/onboarding.tsx
+import { Box as Box10, Text as Text11, useApp as useApp2, useInput as useInput5 } from "ink";
+import { useCallback as useCallback2, useRef as useRef3, useState as useState4 } from "react";
+import { jsxDEV as jsxDEV11 } from "react/jsx-dev-runtime";
+function Onboarding({ onDone, ...rest }) {
+  const { exit } = useApp2();
+  const options = useRef3(rest);
+  options.current = rest;
+  const [screen, setScreen] = useState4({ name: "choose" });
+  const [cursor, setCursor] = useState4(0);
+  const [input, setInput] = useState4("");
+  const [error, setError] = useState4();
+  const secret = useRef3("");
+  const providers = order(rest.providers, rest.wanted);
+  const finish = useCallback2((result) => {
+    onDone(result);
+    exit();
+  }, [exit, onDone]);
+  const verify2 = useCallback2(async (provider) => {
+    setScreen({ name: "probing", provider });
+    const result = await options.current.probe(provider.id);
+    if (result.ok) {
+      setScreen({ name: "ready", provider });
+      return;
+    }
+    if (result.reason === "rejected")
+      await options.current.forgetKey(provider.id).catch(() => {});
+    setScreen({ name: "failed", provider, result });
+  }, []);
+  const submitKey = useCallback2(async () => {
+    const provider = screen.name === "key" ? screen.provider : undefined;
+    const key2 = secret.current;
+    secret.current = "";
+    setInput("");
+    if (!provider)
+      return;
+    if (key2.trim() === "") {
+      setError("a key is needed, or press esc to go back");
+      return;
+    }
+    setError(undefined);
+    await options.current.storeKey(provider.id, key2.trim());
+    await verify2(provider);
+  }, [screen, verify2]);
+  const startSignIn = useCallback2(async (provider) => {
+    setScreen({ name: "oauth", provider });
+    try {
+      await options.current.signIn(provider.id, (url) => setScreen({ name: "oauth", provider, url }));
+    } catch (failure) {
+      setScreen({
+        name: "failed",
+        provider,
+        result: { ok: false, reason: "other", message: failure.message }
+      });
+      return;
+    }
+    await verify2(provider);
+  }, [verify2]);
+  const choose = useCallback2((provider) => {
+    setError(undefined);
+    if (provider.kind === "oauth")
+      startSignIn(provider);
+    else
+      setScreen({ name: "key", provider });
+  }, [startSignIn]);
+  useInput5((key2, meta) => {
+    if (meta.ctrl && key2 === "c") {
+      finish({ outcome: "quit" });
+      return;
+    }
+    if (screen.name === "choose") {
+      if (key2 === "q") {
+        finish({ outcome: "quit" });
+        return;
+      }
+      if (meta.upArrow)
+        setCursor((c) => c <= 0 ? providers.length - 1 : c - 1);
+      if (meta.downArrow)
+        setCursor((c) => c >= providers.length - 1 ? 0 : c + 1);
+      if (meta.return) {
+        const provider = providers[cursor];
+        if (provider)
+          choose(provider);
+      }
+      return;
+    }
+    if (screen.name === "key" && !meta.escape) {
+      if (meta.return) {
+        submitKey();
+        return;
+      }
+      if (meta.backspace || meta.delete) {
+        secret.current = secret.current.slice(0, -1);
+        setInput(secret.current);
+        return;
+      }
+      if (meta.ctrl || meta.meta || meta.tab)
+        return;
+      if (key2) {
+        secret.current += key2;
+        setInput(secret.current);
+      }
+      return;
+    }
+    if (meta.escape) {
+      secret.current = "";
+      setInput("");
+      setError(undefined);
+      setScreen({ name: "choose" });
+      return;
+    }
+    if (screen.name === "failed" && key2 === "k" && screen.result.reason === "unreachable") {
+      setScreen({ name: "ready", provider: screen.provider });
+    }
+  });
+  if (screen.name === "choose") {
+    return /* @__PURE__ */ jsxDEV11(Box10, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV11(Header, {}, undefined, false, undefined, this),
+        providers.map((provider, index) => /* @__PURE__ */ jsxDEV11(Box10, {
+          children: [
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              color: index === cursor ? theme.user : theme.muted,
+              children: index === cursor ? "› " : "  "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              ...index === cursor ? { color: theme.user } : {},
+              children: provider.id.padEnd(14)
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              color: theme.muted,
+              children: hint(provider)
+            }, undefined, false, undefined, this)
+          ]
+        }, provider.id, true, undefined, this)),
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.muted,
+            children: "↑↓ choose · enter select · q quit"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this),
+        error ? /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.warning,
+          children: error
+        }, undefined, false, undefined, this) : null
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (screen.name === "key") {
+    return /* @__PURE__ */ jsxDEV11(Box10, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV11(Header, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Text11, {
+          children: [
+            "paste an api key for ",
+            screen.provider.id
+          ]
+        }, undefined, true, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.muted,
+            children: [
+              screen.provider.envVars?.length ? `or set ${screen.provider.envVars.join(" or ")} instead and restart.
+` : "",
+              "stored in your config directory, readable only by you, and never printed."
+            ]
+          }, undefined, true, undefined, this)
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: [
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              color: theme.user,
+              children: "> "
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              children: "•".repeat(input.length)
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              inverse: true,
+              children: " "
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this),
+        error ? /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.warning,
+          children: error
+        }, undefined, false, undefined, this) : null,
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.muted,
+            children: "enter continue · esc back"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (screen.name === "oauth") {
+    return /* @__PURE__ */ jsxDEV11(Box10, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV11(Header, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Text11, {
+          children: [
+            "signing in to ",
+            screen.provider.id,
+            " in your browser…"
+          ]
+        }, undefined, true, undefined, this),
+        screen.url ? /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          flexDirection: "column",
+          children: [
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              color: theme.muted,
+              children: "if it did not open, use this link:"
+            }, undefined, false, undefined, this),
+            /* @__PURE__ */ jsxDEV11(Text11, {
+              children: screen.url
+            }, undefined, false, undefined, this)
+          ]
+        }, undefined, true, undefined, this) : null,
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.muted,
+            children: "esc cancel"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (screen.name === "probing") {
+    return /* @__PURE__ */ jsxDEV11(Box10, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV11(Header, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.muted,
+          children: [
+            "checking the credentials with ",
+            screen.provider.id,
+            "…"
+          ]
+        }, undefined, true, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  if (screen.name === "failed") {
+    return /* @__PURE__ */ jsxDEV11(Box10, {
+      flexDirection: "column",
+      children: [
+        /* @__PURE__ */ jsxDEV11(Header, {}, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.warning,
+          children: screen.result.reason === "rejected" ? `${screen.provider.id} rejected that credential. It has not been kept.` : screen.result.reason === "unreachable" ? `could not reach ${screen.provider.id}.` : `${screen.provider.id} said:`
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.muted,
+          children: screen.result.message
+        }, undefined, false, undefined, this),
+        /* @__PURE__ */ jsxDEV11(Box10, {
+          marginTop: 1,
+          children: /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.muted,
+            children: screen.result.reason === "unreachable" ? "k keep it anyway and carry on · esc start over · ctrl-c quit" : "esc start over · ctrl-c quit"
+          }, undefined, false, undefined, this)
+        }, undefined, false, undefined, this)
+      ]
+    }, undefined, true, undefined, this);
+  }
+  return /* @__PURE__ */ jsxDEV11(Box10, {
+    flexDirection: "column",
+    children: [
+      /* @__PURE__ */ jsxDEV11(Text11, {
+        color: theme.user,
+        children: [
+          "ready: ",
+          screen.provider.id
+        ]
+      }, undefined, true, undefined, this),
+      /* @__PURE__ */ jsxDEV11(Box10, {
+        marginTop: 1,
+        children: /* @__PURE__ */ jsxDEV11(Text11, {
+          color: theme.muted,
+          children: "what should I do? (enter to start with nothing)"
+        }, undefined, false, undefined, this)
+      }, undefined, false, undefined, this),
+      /* @__PURE__ */ jsxDEV11(Box10, {
+        children: [
+          /* @__PURE__ */ jsxDEV11(Text11, {
+            color: theme.user,
+            children: "> "
+          }, undefined, false, undefined, this),
+          /* @__PURE__ */ jsxDEV11(TextInput, {
+            value: input,
+            onChange: setInput,
+            onSubmit: (text2) => finish({ outcome: "ready", providerId: screen.provider.id, firstPrompt: text2.trim() })
+          }, undefined, false, undefined, this)
+        ]
+      }, undefined, true, undefined, this)
+    ]
+  }, undefined, true, undefined, this);
+}
+function Header() {
+  return /* @__PURE__ */ jsxDEV11(Box10, {
+    flexDirection: "column",
+    marginBottom: 1,
+    children: /* @__PURE__ */ jsxDEV11(Text11, {
+      children: "earshot needs a model provider before it can do anything."
+    }, undefined, false, undefined, this)
+  }, undefined, false, undefined, this);
+}
+function hint(provider) {
+  if (provider.configured)
+    return provider.configured;
+  if (provider.kind === "oauth")
+    return "sign in with a browser - no key to paste";
+  return provider.envVars?.length ? provider.envVars.join(" or ") : "api key";
+}
+function order(providers, wanted) {
+  if (!wanted)
+    return providers;
+  return [
+    ...providers.filter((provider) => provider.id === wanted),
+    ...providers.filter((provider) => provider.id !== wanted)
+  ];
+}
 // packages/tui/src/run.tsx
 import { platform as platform6 } from "node:os";
 import { render } from "ink";
-import { jsxDEV as jsxDEV10 } from "react/jsx-dev-runtime";
+import { jsxDEV as jsxDEV12 } from "react/jsx-dev-runtime";
 var WINDOWS_MAX_FPS = 30;
 async function runTui(options) {
   const isWindows = platform6() === "win32";
-  const instance = render(/* @__PURE__ */ jsxDEV10(App, {
+  const instance = render(/* @__PURE__ */ jsxDEV12(App, {
     session: options.session,
     model: options.model,
     ...options.initialPrompt ? { initialPrompt: options.initialPrompt } : {}
@@ -21575,6 +22344,105 @@ async function runTui(options) {
   }
   return 0;
 }
+async function runOnboarding(options) {
+  const isWindows = platform6() === "win32";
+  let result = { outcome: "quit" };
+  const instance = render(/* @__PURE__ */ jsxDEV12(Onboarding, {
+    ...options,
+    onDone: (decided) => {
+      result = decided;
+    }
+  }, undefined, false, undefined, this), {
+    exitOnCtrlC: false,
+    patchConsole: true,
+    ...isWindows ? { maxFps: WINDOWS_MAX_FPS } : {}
+  });
+  await instance.waitUntilExit();
+  return result;
+}
+// packages/cli/src/onboard.ts
+async function buildOnboardingOptions(wanted) {
+  const registry2 = buildRegistry();
+  const store3 = new AuthStore;
+  const providers = [];
+  for (const provider of registry2.list()) {
+    if (provider.auth.kind === "none")
+      continue;
+    providers.push(await describe3(provider, store3));
+  }
+  providers.sort((a, b) => Number(b.kind === "oauth") - Number(a.kind === "oauth"));
+  return {
+    providers,
+    ...wanted ? { wanted } : {},
+    storeKey: (providerId, key2) => store3.set(providerId, { type: "api-key", apiKey: key2 }),
+    forgetKey: (providerId) => store3.remove(providerId),
+    signIn: async (providerId, onUrl) => {
+      const credentials = await loginToOpenRouter({ onUrl });
+      await store3.set(providerId, credentials);
+    },
+    probe: (providerId) => probe(registry2, providerId)
+  };
+}
+async function describe3(provider, store3) {
+  const configured = await resolveCredentials(provider, { store: store3 }).catch(() => {
+    return;
+  });
+  return {
+    id: provider.id,
+    kind: provider.auth.kind === "oauth" ? "oauth" : "api-key",
+    ...envVarsOf2(provider.auth).length ? { envVars: envVarsOf2(provider.auth) } : {},
+    ...configured ? { configured: describeConfigured(configured.type) } : {}
+  };
+}
+function envVarsOf2(auth2) {
+  return auth2.kind === "api-key" || auth2.kind === "oauth" ? auth2.envVars ?? [] : [];
+}
+function describeConfigured(kind) {
+  return kind === "ambient" ? "ambient credentials" : kind === "oauth" ? "signed in" : "api key set";
+}
+async function probe(registry2, providerId) {
+  const listed = registry2.list().find((provider) => provider.id === providerId);
+  if (!listed)
+    return { ok: false, reason: "other", message: `unknown provider "${providerId}"` };
+  const model2 = listed.models()[0];
+  if (!model2) {
+    return {
+      ok: false,
+      reason: "other",
+      message: `${providerId} publishes no models to check against`
+    };
+  }
+  let resolved;
+  try {
+    resolved = await resolveModel(registry2, `${providerId}/${model2.id}`);
+  } catch (error) {
+    return { ok: false, reason: "other", message: error.message };
+  }
+  const controller = new AbortController;
+  const timeout = setTimeout(() => controller.abort(), 1e4);
+  try {
+    for await (const event of streamModel(registry2, resolved, {
+      system: "Reply with one word.",
+      messages: [{ role: "user", content: [{ type: "text", text: "hi" }] }],
+      maxOutputTokens: 1,
+      abortSignal: controller.signal
+    })) {
+      controller.abort();
+      if (event.type === "error") {
+        return event.error.kind === "auth" ? { ok: false, reason: "rejected", message: event.error.message } : event.error.kind === "network" ? { ok: false, reason: "unreachable", message: event.error.message } : { ok: false, reason: "other", message: event.error.message };
+      }
+      return { ok: true };
+    }
+    return { ok: true };
+  } catch (error) {
+    const message = error.message;
+    const timedOut = controller.signal.aborted && error.name === "AbortError";
+    return timedOut ? { ok: false, reason: "unreachable", message: "timed out waiting for a response" } : { ok: false, reason: "other", message };
+  } finally {
+    clearTimeout(timeout);
+  }
+}
+
 // packages/cli/src/commands/interactive.ts
 var DEFAULT_MODEL3 = "anthropic/claude-opus-5";
 async function interactiveCommand(args) {
@@ -21617,46 +22485,63 @@ async function interactiveCommand(args) {
     return 2;
   }
   const extensions = await startExtensions(process.cwd());
-  try {
-    const session2 = await createSession({
-      cwd: process.cwd(),
-      extraTools: extensions.tools,
-      problems: extensions.problems,
-      onDispose: () => extensions.close(),
-      model: typeof flags.model === "string" ? flags.model : DEFAULT_MODEL3,
-      ...mode ? { mode } : {},
-      ...typeof flags["api-key"] === "string" ? { apiKey: flags["api-key"] } : {},
-      ...curiosity ? { curiosity } : {},
-      ...maxCostUsd !== undefined ? { maxCostUsd } : {},
-      ...resumeFrom2(flags)
-    });
-    return await runTui({
-      session: session2,
-      model: typeof flags.model === "string" ? flags.model : DEFAULT_MODEL3,
-      ...initialPrompt !== "" || image ? {
-        initialPrompt: image ? [...initialPrompt ? [{ type: "text", text: initialPrompt }] : [], image] : initialPrompt
-      } : {}
-    });
-  } catch (error) {
-    await extensions.close();
-    if (error instanceof UnknownModelError) {
-      process.stderr.write(`${error.message}
+  const model2 = typeof flags.model === "string" ? flags.model : DEFAULT_MODEL3;
+  const onboardingAllowed = flags["no-onboarding"] !== true;
+  let firstPrompt = initialPrompt;
+  let attempted = false;
+  for (;; ) {
+    try {
+      const session2 = await createSession({
+        cwd: process.cwd(),
+        extraTools: extensions.tools,
+        problems: extensions.problems,
+        onDispose: () => extensions.close(),
+        model: model2,
+        ...mode ? { mode } : {},
+        ...typeof flags["api-key"] === "string" ? { apiKey: flags["api-key"] } : {},
+        ...curiosity ? { curiosity } : {},
+        ...maxCostUsd !== undefined ? { maxCostUsd } : {},
+        ...resumeFrom2(flags)
+      });
+      return await runTui({
+        session: session2,
+        model: model2,
+        ...firstPrompt !== "" || image ? {
+          initialPrompt: image ? [...firstPrompt ? [{ type: "text", text: firstPrompt }] : [], image] : firstPrompt
+        } : {}
+      });
+    } catch (error) {
+      if (error instanceof MissingCredentialsError && onboardingAllowed && !attempted) {
+        attempted = true;
+        const result = await runOnboarding(await buildOnboardingOptions(error.provider.id));
+        if (result.outcome === "quit") {
+          process.stdout.write("nothing was stored. run `earshot auth login <provider>` when you are ready.\n");
+          await extensions.close();
+          return 0;
+        }
+        firstPrompt = result.firstPrompt ?? firstPrompt;
+        continue;
+      }
+      await extensions.close();
+      if (error instanceof UnknownModelError) {
+        process.stderr.write(`${error.message}
 
 run \`earshot models\` to see what is available
 `);
-      return 2;
-    }
-    if (error instanceof MissingCredentialsError) {
-      process.stderr.write(`${error.message}
+        return 2;
+      }
+      if (error instanceof MissingCredentialsError) {
+        process.stderr.write(`${error.message}
 `);
-      return 3;
-    }
-    if (error instanceof NoSessionToResumeError) {
-      process.stderr.write(`${error.message}
+        return 3;
+      }
+      if (error instanceof NoSessionToResumeError) {
+        process.stderr.write(`${error.message}
 `);
-      return 2;
+        return 2;
+      }
+      throw error;
     }
-    throw error;
   }
 }
 function resumeFrom2(flags) {
@@ -21778,6 +22663,343 @@ ${models.length} models across ${new Set(models.map((m) => m.providerId)).size}
   return 0;
 }
 
+// packages/cli/src/commands/update.ts
+import { spawnSync as spawnSync2 } from "node:child_process";
+import { createHash as createHash4 } from "node:crypto";
+import { existsSync as existsSync2, realpathSync } from "node:fs";
+import { chmod, readdir as readdir8, rename as rename2, rm as rm2, writeFile as writeFile10 } from "node:fs/promises";
+import { basename as basename2, dirname as dirname9, join as join19, sep as sep5 } from "node:path";
+import { createInterface } from "node:readline/promises";
+import { fileURLToPath } from "node:url";
+var PACKAGE = "@raegent/earshot";
+var REPO = "rishabhguptajs/earshot";
+var REGISTRY = `https://registry.npmjs.org/${PACKAGE.replace("/", "%2f")}/latest`;
+var RELEASE = `https://api.github.com/repos/${REPO}/releases/latest`;
+var BUNFS_MARKERS = ["/$bunfs/", "\\$bunfs\\", "/~BUN/", "\\~BUN\\"];
+var ASSETS = {
+  "darwin-arm64": "earshot-darwin-arm64",
+  "darwin-x64": "earshot-darwin-x64",
+  "linux-x64": "earshot-linux-x64",
+  "linux-arm64": "earshot-linux-arm64",
+  "win32-x64": "earshot-windows-x64.exe"
+};
+function modulePath(moduleUrl) {
+  try {
+    return fileURLToPath(moduleUrl);
+  } catch {
+    return moduleUrl;
+  }
+}
+function managerOf(dir) {
+  const lower = dir.toLowerCase().replaceAll("\\", "/");
+  if (lower.includes("/.bun/install/global"))
+    return "bun";
+  if (lower.includes("/.volta/"))
+    return "volta";
+  if (lower.includes("/pnpm/global") || lower.includes("/.pnpm/"))
+    return "pnpm";
+  if (lower.includes("/.yarn/") || lower.includes("/yarn/global"))
+    return "yarn";
+  return "npm";
+}
+function detectInstall(options) {
+  const { execPath, moduleUrl, bunVersion, platform: platform7, arch } = options;
+  const realpath = options.realpath ?? ((path) => path);
+  const file = modulePath(moduleUrl);
+  if (BUNFS_MARKERS.some((marker3) => file.includes(marker3)) && bunVersion !== undefined) {
+    const asset = ASSETS[`${platform7}-${arch}`];
+    const target = realpath(execPath);
+    if (asset === undefined) {
+      return {
+        kind: "binary",
+        path: target,
+        reason: `no release asset is built for ${platform7}-${arch}`
+      };
+    }
+    return { kind: "binary", path: target, asset };
+  }
+  const marker2 = `${sep5}node_modules${sep5}${PACKAGE.split("/").join(sep5)}${sep5}`;
+  const index = `${file}${sep5}`.indexOf(marker2);
+  if (index !== -1) {
+    const packageDir = file.slice(0, index + marker2.length - 1);
+    const tree = packageDir.slice(0, packageDir.indexOf(`${sep5}node_modules${sep5}`));
+    const isProjectRoot = options.isProjectRoot ?? (() => false);
+    return {
+      kind: "npm",
+      path: packageDir,
+      manager: managerOf(packageDir),
+      local: isProjectRoot(tree)
+    };
+  }
+  if (file.includes(`${sep5}packages${sep5}cli${sep5}`) || file.endsWith(".ts")) {
+    return { kind: "source", path: file, reason: "running from a source checkout" };
+  }
+  return { kind: "unknown", path: file, reason: `cannot tell how ${execPath} was installed` };
+}
+function compareVersions(a, b) {
+  const split = (value) => {
+    const [core = "", pre] = value.replace(/^v/, "").split("-");
+    const parts = core.split(".").map((n) => Number.parseInt(n, 10) || 0);
+    return { parts, pre };
+  };
+  const left = split(a);
+  const right = split(b);
+  for (let i = 0;i < 3; i++) {
+    const diff2 = (left.parts[i] ?? 0) - (right.parts[i] ?? 0);
+    if (diff2 !== 0)
+      return diff2 < 0 ? -1 : 1;
+  }
+  if (left.pre === right.pre)
+    return 0;
+  if (left.pre === undefined)
+    return 1;
+  if (right.pre === undefined)
+    return -1;
+  return left.pre < right.pre ? -1 : 1;
+}
+async function resolveLatest(kind, fetchImpl) {
+  if (kind === "npm") {
+    const response2 = await fetchImpl(REGISTRY);
+    if (!response2.ok)
+      throw new Error(`npm registry returned ${response2.status}`);
+    const body2 = await response2.json();
+    if (!body2.version)
+      throw new Error("npm registry returned no version");
+    return body2.version;
+  }
+  const response = await fetchImpl(RELEASE);
+  if (!response.ok)
+    throw new Error(`GitHub releases returned ${response.status}`);
+  const body = await response.json();
+  if (!body.tag_name)
+    throw new Error("GitHub returned a release with no tag");
+  return body.tag_name.replace(/^v/, "");
+}
+function findChecksum(sums, asset) {
+  for (const line of sums.split(`
+`)) {
+    const [hash, ...rest] = line.trim().split(/\s+/);
+    const name = rest.join(" ").replace(/^\*/, "");
+    if (hash && name && basename2(name) === asset)
+      return hash.toLowerCase();
+  }
+  return;
+}
+var installCommand = {
+  npm: `npm install -g ${PACKAGE}@latest`,
+  bun: `bun add -g ${PACKAGE}@latest`,
+  pnpm: `pnpm add -g ${PACKAGE}@latest`,
+  yarn: `yarn global add ${PACKAGE}@latest`,
+  volta: `volta install ${PACKAGE}@latest`
+};
+async function runUpdate(options = {}) {
+  const out = options.out ?? ((text2) => process.stdout.write(text2));
+  const err = options.err ?? ((text2) => process.stderr.write(text2));
+  const current = options.current ?? VERSION;
+  const install = options.install ?? detectInstall({
+    execPath: process.execPath,
+    moduleUrl: import.meta.url,
+    bunVersion: process.versions.bun,
+    platform: process.platform,
+    arch: process.arch,
+    realpath: (path) => {
+      try {
+        return realpathSync(path);
+      } catch {
+        return path;
+      }
+    },
+    isProjectRoot: (dir) => existsSync2(join19(dir, "package.json"))
+  });
+  const fetchImpl = options.fetch ?? ((url) => fetch(url));
+  if (install.kind === "source" || install.kind === "unknown") {
+    err(`earshot update: ${install.reason}
+`);
+    err(install.kind === "source" ? `update the checkout with git instead
+` : `reinstall from ${`https://github.com/${REPO}/releases`}
+`);
+    return 2;
+  }
+  if (install.kind === "binary" && install.asset === undefined) {
+    err(`earshot update: ${install.reason}
+`);
+    return 2;
+  }
+  let latest;
+  try {
+    latest = await resolveLatest(install.kind, fetchImpl);
+  } catch (error) {
+    err(`earshot update: ${error.message}
+`);
+    return 1;
+  }
+  if (compareVersions(current, latest) >= 0) {
+    out(`earshot ${current} is the latest version
+`);
+    return 0;
+  }
+  const where = install.kind === "npm" ? `installed with ${install.manager}, ${install.local ? "in this project" : "globally"}` : "standalone binary";
+  out(`earshot ${current}  ->  ${latest}   (${where})
+`);
+  if (install.kind === "npm") {
+    const manager2 = install.manager ?? "npm";
+    const command = install.local ? `${manager2 === "npm" ? "npm install" : `${manager2} add`} ${PACKAGE}@latest` : installCommand[manager2];
+    out(`
+  ${command}
+
+`);
+    if (install.local || manager2 !== "npm") {
+      out(`run that to update
+`);
+      return options.check ? 4 : 0;
+    }
+    if (options.check)
+      return 4;
+    if (!await confirmed(options, "run it now?")) {
+      out(`run that to update
+`);
+      return 0;
+    }
+    const run4 = options.run ?? runCommand2;
+    const result = run4("npm", ["install", "-g", `${PACKAGE}@latest`]);
+    if (result.status !== 0) {
+      err(`earshot update: npm exited ${result.status}
+`);
+      return 1;
+    }
+    out(`updated to ${latest}
+`);
+    return 0;
+  }
+  return await updateBinary(install, latest, options, out, err);
+}
+function runCommand2(command, args) {
+  const result = spawnSync2(command, args, { stdio: "inherit", windowsHide: true, shell: false });
+  return { status: result.status };
+}
+async function confirmed(options, question) {
+  if (options.yes)
+    return true;
+  const confirm = options.confirm ?? defaultConfirm;
+  return await confirm(question);
+}
+async function defaultConfirm(question) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY)
+    return false;
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question(`${question} [y/N] `);
+    return /^y(es)?$/i.test(answer.trim());
+  } finally {
+    rl.close();
+  }
+}
+async function updateBinary(install, latest, options, out, err) {
+  const target = install.path;
+  const asset = install.asset;
+  const dir = dirname9(target);
+  const fetchImpl = options.fetch ?? ((url) => fetch(url));
+  await sweepStale(dir, target);
+  out(`  ${target}   ${asset}
+`);
+  if (options.check)
+    return 4;
+  try {
+    await writeFile10(join19(dir, `.earshot-update-probe-${process.pid}`), "");
+    await rm2(join19(dir, `.earshot-update-probe-${process.pid}`), { force: true });
+  } catch {
+    err(`earshot update: cannot write to ${dir}
+`);
+    err(`re-run with the permissions that own that directory
+`);
+    return 1;
+  }
+  if (!await confirmed(options, `download ${asset} and replace it?`)) {
+    out(`nothing was changed
+`);
+    return 0;
+  }
+  const base = `https://github.com/${REPO}/releases/download/v${latest}`;
+  const temp = join19(dir, `.earshot-update-${process.pid}.tmp`);
+  try {
+    out("  downloading… ");
+    const download = await fetchImpl(`${base}/${asset}`);
+    if (!download.ok)
+      throw new Error(`downloading ${asset} returned ${download.status}`);
+    const bytes = new Uint8Array(await download.arrayBuffer());
+    out("verifying SHA256… ");
+    const sumsResponse = await fetchImpl(`${base}/SHA256SUMS`);
+    if (!sumsResponse.ok)
+      throw new Error(`SHA256SUMS returned ${sumsResponse.status}`);
+    const expected = findChecksum(await sumsResponse.text(), asset);
+    if (expected === undefined)
+      throw new Error(`SHA256SUMS does not list ${asset}`);
+    const actual = createHash4("sha256").update(bytes).digest("hex");
+    if (actual !== expected) {
+      throw new Error(`checksum mismatch for ${asset}: expected ${expected}, got ${actual}`);
+    }
+    out("replacing… ");
+    await writeFile10(temp, bytes);
+    const platform7 = options.platform ?? process.platform;
+    if (platform7 !== "win32")
+      await chmod(temp, 493);
+    await replace(temp, target, platform7);
+    out(`
+updated to ${latest}
+`);
+    return 0;
+  } catch (error) {
+    await rm2(temp, { force: true });
+    out(`
+`);
+    err(`earshot update: ${error.message}
+`);
+    err(`nothing was replaced
+`);
+    return 1;
+  }
+}
+var realIo = {
+  rename: (from, to) => rename2(from, to),
+  remove: (path) => rm2(path, { force: true })
+};
+async function replace(temp, target, platform7, io = realIo) {
+  if (platform7 !== "win32") {
+    await io.rename(temp, target);
+    return;
+  }
+  const aside = `${target}.old-${process.pid}`;
+  await io.rename(target, aside);
+  try {
+    await io.rename(temp, target);
+  } catch (error) {
+    await io.rename(aside, target).catch(() => {});
+    throw error;
+  }
+  await io.remove(aside).catch(() => {});
+}
+async function sweepStale(dir, target) {
+  const prefix = `${basename2(target)}.old-`;
+  const entries = await readdir8(dir).catch(() => []);
+  for (const entry of entries) {
+    if (entry.startsWith(prefix))
+      await rm2(join19(dir, entry), { force: true }).catch(() => {});
+  }
+}
+async function updateCommand(args) {
+  if (args.positionals.length > 0) {
+    process.stderr.write(`earshot update: unexpected argument "${args.positionals[0]}"
+`);
+    process.stderr.write(`usage: earshot update [--check] [--yes]
+`);
+    return 2;
+  }
+  return runUpdate({
+    check: args.flags.check === true,
+    yes: args.flags.yes === true || args.flags.y === true
+  });
+}
+
 // packages/cli/src/index.ts
 var HELP = `earshot ${VERSION} - a terminal coding agent that actually listens
 
@@ -21790,6 +23012,7 @@ Usage
   earshot extensions <cmd>     list, trust or untrust in-process extensions
   earshot acp                  serve editor clients over ACP v1 on stdio
   earshot doctor               diagnose the local setup
+  earshot update [--check]     update earshot to the latest release
 
 Flags
   --model <provider/model>     model for this session
@@ -21829,6 +23052,8 @@ async function main(argv = process.argv.slice(2)) {
     return authCommand(args);
   if (command === "doctor")
     return doctorCommand(args);
+  if (command === "update")
+    return updateCommand(args);
   if (command === "acp")
     return acpCommand(args);
   if (command) {
@@ -21843,5 +23068,5 @@ async function main(argv = process.argv.slice(2)) {
 var code = await main();
 process.exitCode = code;
 
-//# debugId=A0D0F9FB395CDA7464756E2164756E21
+//# debugId=8F9F015F9221906F64756E2164756E21
 //# sourceMappingURL=main.js.map