fix(cli): restore mouse wheel scrolling for TUI

src/cli/commands/chat.tsx

@@ -314,11 +314,14 @@ export async function chatCommand(opts: ChatOptions): Promise<void> {
   const mcpSpecs = [...requestedSpecs];
   const mcpServers: McpServerSummary[] = [];
   const cfg = readConfig();
-  const historyScrollMode = resolveHistoryScrollMode({
-    configured: loadHistoryScrollMode(),
-    env: process.env,
-    platform: process.platform,
-  });
+  const historyScrollMode =
+    opts.noMouse || cfg.mouseTracking === false
+      ? "native"
+      : resolveHistoryScrollMode({
+          configured: loadHistoryScrollMode(),
+          env: process.env,
+          platform: process.platform,
+        });
   const startupInfoHints: string[] = [];
   const hasAnyMcp = normalizeMcpConfig(cfg).length > 0 || mcpSpecs.length > 0;
   if (cfg.setupCompleted === true && !hasAnyMcp) {
@@ -424,10 +427,10 @@ export async function chatCommand(opts: ChatOptions): Promise<void> {
   // path so N cards don't accumulate N native stdout listeners.
   installResizeBroadcaster();
 
-  // Wheel scrolling. Opt-out via `mouseTracking: false` for users who
-  // prefer native drag-select copy (Shift+drag still selects with mouse
-  // mode on in most terminals). exit hooks cover hard kills so the
-  // sequence doesn't leak into the parent shell.
+  // Wheel scrolling. Opt-out via `--no-mouse` / `mouseTracking: false` also
+  // forces native history mode so the terminal, not CardStream, owns wheel
+  // movement. Exit hooks cover hard kills so the sequence doesn't leak into
+  // the parent shell.
   if (!opts.noMouse && cfg.mouseTracking !== false) {
     enableMouseMode(historyScrollMode);
     process.once("exit", disableMouseMode);

src/cli/ui/history-scroll-mode.ts

@@ -15,11 +15,21 @@ export function resolveHistoryScrollMode({
 }: ResolveHistoryScrollModeInput = {}): ResolvedHistoryScrollMode {
   if (configured === "native") return "native";
   if (configured === "app") return "app";
+  // Apple Terminal has native renderer crashes when it receives
+  // private mouse-mode toggles — keep it on native so the terminal
+  // handles scrollback without any escape sequences.
+  if ((env.TERM_PROGRAM ?? "").toLowerCase() === "apple_terminal") return "native";
   if (isKnownJumpProneTerminal(env)) return "app";
+  // Classic Windows console (conhost) doesn't advertise TERM_PROGRAM
+  // and its alt-screen buffer doesn't forward wheel events — native
+  // scrollback is the safer default there.
   if (platform === "win32" && env.TERM_PROGRAM === undefined && env.MSYSTEM === undefined) {
     return "native";
   }
-  return "native";
+  // Default to app-managed scroll for all other terminals so the mouse
+  // wheel feeds into CardStream's scroll logic. Native scrollback
+  // cannot scroll TUI alt-screen content on most terminals.
+  return "app";
 }
 
 function isKnownJumpProneTerminal(env: NodeJS.ProcessEnv | Record<string, string | undefined>) {

src/cli/ui/stdin-reader.ts

@@ -131,8 +131,17 @@ function decodeSgrMouseBody(body: string): KeyEvent | null {
   if (!Number.isFinite(btn) || !Number.isFinite(col) || !Number.isFinite(row)) return null;
   const tail = m[4]!;
   if (tail === "m") return { input: "", mouseRelease: true, mouseRow: row, mouseCol: col };
-  if (btn === 64) return { input: "", mouseScrollUp: true, mouseRow: row, mouseCol: col };
-  if (btn === 65) return { input: "", mouseScrollDown: true, mouseRow: row, mouseCol: col };
+  // SGR encodes wheel events with bit 6 set (btn & 64).
+  // Modifier keys add bits 4/8/16 (e.g. 68 = wheel-up+Ctrl, 80 = wheel-up+Shift).
+  // Masking with bit 6 is stricter than `btn >= 64` — it rejects theoretical
+  // non-wheel codes that happen to fall >= 64. The wheel direction is in bit 0:
+  // 0 = up, 1 = down. Issue #2260: some terminals (especially Windows Terminal
+  // previews) send modified codes 68/69/80 etc. that the old exact-match missed.
+  if (btn & 64) {
+    const wheelDir = btn & 1;
+    if (wheelDir === 0) return { input: "", mouseScrollUp: true, mouseRow: row, mouseCol: col };
+    return { input: "", mouseScrollDown: true, mouseRow: row, mouseCol: col };
+  }
   if (btn === 0) return { input: "", mouseClick: true, mouseRow: row, mouseCol: col };
   if (btn === 32) return { input: "", mouseDrag: true, mouseRow: row, mouseCol: col };
   return null;

tests/chat-scroll-wheel.test.ts

@@ -94,13 +94,33 @@ describe("history scroll mode resolution", () => {
     );
   });
 
-  it("keeps native scrollback for unknown terminals in auto mode", () => {
+  it("defaults to app-managed scroll for unknown terminals in auto mode", () => {
     expect(
       resolveHistoryScrollMode({
         configured: "auto",
         env: { TERM: "xterm-256color" },
         platform: "linux",
       }),
+    ).toBe("app");
+  });
+
+  it("keeps native scrollback for Apple Terminal to avoid renderer crashes", () => {
+    expect(
+      resolveHistoryScrollMode({
+        configured: "auto",
+        env: { TERM_PROGRAM: "Apple_Terminal" },
+        platform: "darwin",
+      }),
+    ).toBe("native");
+  });
+
+  it("keeps native scrollback for classic Windows console (no TERM_PROGRAM)", () => {
+    expect(
+      resolveHistoryScrollMode({
+        configured: "auto",
+        env: {},
+        platform: "win32",
+      }),
     ).toBe("native");
   });
 });