feat(console/ai): keyboard shortcuts — ⌘⇧O new chat, ⌘⇧S toggle list (#1707)

Parity with ChatGPT/Claude: ⌘/Ctrl+Shift+O starts a new conversation, and
⌘/Ctrl+Shift+S toggles the conversations list. Both use the ⌘/Ctrl+Shift
modifier so they're safe to fire while the composer is focused (ordinary typing
can't produce them). Registered via a keydown listener on the AI chat page and
surfaced in the keyboard-shortcuts cheatsheet (the "?" dialog) under a new "AI
assistant" group.

The match logic is a pure exported `matchAiChatShortcut` and unit-tested.

Test: 487 pass (5 new — ⌘/Ctrl variants, requires Shift, rejects Alt/missing
modifier, ignores unrelated keys). tsc clean; no new lint errors.

Co-authored-by: Jack Zhuang <277994282+os-zhuang@users.noreply.github.com>
Co-authored-by: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: 3 people

packages/app-shell/src/chrome/KeyboardShortcutsDialog.tsx

@@ -53,6 +53,13 @@ export function KeyboardShortcutsDialog() {
         { keys: ['⌘', 'E'], description: t('console.shortcuts.editRecord') },
       ],
     },
+    {
+      title: t('console.shortcuts.groups.aiChat', { defaultValue: 'AI assistant' }),
+      shortcuts: [
+        { keys: ['⌘', '⇧', 'O'], description: t('console.shortcuts.newChat', { defaultValue: 'New chat' }) },
+        { keys: ['⌘', '⇧', 'S'], description: t('console.shortcuts.toggleChatsList', { defaultValue: 'Toggle conversations list' }) },
+      ],
+    },
     {
       title: t('console.shortcuts.groups.preferences'),
       shortcuts: [

packages/app-shell/src/console/ai/AiChatPage.tsx

@@ -363,6 +363,35 @@ export function useResizableChatPane(active: boolean): ResizableChatPane {
   return { width, dragging, containerRef, onHandlePointerDown, onHandleKeyDown, reset };
 }
 
+export type AiChatShortcut = 'toggle-list' | 'new-chat';
+
+/**
+ * Match a keydown to an AI-chat shortcut, mirroring ChatGPT/Claude:
+ *  - ⌘/Ctrl+Shift+O → new chat
+ *  - ⌘/Ctrl+Shift+S → toggle the conversations list
+ *
+ * Both use the ⌘/Ctrl+Shift modifier so they're safe to fire even while the
+ * composer is focused (they can't be produced by ordinary typing). Pure +
+ * exported for tests.
+ */
+export function matchAiChatShortcut(e: {
+  key: string;
+  metaKey: boolean;
+  ctrlKey: boolean;
+  shiftKey: boolean;
+  altKey: boolean;
+}): AiChatShortcut | null {
+  if (!(e.metaKey || e.ctrlKey) || !e.shiftKey || e.altKey) return null;
+  switch (e.key.toLowerCase()) {
+    case 'o':
+      return 'new-chat';
+    case 's':
+      return 'toggle-list';
+    default:
+      return null;
+  }
+}
+
 export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentProp }: AiChatPageProps = {}) {
   const { user } = useAuth();
   const { t } = useObjectTranslation();
@@ -430,6 +459,18 @@ export function AiChatPage({ apiBase: apiBaseProp, defaultAgent: defaultAgentPro
     toggle: toggleChatsCollapsed,
     handleCanvasOpenChange,
   } = useCollapsibleChatsList();
+  // Keyboard shortcuts (ChatGPT/Claude parity): ⌘⇧O new chat, ⌘⇧S toggle list.
+  useEffect(() => {
+    const onKeyDown = (e: KeyboardEvent) => {
+      const action = matchAiChatShortcut(e);
+      if (!action) return;
+      e.preventDefault();
+      if (action === 'toggle-list') toggleChatsCollapsed();
+      else navigate('/ai?new=1');
+    };
+    document.addEventListener('keydown', onKeyDown);
+    return () => document.removeEventListener('keydown', onKeyDown);
+  }, [toggleChatsCollapsed, navigate]);
   const restApiBase = useMemo(
     () => apiBase.replace(/\/v1\/ai$/, '').replace(/\/ai$/, '') || '/api',
     [apiBase],

packages/app-shell/src/console/ai/__tests__/matchAiChatShortcut.test.ts

@@ -0,0 +1,36 @@
+import { describe, expect, it } from 'vitest';
+import { matchAiChatShortcut } from '../AiChatPage';
+
+const ev = (over: Partial<{ key: string; metaKey: boolean; ctrlKey: boolean; shiftKey: boolean; altKey: boolean }>) => ({
+  key: 'o',
+  metaKey: false,
+  ctrlKey: false,
+  shiftKey: false,
+  altKey: false,
+  ...over,
+});
+
+describe('matchAiChatShortcut', () => {
+  it('maps ⌘⇧O and Ctrl⇧O to new-chat', () => {
+    expect(matchAiChatShortcut(ev({ key: 'O', metaKey: true, shiftKey: true }))).toBe('new-chat');
+    expect(matchAiChatShortcut(ev({ key: 'o', ctrlKey: true, shiftKey: true }))).toBe('new-chat');
+  });
+
+  it('maps ⌘⇧S to toggle-list', () => {
+    expect(matchAiChatShortcut(ev({ key: 'S', metaKey: true, shiftKey: true }))).toBe('toggle-list');
+  });
+
+  it('requires the shift modifier', () => {
+    expect(matchAiChatShortcut(ev({ key: 'o', metaKey: true }))).toBeNull();
+    expect(matchAiChatShortcut(ev({ key: 's', ctrlKey: true }))).toBeNull();
+  });
+
+  it('requires a ⌘/Ctrl modifier and rejects Alt', () => {
+    expect(matchAiChatShortcut(ev({ key: 'o', shiftKey: true }))).toBeNull();
+    expect(matchAiChatShortcut(ev({ key: 'o', metaKey: true, shiftKey: true, altKey: true }))).toBeNull();
+  });
+
+  it('ignores unrelated keys', () => {
+    expect(matchAiChatShortcut(ev({ key: 'k', metaKey: true, shiftKey: true }))).toBeNull();
+  });
+});