fix(shortcuts): handle command palette in terminal

apps/emdash-desktop/src/renderer/app/workspace.tsx

@@ -3,6 +3,7 @@ import { CommandShortcutBinder } from '@renderer/lib/commands/command-shortcut-b
 import { AppKeyboardShortcuts } from '@renderer/lib/components/app-keyboard-shortcuts';
 import { BrowserAppShortcutEvents } from '@renderer/lib/components/browser-app-shortcut-events';
 import { MonacoKeyboardBridge } from '@renderer/lib/components/monaco-keyboard-bridge';
+import { TerminalKeyboardBridge } from '@renderer/lib/components/terminal-keyboard-bridge';
 import { useTheme } from '@renderer/lib/hooks/useTheme';
 import {
   useWorkspaceSlots,
@@ -22,6 +23,7 @@ export function Workspace() {
       <BrowserAppShortcutEvents />
       <CommandShortcutBinder />
       <MonacoKeyboardBridge />
+      <TerminalKeyboardBridge />
       <WorkspaceLayout
         leftSidebar={<LeftSidebar />}
         mainContent={

apps/emdash-desktop/src/renderer/lib/components/terminal-keyboard-bridge.tsx

@@ -0,0 +1,73 @@
+import { detectPlatform, normalizeHotkey } from '@tanstack/hotkeys';
+import { useLayoutEffect, useMemo } from 'react';
+import { useAppSettingsKey } from '@renderer/features/settings/use-app-settings-key';
+import {
+  APP_SHORTCUTS,
+  getEffectiveHotkey,
+  type ShortcutSettingsKey,
+} from '@renderer/lib/hooks/useKeyboardShortcuts';
+import { dispatchMatchingHotkeys } from '@renderer/lib/hotkeys/dispatch-matching-hotkeys';
+
+function isTerminalFocused(): boolean {
+  return document.activeElement?.closest('.xterm') !== null;
+}
+
+/**
+ * Fires the small allowlist of app shortcuts flagged `overrideTerminalFocus`
+ * (e.g. the command palette) when an xterm terminal has focus.
+ *
+ * xterm.js maps Ctrl+<key> combinations to terminal control codes on
+ * Windows/Linux and calls stopPropagation() on the keydown, so TanStack's
+ * document-level (bubbling phase) listeners never see them — which is why
+ * Ctrl+K does nothing from inside a terminal on Windows while Cmd+K works on
+ * macOS (xterm lets Cmd combos through). This bridge listens at capture phase,
+ * which runs before xterm's textarea handler, so it cannot be blocked by it.
+ *
+ * Only the flagged shortcuts are intercepted; every other key still reaches the
+ * terminal so essential control keys (Ctrl+C, Ctrl+D, Ctrl+L, …) keep working.
+ * When no terminal is focused the handler returns immediately and normal
+ * TanStack bubbling-phase handling takes over unchanged.
+ */
+export function TerminalKeyboardBridge() {
+  const { value: keyboard } = useAppSettingsKey('keyboard');
+  const overrideHotkeys = useMemo(() => {
+    const platform = detectPlatform();
+    const next = new Set<string>();
+    const shortcuts = Object.entries(APP_SHORTCUTS) as [
+      ShortcutSettingsKey,
+      (typeof APP_SHORTCUTS)[ShortcutSettingsKey],
+    ][];
+
+    for (const [key, def] of shortcuts) {
+      if (!def.overrideTerminalFocus) continue;
+      const hotkey = getEffectiveHotkey(key, keyboard);
+      if (hotkey !== null) next.add(normalizeHotkey(hotkey, platform));
+    }
+
+    return next;
+  }, [keyboard]);
+
+  useLayoutEffect(() => {
+    if (overrideHotkeys.size === 0) return;
+    const platform = detectPlatform();
+
+    const handler = (e: KeyboardEvent) => {
+      if (!isTerminalFocused()) return;
+
+      const handled = dispatchMatchingHotkeys(e, {
+        dispatch: 'first',
+        filter: (registration) =>
+          overrideHotkeys.has(normalizeHotkey(registration.hotkey, platform)),
+      });
+
+      // Prevent the event from reaching xterm and skip the TanStack bubbling
+      // listener, which would otherwise double-dispatch the same shortcut.
+      if (handled) e.stopImmediatePropagation();
+    };
+
+    document.addEventListener('keydown', handler, { capture: true });
+    return () => document.removeEventListener('keydown', handler, { capture: true });
+  }, [overrideHotkeys]);
+
+  return null;
+}

apps/emdash-desktop/src/renderer/tests/browser/terminal-keyboard-bridge.test.tsx

@@ -0,0 +1,142 @@
+import { detectPlatform, getHotkeyManager, type HotkeyRegistrationHandle } from '@tanstack/hotkeys';
+import { createElement } from 'react';
+import { createRoot, type Root } from 'react-dom/client';
+import { afterEach, beforeEach, describe, expect, it, vi } from 'vitest';
+
+// The bridge reads the command-palette hotkey from app settings; with no
+// overrides it falls back to the 'Mod+K' default.
+vi.mock('@renderer/features/settings/use-app-settings-key', () => ({
+  useAppSettingsKey: () => ({ value: undefined }),
+}));
+
+import { TerminalKeyboardBridge } from '@renderer/lib/components/terminal-keyboard-bridge';
+
+// 'Mod' resolves to Cmd on macOS and Ctrl on Windows/Linux. This test is the
+// non-mac case (xterm only swallows Ctrl combos), but stay portable so it also
+// passes on a macOS CI runner.
+const PRIMARY_MODIFIER: 'metaKey' | 'ctrlKey' = detectPlatform() === 'mac' ? 'metaKey' : 'ctrlKey';
+
+function pressKey(target: EventTarget, key: string): KeyboardEvent {
+  const event = new KeyboardEvent('keydown', {
+    key,
+    [PRIMARY_MODIFIER]: true,
+    bubbles: true,
+    cancelable: true,
+  });
+  target.dispatchEvent(event);
+  return event;
+}
+
+function flush(): Promise<void> {
+  return new Promise((resolve) =>
+    requestAnimationFrame(() => requestAnimationFrame(() => resolve()))
+  );
+}
+
+describe('TerminalKeyboardBridge', () => {
+  let root: Root;
+  let rootContainer: HTMLDivElement;
+  let xtermHost: HTMLDivElement;
+  let xtermInput: HTMLTextAreaElement;
+  let outsideInput: HTMLInputElement;
+  const handles: HotkeyRegistrationHandle[] = [];
+
+  function registerHotkey(hotkey: string, callback: () => void): void {
+    handles.push(
+      getHotkeyManager().register(hotkey, () => callback(), {
+        // Disable the manager's own preventDefault/stopPropagation so a
+        // document bubble-phase spy can observe whether the bridge stopped the
+        // event during the capture phase.
+        preventDefault: false,
+        stopPropagation: false,
+      })
+    );
+  }
+
+  beforeEach(async () => {
+    rootContainer = document.createElement('div');
+    document.body.appendChild(rootContainer);
+    root = createRoot(rootContainer);
+    root.render(createElement(TerminalKeyboardBridge));
+    await flush();
+
+    xtermHost = document.createElement('div');
+    xtermHost.className = 'xterm';
+    xtermInput = document.createElement('textarea');
+    xtermHost.appendChild(xtermInput);
+    document.body.appendChild(xtermHost);
+
+    outsideInput = document.createElement('input');
+    document.body.appendChild(outsideInput);
+  });
+
+  afterEach(() => {
+    for (const handle of handles.splice(0)) handle.unregister();
+    root.unmount();
+    rootContainer.remove();
+    xtermHost.remove();
+    outsideInput.remove();
+    vi.restoreAllMocks();
+  });
+
+  it('fires the command palette shortcut when a terminal is focused', async () => {
+    const paletteSpy = vi.fn();
+    const bubbleSpy = vi.fn();
+    const xtermSpy = vi.fn((event: KeyboardEvent) => event.stopPropagation());
+    registerHotkey('Mod+K', paletteSpy);
+    xtermInput.addEventListener('keydown', xtermSpy);
+    document.addEventListener('keydown', bubbleSpy);
+
+    xtermInput.focus();
+    expect(document.activeElement).toBe(xtermInput);
+    pressKey(xtermInput, 'k');
+
+    expect(paletteSpy).toHaveBeenCalledTimes(1);
+    // The bridge stops propagation so the manager's bubble listener doesn't
+    // double-dispatch and xterm never consumes the key.
+    expect(xtermSpy).not.toHaveBeenCalled();
+    expect(bubbleSpy).not.toHaveBeenCalled();
+
+    xtermInput.removeEventListener('keydown', xtermSpy);
+    document.removeEventListener('keydown', bubbleSpy);
+  });
+
+  it('stays out of the way when no terminal is focused', async () => {
+    const paletteSpy = vi.fn();
+    const bubbleSpy = vi.fn();
+    registerHotkey('Mod+K', paletteSpy);
+    document.addEventListener('keydown', bubbleSpy);
+
+    outsideInput.focus();
+    pressKey(outsideInput, 'k');
+
+    // The bridge is inert: the event propagates normally to document listeners.
+    expect(paletteSpy).toHaveBeenCalledTimes(1);
+    expect(bubbleSpy).toHaveBeenCalledTimes(1);
+
+    document.removeEventListener('keydown', bubbleSpy);
+  });
+
+  it('lets non-flagged shortcuts reach the terminal so control keys keep working', async () => {
+    const drawerSpy = vi.fn();
+    const bubbleSpy = vi.fn();
+    const xtermSpy = vi.fn((event: KeyboardEvent) => event.stopPropagation());
+    // Mod+J (terminal drawer) is NOT flagged overrideTerminalFocus, so the
+    // bridge must not intercept it — Ctrl+J stays available to the shell.
+    registerHotkey('Mod+J', drawerSpy);
+    xtermInput.addEventListener('keydown', xtermSpy);
+    document.addEventListener('keydown', bubbleSpy);
+
+    xtermInput.focus();
+    pressKey(xtermInput, 'j');
+
+    // Bridge does not stop the event, so xterm receives and consumes it before
+    // TanStack's document-level bubble listener can dispatch the shortcut.
+    expect(xtermSpy).toHaveBeenCalledTimes(1);
+    expect(drawerSpy).not.toHaveBeenCalled();
+    expect(bubbleSpy).not.toHaveBeenCalled();
+
+    xtermInput.removeEventListener('keydown', xtermSpy);
+    document.removeEventListener('keydown', bubbleSpy);
+  });
+});

apps/emdash-desktop/src/shared/shortcuts.ts

@@ -14,6 +14,15 @@ export interface AppShortcutDef {
   hideFromSettings?: boolean;
   conflictBehavior?: 'prevent' | 'allow';
   ignoreWhenMonacoFocused?: boolean;
+  /**
+   * Fire this shortcut even while an xterm terminal is focused. On Windows/Linux
+   * xterm consumes Ctrl+<key> combos (mapping them to terminal control codes) and
+   * stops their propagation, so document-level hotkeys never see them. Flag the
+   * few app shortcuts that should win over the terminal here; everything else
+   * keeps reaching the terminal so essential control keys (Ctrl+C/D/L/…) work.
+   * See `TerminalKeyboardBridge`.
+   */
+  overrideTerminalFocus?: boolean;
 }
 
 export type TabNavigationDirection = 'next' | 'previous';
@@ -101,6 +110,7 @@ export const APP_SHORTCUTS = defineShortcuts({
     label: 'Command Palette',
     description: 'Open the command palette to quickly search and navigate',
     category: 'Navigation',
+    overrideTerminalFocus: true,
   },
   settings: {
     defaultHotkey: 'Mod+,',