feat(web): a bindable command focuses the sidebar's thread search

apps/web/src/components/Sidebar.tsx

@@ -79,6 +79,7 @@ import {
   type MouseEvent as ReactMouseEvent,
   type ReactNode,
 } from "react";
+import { flushSync } from "react-dom";
 import { type AnyRouter, useRouter } from "@tanstack/react-router";
 
 import {
@@ -100,6 +101,7 @@ import { useShortcutModifierState } from "../shortcutModifierState";
 import { isTerminalFocused } from "../lib/terminalFocus";
 import { isModelPickerOpen } from "../modelPickerVisibility";
 import { selectThreadTerminalUiState, useTerminalUiStateStore } from "../terminalUiStateStore";
+import { selectActiveRightPanel, useRightPanelStore } from "../rightPanelStore";
 import { isMacPlatform } from "~/lib/utils";
 import { readLocalApi } from "../localApi";
 import { useSidebarPendingFileDropStore } from "../sidebarPendingFileDropStore";
@@ -125,6 +127,7 @@ import { useSidebarProjectGroups } from "../hooks/useSidebarProjectGroups";
 import { useTerminalFocus } from "../hooks/useTerminalFocus";
 import { isCommandPaletteOpen, openCommandPalette } from "../commandPaletteBus";
 import { registerSettleAndAdvance } from "../settleAndAdvance";
+import { registerCommands } from "../shortcuts/dispatcher";
 import { startNewThreadFromContext } from "../lib/chatThreadActions";
 import { useBoringSidebarEnabled, useClientSettings } from "../hooks/useSettings";
 import { useCopyToClipboard } from "../hooks/useCopyToClipboard";
@@ -241,6 +244,7 @@ import {
 } from "./ui/combobox";
 import { SidebarContent, SidebarGroup, useSidebar } from "./ui/sidebar";
 import { SidebarChromeFooter, SidebarChromeHeader } from "./sidebar/SidebarChrome";
+import { isAppModalPage } from "./sidebar/mainAppLocation";
 import { SidebarHeaderIconButton, SidebarThreadHeader } from "./sidebar/SidebarThreadHeader";
 import { TooltipProvider } from "./ui/tooltip";
 import { composerDraftHasUserContent, DraftId, useComposerDraftStore } from "../composerDraftStore";
@@ -886,7 +890,7 @@ export default function Sidebar({ routeReveal }: { routeReveal: SidebarRouteReve
   } = useSidebarLookups();
   const delegatedUnderParent = useDelegatedUnderParent();
   const router = useRouter();
-  const { isMobile, setOpenMobile } = useSidebar();
+  const { isMobile, open: sidebarOpen, setOpen: setSidebarOpen, setOpenMobile } = useSidebar();
   const keybindings = useAtomValue(primaryServerKeybindingsAtom);
   const confirmThreadDelete = useClientSettings((s) => s.confirmThreadDelete);
   const confirmThreadArchive = useClientSettings((s) => s.confirmThreadArchive);
@@ -2885,6 +2889,33 @@ export default function Sidebar({ routeReveal }: { routeReveal: SidebarRouteReve
     openCommandPalette({ open: "new-thread-in" });
   };
 
+  const onFocusSearchShortcut = useStableCallback((event: KeyboardEvent) => {
+    if (isAppModalPage(router.state.location.pathname)) return false;
+    if (isCommandPaletteOpen() || isModelPickerOpen()) return false;
+    event.preventDefault();
+    event.stopPropagation();
+    if (event.repeat) return;
+    // The collapsed sidebar is inert until the expanded state commits, and an inert input cannot take focus.
+    if (!isMobile && !sidebarOpen) flushSync(() => setSidebarOpen(true));
+    threadSearchInputRef.current?.focus();
+    threadSearchInputRef.current?.select();
+  });
+  const readRoutePanelsOpen = useStableCallback(() => ({
+    terminalOpen: routeTerminalOpen,
+    previewOpen:
+      selectActiveRightPanel(useRightPanelStore.getState().byThreadKey, routeThreadRef) ===
+      "preview",
+  }));
+  // oxlint-disable-next-line t3code/no-unreasoned-state-sync -- registers the capture-phase thread search shortcut while the sidebar is mounted
+  useEffect(
+    () =>
+      registerCommands(
+        { "sidebar.focusSearch": onFocusSearchShortcut },
+        { capture: true, context: readRoutePanelsOpen },
+      ),
+    [onFocusSearchShortcut, readRoutePanelsOpen],
+  );
+
   const newThreadShortcutLabel =
     shortcutLabelForCommand(keybindings, "chat.new") ??
     (projectGroups.length <= 1 ? shortcutLabelForCommand(keybindings, "chat.newLocal") : undefined);

apps/web/src/components/files/BrowserDocumentFrame.tsx

@@ -55,6 +55,7 @@ const HTML_RENDER_SHORTCUT_COMMANDS: ReadonlySet<KeybindingCommand> = new Set([
   "projectSearch.toggle",
   "chat.find",
   "sidebar.toggle",
+  "sidebar.focusSearch",
   "rightPanel.toggle",
   "rightPanel.toggleMaximized",
   "threadPanel.toggle",

docs/user/keybindings.md

@@ -164,6 +164,10 @@ through the pages you have visited, like a browser's back and forward buttons.
 [new-thread defaults](./thread-sidebar.md#start-a-thread). `chat.newWithoutProject`
 (`mod+alt+n`) starts a thread [without a project](./thread-sidebar.md#start-without-a-project).
 
+`sidebar.focusSearch` moves focus to the sidebar's Search field and selects the
+query, so typing replaces it. A collapsed sidebar opens first. It has no default
+shortcut; assign one in **Settings → Keybindings**.
+
 ## Reserved shortcuts
 
 In the desktop app, `mod+w` closes the focused terminal or the active right-panel

packages/contracts/src/keybindings.ts

@@ -58,6 +58,7 @@ export const STATIC_KEYBINDING_COMMANDS = [
   "workspace.focusNext",
   "workspace.focusPrevious",
   "sidebar.toggle",
+  "sidebar.focusSearch",
   "navigation.back",
   "navigation.forward",
   "terminal.toggle",