feat(settings): add item search (#1592)

Adds item-level search inside Settings so users can find concrete settings like provider auth, agent mode, terminal font size, tunnel options, notification events, and similar controls instead of only filtering top-level pages. Groups search results by Settings page and shows localized labels plus optional descriptions where useful. Supports keyboard navigation with Arrow Up/Down, Enter, and Escape, matching the existing autocomplete interaction style. Opens the correct Settings page or split-page draft state before scrolling to the matching control. Highlights the matched setting with a subtle token-based background so users can see where they landed without an aggressive outline. Adds explicit data-settings-item anchors across Settings pages and a centralized search registry with runtime/mobile availability guards. Updates Settings UI skill guidance so future Settings changes keep search registry entries, anchors, localization, and availability guards in sync.
2026-06-10 12:15:15 +03:00
parent eff6f46ad9
commit 079e3a9bd6
44 changed files with 1428 additions and 87 deletions
@@ -28,6 +28,10 @@ export const settingsDict = {
  'settings.view.actions.closeSettingsWithShortcut': 'Close Settings ({shortcut}+,)',
  'settings.view.actions.back': 'Back',
  'settings.view.actions.resizeNavigation': 'Resize settings navigation',
+  'settings.view.search.placeholder': 'Search settings',
+  'settings.view.search.aria': 'Search settings',
+  'settings.view.search.clear': 'Clear settings search',
+  'settings.view.search.noResults': 'No matching settings',
  'settings.page.projects.title': 'Projects',
  'settings.page.remoteInstances.title': 'Remote Instances',
  'settings.page.providers.title': 'Providers',
@@ -28,6 +28,10 @@ export const settingsDict = {
  "settings.view.actions.closeSettingsWithShortcut": "Cerrar configuración ({shortcut}+,)",
  "settings.view.actions.back": "Atrás",
  "settings.view.actions.resizeNavigation": "Ajustar tamaño de la navegación",
+  "settings.view.search.placeholder": "Buscar configuración",
+  "settings.view.search.aria": "Buscar configuración",
+  "settings.view.search.clear": "Borrar búsqueda de configuración",
+  "settings.view.search.noResults": "No hay configuraciones coincidentes",
  "settings.page.projects.title": "Proyectos",
  "settings.page.remoteInstances.title": "Instancias remotas",
  "settings.page.providers.title": "Proveedores",
@@ -28,6 +28,10 @@ export const settingsDict = {
  'settings.view.actions.closeSettingsWithShortcut': '설정 닫기 ({shortcut}+,)',
  'settings.view.actions.back': '뒤로',
  'settings.view.actions.resizeNavigation': '설정 내비게이션 크기 조정',
+  'settings.view.search.placeholder': '설정 검색',
+  'settings.view.search.aria': '설정 검색',
+  'settings.view.search.clear': '설정 검색 지우기',
+  'settings.view.search.noResults': '일치하는 설정이 없습니다',
  'settings.page.projects.title': '프로젝트',
  'settings.page.remoteInstances.title': '원격 인스턴스',
  'settings.page.providers.title': '프로바이더',
@@ -1,4 +1,5 @@
 export const settingsDict = {
+  'settings.appearance.language.label': 'Język',
  'settings.appearance.language.description': 'Wybierz język interfejsu.',
  'settings.agents.modelSelector.actions.addToFavorites': 'Dodaj do ulubionych',
  'settings.agents.modelSelector.actions.favorite': 'Ulubione',
@@ -911,6 +912,8 @@ export const settingsDict = {
  'settings.openchamber.visual.field.interfaceFontSize': 'Rozmiar czcionki interfejsu',
  'settings.openchamber.visual.field.lightTheme': 'Jasny motyw',
  'settings.openchamber.visual.field.mermaidRenderingAria': 'Renderowanie Mermaid: {option}',
+  'settings.openchamber.visual.field.mobileKeyboardMode': 'Tryb klawiatury mobilnej',
+  'settings.openchamber.visual.field.mobileKeyboardModeHint': 'Wybierz sposób zachowania widoku podczas otwartej klawiatury.',
  'settings.openchamber.visual.field.persistDraftMessages': 'Zachowuj szkice wiadomości',
  'settings.openchamber.visual.field.persistDraftMessagesAria': 'Zachowuj szkice wiadomości',
  'settings.openchamber.visual.field.pwaInstallAppNameAria': 'Nazwa aplikacji instalacyjnej PWA',
@@ -1672,6 +1675,10 @@ export const settingsDict = {
  'settings.view.actions.reloadOpenCode': 'Przeładuj OpenCode',
  'settings.view.actions.reloadOpenCodeTooltip': 'Uruchom ponownie OpenCode i przeładuj jego konfigurację.',
  'settings.view.actions.resizeNavigation': 'Zmień rozmiar nawigacji',
+  'settings.view.search.placeholder': 'Szukaj ustawień',
+  'settings.view.search.aria': 'Szukaj ustawień',
+  'settings.view.search.clear': 'Wyczyść wyszukiwanie ustawień',
+  'settings.view.search.noResults': 'Brak pasujących ustawień',
  'settings.view.badge.beta': 'beta',
  'settings.view.home.cards.agents.description': 'Prompty, narzędzia, uprawnienia',
  'settings.view.home.cards.agents.title': 'Agenci',
@@ -28,6 +28,10 @@ export const settingsDict = {
  "settings.view.actions.closeSettingsWithShortcut": "Fechar configurações ({shortcut}+,)",
  "settings.view.actions.back": "Voltar",
  "settings.view.actions.resizeNavigation": "Ajustar tamanho da navegação",
+  "settings.view.search.placeholder": "Buscar configurações",
+  "settings.view.search.aria": "Buscar configurações",
+  "settings.view.search.clear": "Limpar busca de configurações",
+  "settings.view.search.noResults": "Nenhuma configuração encontrada",
  "settings.page.projects.title": "Projetos",
  "settings.page.remoteInstances.title": "Instâncias remotas",
  "settings.page.providers.title": "Provedores",
@@ -28,6 +28,10 @@ export const settingsDict = {
  "settings.view.actions.closeSettingsWithShortcut": "Закрити налаштування ({shortcut}+,)",
  "settings.view.actions.back": "Назад",
  "settings.view.actions.resizeNavigation": "Змінити розмір навігації налаштувань",
+  "settings.view.search.placeholder": "Пошук налаштувань",
+  "settings.view.search.aria": "Пошук налаштувань",
+  "settings.view.search.clear": "Очистити пошук налаштувань",
+  "settings.view.search.noResults": "Нічого не знайдено",
  "settings.page.projects.title": "Проєкти",
  "settings.page.remoteInstances.title": "Віддалені інстанси",
  "settings.page.providers.title": "Провайдери",
@@ -28,6 +28,10 @@ export const settingsDict = {
  'settings.view.actions.closeSettingsWithShortcut': '关闭设置（{shortcut}+,）',
  'settings.view.actions.back': '返回',
  'settings.view.actions.resizeNavigation': '调整设置导航宽度',
+  'settings.view.search.placeholder': '搜索设置',
+  'settings.view.search.aria': '搜索设置',
+  'settings.view.search.clear': '清除设置搜索',
+  'settings.view.search.noResults': '没有匹配的设置',
  'settings.page.projects.title': '项目',
  'settings.page.remoteInstances.title': '远程实例',
  'settings.page.providers.title': '提供商',
@@ -26,6 +26,10 @@
  'settings.view.actions.closeSettingsWithShortcut': '關閉設定（{shortcut}+,）',
  'settings.view.actions.back': '返回',
  'settings.view.actions.resizeNavigation': '調整設定導覽寬度',
+  'settings.view.search.placeholder': '搜尋設定',
+  'settings.view.search.aria': '搜尋設定',
+  'settings.view.search.clear': '清除設定搜尋',
+  'settings.view.search.noResults': '沒有符合的設定',
  'settings.page.projects.title': '專案',
  'settings.page.remoteInstances.title': '遠端執行個體',
  'settings.page.providers.title': '供應商',
@@ -0,0 +1,769 @@
+import type { I18nKey } from '@/lib/i18n/store';
+import type { SettingsPageSlug, SettingsRuntimeContext } from './metadata';
+import { getSettingsPageMeta } from './metadata';
+
+export interface SettingsSearchItem {
+  id: string;
+  page: SettingsPageSlug;
+  titleKey: I18nKey;
+  descriptionKey?: I18nKey;
+  keywords?: string[];
+  isAvailable?: (ctx: SettingsSearchAvailabilityContext) => boolean;
+}
+
+export interface SettingsSearchResult extends SettingsSearchItem {
+  title: string;
+  description: string | null;
+  pageTitle: string;
+}
+
+export interface SettingsSearchAvailabilityContext extends SettingsRuntimeContext {
+  isMobile: boolean;
+  isDesktopLocalOrigin: boolean;
+}
+
+export const SETTINGS_SEARCH_ITEMS: readonly SettingsSearchItem[] = [
+  {
+    id: 'appearance.language',
+    page: 'appearance',
+    titleKey: 'settings.appearance.language.label',
+    descriptionKey: 'settings.appearance.language.description',
+    keywords: ['locale', 'translation', 'ui language'],
+  },
+  {
+    id: 'appearance.time-format',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.timeFormat',
+    keywords: ['clock', '12h', '24h'],
+  },
+  {
+    id: 'appearance.week-start',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.weekStartsOn',
+    keywords: ['calendar', 'monday', 'sunday'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.light-theme',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.lightTheme',
+    keywords: ['theme', 'color', 'light mode'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.dark-theme',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.darkTheme',
+    keywords: ['theme', 'color', 'dark mode'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.pwa-install-name',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.installAppName',
+    descriptionKey: 'settings.openchamber.visual.field.installAppNameHint',
+    keywords: ['pwa', 'installed app'],
+    isAvailable: (ctx) => ctx.isWeb && !ctx.isDesktop && !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.pwa-orientation',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.installOrientation',
+    descriptionKey: 'settings.openchamber.visual.field.installOrientationHint',
+    keywords: ['pwa', 'portrait', 'landscape'],
+    isAvailable: (ctx) => ctx.isWeb && !ctx.isDesktop && !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.mobile-keyboard-mode',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.mobileKeyboardMode',
+    descriptionKey: 'settings.openchamber.visual.field.mobileKeyboardModeHint',
+    keywords: ['mobile', 'keyboard', 'resize'],
+    isAvailable: (ctx) => ctx.isMobile && ctx.isWeb && !ctx.isDesktop && !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.interface-font-size',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.interfaceFontSize',
+    keywords: ['font', 'text size', 'ui scale'],
+    isAvailable: (ctx) => !ctx.isMobile,
+  },
+  {
+    id: 'appearance.terminal-font-size',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.terminalFontSize',
+    keywords: ['terminal', 'font', 'text size'],
+  },
+  {
+    id: 'appearance.spacing-density',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.spacingDensity',
+    keywords: ['density', 'compact', 'comfortable', 'spacing'],
+  },
+  {
+    id: 'appearance.input-bar-offset',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.inputBarOffset',
+    descriptionKey: 'settings.openchamber.visual.field.inputBarOffsetTooltip',
+    keywords: ['input', 'home bar', 'offset'],
+  },
+  {
+    id: 'appearance.file-editor-keymap',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.fileEditorKeymap',
+    keywords: ['editor', 'vim', 'keymap'],
+  },
+  {
+    id: 'appearance.terminal-quick-keys',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.terminalQuickKeys',
+    descriptionKey: 'settings.openchamber.visual.field.terminalQuickKeysTooltip',
+    keywords: ['terminal', 'keyboard', 'esc', 'ctrl', 'arrows'],
+    isAvailable: (ctx) => !ctx.isMobile && !ctx.isVSCode,
+  },
+  {
+    id: 'appearance.usage-reports',
+    page: 'appearance',
+    titleKey: 'settings.openchamber.visual.field.sendAnonymousUsageReports',
+    descriptionKey: 'settings.openchamber.visual.field.sendAnonymousUsageReportsHint',
+    keywords: ['telemetry', 'analytics'],
+  },
+  {
+    id: 'chat.render-mode',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.section.chatRenderMode',
+    keywords: ['messages', 'conversation', 'rendering'],
+  },
+  {
+    id: 'chat.message-transport',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.section.messageStreamTransport',
+    keywords: ['streaming', 'sse', 'websocket'],
+  },
+  {
+    id: 'chat.reasoning-traces',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.showReasoningTraces',
+    keywords: ['thinking', 'reasoning'],
+  },
+  {
+    id: 'chat.sticky-user-header',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.stickyUserHeader',
+    keywords: ['messages', 'header'],
+  },
+  {
+    id: 'chat.wide-layout',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.wideChatLayout',
+    keywords: ['layout', 'wide', 'messages'],
+  },
+  {
+    id: 'chat.inline-assistant-actions',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.showSplitAssistantMessageActions',
+    descriptionKey: 'settings.openchamber.visual.field.showSplitAssistantMessageActionsTooltip',
+    keywords: ['copy', 'save image', 'read aloud'],
+  },
+  {
+    id: 'chat.tool-file-icons',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.showToolFileIcons',
+    keywords: ['tools', 'files', 'icons'],
+  },
+  {
+    id: 'chat.changed-files',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.showTurnChangedFiles',
+    keywords: ['changed files', 'turns'],
+  },
+  {
+    id: 'chat.dotfiles',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.showDotfiles',
+    keywords: ['hidden files'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'chat.queue-mode',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.queueMessagesByDefault',
+    descriptionKey: 'settings.openchamber.visual.field.queueMessagesByDefaultTooltip',
+    keywords: ['queue', 'enter', 'send'],
+  },
+  {
+    id: 'chat.persist-drafts',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.persistDraftMessages',
+    keywords: ['draft', 'message'],
+  },
+  {
+    id: 'chat.spellcheck',
+    page: 'chat',
+    titleKey: 'settings.openchamber.visual.field.enableSpellcheckInTextInputs',
+    keywords: ['spelling', 'input'],
+    isAvailable: (ctx) => !ctx.isMobile,
+  },
+  {
+    id: 'sessions.default-model',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.defaults.field.defaultModel',
+    keywords: ['model', 'provider', 'new sessions'],
+  },
+  {
+    id: 'sessions.default-thinking',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.defaults.field.defaultThinking',
+    keywords: ['thinking', 'reasoning', 'variant'],
+  },
+  {
+    id: 'sessions.default-agent',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.defaults.field.defaultAgent',
+    keywords: ['agent', 'new sessions'],
+  },
+  {
+    id: 'sessions.deletion-dialog',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.defaults.field.showDeletionDialog',
+    keywords: ['delete', 'confirmation'],
+  },
+  {
+    id: 'sessions.auto-cleanup',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.sessionRetention.field.enableAutoCleanup',
+    descriptionKey: 'settings.openchamber.sessionRetention.tooltip',
+    keywords: ['retention', 'archive', 'delete'],
+  },
+  {
+    id: 'sessions.retention-period',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.sessionRetention.field.retentionPeriod',
+    keywords: ['days', 'cleanup', 'retention'],
+  },
+  {
+    id: 'sessions.retention-action',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.sessionRetention.field.whenSessionsExpire',
+    keywords: ['archive', 'delete', 'expire'],
+  },
+  {
+    id: 'sessions.desktop-launch-at-login',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.desktopNetwork.field.launchAtLogin',
+    descriptionKey: 'settings.openchamber.desktopNetwork.field.launchAtLoginDescription',
+    keywords: ['desktop', 'startup', 'login'],
+    isAvailable: (ctx) => ctx.isDesktopLocalOrigin,
+  },
+  {
+    id: 'sessions.desktop-ui-password',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.desktopPassword.field.password',
+    descriptionKey: 'settings.openchamber.desktopPassword.field.passwordDescription',
+    keywords: ['desktop', 'password', 'auth', 'login'],
+    isAvailable: (ctx) => ctx.isDesktopLocalOrigin,
+  },
+  {
+    id: 'sessions.desktop-lan-access',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.desktopNetwork.field.allowLanAccess',
+    descriptionKey: 'settings.openchamber.desktopNetwork.field.allowLanAccessDescription',
+    keywords: ['desktop', 'lan', 'network', 'phone', 'tablet'],
+    isAvailable: (ctx) => ctx.isDesktopLocalOrigin,
+  },
+  {
+    id: 'sessions.opencode-binary',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.opencodeCli.field.binaryPath',
+    keywords: ['opencode', 'cli', 'binary', 'path'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'sessions.opencode-update-notifications',
+    page: 'sessions',
+    titleKey: 'settings.openchamber.opencodeCli.field.showUpdateNotifications',
+    keywords: ['opencode', 'cli', 'updates'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'git.github-account',
+    page: 'git',
+    titleKey: 'settings.github.page.actions.connect',
+    keywords: ['github', 'account', 'oauth', 'prs', 'issues'],
+  },
+  {
+    id: 'git.identities',
+    page: 'git',
+    titleKey: 'settings.gitIdentities.page.section.title',
+    descriptionKey: 'settings.gitIdentities.page.empty.description',
+    keywords: ['identity', 'profile', 'author', 'email', 'credentials'],
+  },
+  {
+    id: 'git.changes-view',
+    page: 'git',
+    titleKey: 'settings.openchamber.git.changesViewTitle',
+    keywords: ['changes', 'flat list', 'tree view'],
+  },
+  {
+    id: 'git.gitmoji',
+    page: 'git',
+    titleKey: 'settings.openchamber.git.enableGitmoji',
+    keywords: ['commit', 'emoji'],
+  },
+  {
+    id: 'git.gitignored-files',
+    page: 'git',
+    titleKey: 'settings.openchamber.git.showGitignored',
+    keywords: ['ignored', 'files', 'gitignore'],
+  },
+  {
+    id: 'usage.header-menu',
+    page: 'usage',
+    titleKey: 'settings.usage.page.options.showInHeader',
+    descriptionKey: 'settings.usage.page.options.showInHeaderTooltip',
+    keywords: ['quota', 'header', 'dropdown'],
+  },
+  {
+    id: 'usage.model-quotas',
+    page: 'usage',
+    titleKey: 'settings.usage.page.section.modelQuotas',
+    keywords: ['models', 'quota', 'limits', 'tokens'],
+  },
+  {
+    id: 'projects.name',
+    page: 'projects',
+    titleKey: 'settings.projects.page.field.projectName',
+    keywords: ['label', 'display name', 'project metadata'],
+  },
+  {
+    id: 'projects.accent-color',
+    page: 'projects',
+    titleKey: 'settings.projects.page.field.accentColor',
+    keywords: ['color', 'appearance', 'project metadata'],
+  },
+  {
+    id: 'projects.icon',
+    page: 'projects',
+    titleKey: 'settings.projects.page.field.projectIcon',
+    keywords: ['icon', 'favicon', 'upload', 'project metadata'],
+  },
+  {
+    id: 'projects.worktree',
+    page: 'projects',
+    titleKey: 'settings.projects.page.section.worktree',
+    keywords: ['worktree', 'branch', 'repository'],
+  },
+  {
+    id: 'remote-instances.client-auth',
+    page: 'remote-instances',
+    titleKey: 'settings.remoteInstances.clientAuth.title',
+    descriptionKey: 'settings.remoteInstances.clientAuth.description',
+    keywords: ['pairing link', 'client token', 'connect desktop', 'remote access'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'remote-instances.direct-hosts',
+    page: 'remote-instances',
+    titleKey: 'settings.remoteInstances.direct.title',
+    descriptionKey: 'settings.remoteInstances.direct.description',
+    keywords: ['server url', 'connection token', 'import link', 'host switcher'],
+    isAvailable: (ctx) => ctx.isDesktop,
+  },
+  {
+    id: 'behavior.system-prompt',
+    page: 'behavior',
+    titleKey: 'settings.behavior.page.section.systemPrompt',
+    descriptionKey: 'settings.behavior.page.warning.title',
+    keywords: ['agents.md', 'global instructions', 'system prompt'],
+  },
+  {
+    id: 'behavior.response-style',
+    page: 'behavior',
+    titleKey: 'settings.behavior.page.section.responseStyle',
+    descriptionKey: 'settings.behavior.page.responseStyle.tooltip',
+    keywords: ['tone', 'concise', 'detailed', 'custom instructions'],
+  },
+  {
+    id: 'agents.create',
+    page: 'agents',
+    titleKey: 'settings.agents.page.title.new',
+    keywords: ['create', 'add', 'new agent'],
+  },
+  {
+    id: 'agents.name',
+    page: 'agents',
+    titleKey: 'settings.agents.page.field.agentName',
+    keywords: ['agent', 'name'],
+  },
+  {
+    id: 'agents.mode',
+    page: 'agents',
+    titleKey: 'settings.agents.page.field.mode',
+    descriptionKey: 'settings.agents.page.field.modeTooltip',
+    keywords: ['primary', 'subagent', 'visibility'],
+  },
+  {
+    id: 'agents.model',
+    page: 'agents',
+    titleKey: 'settings.agents.page.field.overrideModel',
+    keywords: ['model', 'provider'],
+  },
+  {
+    id: 'agents.temperature',
+    page: 'agents',
+    titleKey: 'settings.agents.page.field.temperature',
+    descriptionKey: 'settings.agents.page.field.temperatureTooltip',
+    keywords: ['randomness', 'creative'],
+  },
+  {
+    id: 'agents.top-p',
+    page: 'agents',
+    titleKey: 'settings.agents.page.field.topP',
+    descriptionKey: 'settings.agents.page.field.topPTooltip',
+    keywords: ['sampling', 'nucleus'],
+  },
+  {
+    id: 'agents.system-prompt',
+    page: 'agents',
+    titleKey: 'settings.agents.page.section.systemPrompt',
+    keywords: ['prompt', 'instructions'],
+  },
+  {
+    id: 'agents.permissions',
+    page: 'agents',
+    titleKey: 'settings.agents.page.section.toolPermissions',
+    keywords: ['tools', 'permissions', 'allow', 'ask', 'deny'],
+  },
+  {
+    id: 'commands.create',
+    page: 'commands',
+    titleKey: 'settings.commands.page.title.new',
+    keywords: ['create', 'add', 'new command'],
+  },
+  {
+    id: 'commands.name',
+    page: 'commands',
+    titleKey: 'settings.commands.page.field.commandName',
+    keywords: ['slash command', 'name'],
+  },
+  {
+    id: 'commands.agent',
+    page: 'commands',
+    titleKey: 'settings.commands.page.field.overrideAgent',
+    keywords: ['agent', 'execution'],
+  },
+  {
+    id: 'commands.model',
+    page: 'commands',
+    titleKey: 'settings.agents.page.field.overrideModel',
+    keywords: ['model', 'provider'],
+  },
+  {
+    id: 'commands.template',
+    page: 'commands',
+    titleKey: 'settings.commands.page.section.template',
+    keywords: ['prompt', 'template', 'arguments', 'shell', 'file'],
+  },
+  {
+    id: 'mcp.create',
+    page: 'mcp',
+    titleKey: 'settings.mcp.sidebar.actions.addServerTitle',
+    keywords: ['create', 'add', 'server'],
+  },
+  {
+    id: 'mcp.server',
+    page: 'mcp',
+    titleKey: 'settings.mcp.page.server.title',
+    keywords: ['server', 'name', 'transport'],
+  },
+  {
+    id: 'mcp.command',
+    page: 'mcp',
+    titleKey: 'settings.mcp.page.connection.command',
+    keywords: ['stdio', 'local', 'command'],
+  },
+  {
+    id: 'mcp.environment',
+    page: 'mcp',
+    titleKey: 'settings.mcp.page.env.title',
+    keywords: ['env', 'variables', 'api key'],
+  },
+  {
+    id: 'mcp.advanced',
+    page: 'mcp',
+    titleKey: 'settings.mcp.page.advanced.title',
+    keywords: ['oauth', 'headers', 'timeout'],
+  },
+  {
+    id: 'plugins.create',
+    page: 'plugins',
+    titleKey: 'settings.plugins.sidebar.actions.addTitle',
+    keywords: ['add', 'plugin', 'npm', 'path', 'file'],
+  },
+  {
+    id: 'plugins.spec',
+    page: 'plugins',
+    titleKey: 'settings.plugins.page.field.spec',
+    keywords: ['npm', 'package', 'path'],
+  },
+  {
+    id: 'plugins.options',
+    page: 'plugins',
+    titleKey: 'settings.plugins.page.field.options',
+    keywords: ['json', 'configuration'],
+  },
+  {
+    id: 'plugins.content',
+    page: 'plugins',
+    titleKey: 'settings.plugins.page.field.content',
+    keywords: ['file', 'code'],
+  },
+  {
+    id: 'snippets.create',
+    page: 'snippets',
+    titleKey: 'settings.snippets.sidebar.actions.create',
+    keywords: ['add', 'new snippet'],
+  },
+  {
+    id: 'snippets.content',
+    page: 'snippets',
+    titleKey: 'settings.snippets.page.field.content',
+    keywords: ['markdown', 'prompt', 'template'],
+  },
+  {
+    id: 'providers.connect',
+    page: 'providers',
+    titleKey: 'settings.providers.page.connect.title',
+    keywords: ['add provider', 'connect provider', 'credentials'],
+  },
+  {
+    id: 'providers.auth',
+    page: 'providers',
+    titleKey: 'settings.providers.page.auth.title',
+    keywords: ['api key', 'oauth', 'credentials'],
+  },
+  {
+    id: 'providers.connection-details',
+    page: 'providers',
+    titleKey: 'settings.providers.page.connectionDetails.title',
+    keywords: ['config', 'source', 'disconnect'],
+  },
+  {
+    id: 'providers.models',
+    page: 'providers',
+    titleKey: 'settings.providers.page.models.title',
+    keywords: ['models', 'hide', 'show'],
+  },
+  {
+    id: 'skills.create',
+    page: 'skills.installed',
+    titleKey: 'settings.skills.page.title.newSkill',
+    keywords: ['create', 'add', 'new skill'],
+  },
+  {
+    id: 'skills.basic-information',
+    page: 'skills.installed',
+    titleKey: 'settings.skills.page.section.basicInformation',
+    keywords: ['name', 'location', 'description'],
+  },
+  {
+    id: 'skills.instructions',
+    page: 'skills.installed',
+    titleKey: 'settings.skills.page.section.instructions',
+    keywords: ['markdown', 'skill.md', 'content'],
+  },
+  {
+    id: 'skills.supporting-files',
+    page: 'skills.installed',
+    titleKey: 'settings.skills.page.section.supportingFiles',
+    keywords: ['files', 'resources'],
+  },
+  {
+    id: 'skills.catalog.source',
+    page: 'skills.catalog',
+    titleKey: 'settings.skills.catalog.page.section.sourceRepository',
+    keywords: ['catalog', 'repository', 'source', 'refresh'],
+  },
+  {
+    id: 'skills.catalog.search',
+    page: 'skills.catalog',
+    titleKey: 'settings.skills.catalog.shared.field.searchSkillsPlaceholder',
+    keywords: ['find skills', 'install skills', 'catalog search'],
+  },
+  {
+    id: 'skills.catalog.add-catalog',
+    page: 'skills.catalog',
+    titleKey: 'settings.skills.catalog.page.actions.addCatalog',
+    keywords: ['external repository', 'add source', 'catalog'],
+  },
+  {
+    id: 'magic-prompts.visible-prompt',
+    page: 'magic-prompts',
+    titleKey: 'settings.magicPrompts.page.block.visiblePrompt',
+    keywords: ['prompt text', 'user message', 'template'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'magic-prompts.instructions',
+    page: 'magic-prompts',
+    titleKey: 'settings.magicPrompts.page.block.instructions',
+    keywords: ['hidden prompt', 'instructions', 'template'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'magic-prompts.reset-overrides',
+    page: 'magic-prompts',
+    titleKey: 'settings.magicPrompts.page.actions.resetAllOverrides',
+    keywords: ['reset', 'default prompts', 'overrides'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'shortcuts.keyboard-shortcuts',
+    page: 'shortcuts',
+    titleKey: 'settings.openchamber.keyboardShortcuts.title',
+    descriptionKey: 'settings.openchamber.keyboardShortcuts.tooltip',
+    keywords: ['keyboard', 'hotkeys', 'bindings'],
+  },
+  {
+    id: 'voice.voice-setup',
+    page: 'voice',
+    titleKey: 'settings.voice.page.section.voiceSetup',
+    keywords: ['tts', 'voice mode', 'provider', 'speech rate', 'speech pitch', 'speech volume', 'language'],
+  },
+  {
+    id: 'voice.speech-recognition',
+    page: 'voice',
+    titleKey: 'settings.voice.page.section.speechRecognition',
+    keywords: ['stt', 'transcribe', 'whisper', 'microphone', 'silence threshold'],
+  },
+  {
+    id: 'voice.playback',
+    page: 'voice',
+    titleKey: 'settings.voice.page.section.playbackAndSummary',
+    keywords: ['read aloud', 'tts input mode', 'summary', 'markdown'],
+  },
+  {
+    id: 'tunnel.provider',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.field.provider',
+    descriptionKey: 'settings.openchamber.tunnel.description',
+    keywords: ['remote access', 'cloudflare', 'ngrok'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'tunnel.type',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.field.tunnelType',
+    keywords: ['quick', 'managed remote', 'managed local'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'tunnel.ttl',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.field.connectLinkTtl',
+    descriptionKey: 'settings.openchamber.tunnel.field.tunnelSessionTtl',
+    keywords: ['expiry', 'expiration', 'session ttl', 'connect link ttl'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'tunnel.managed-remote',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.section.savedManagedRemoteTunnels',
+    keywords: ['cloudflare', 'hostname', 'token', 'managed remote'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'tunnel.managed-local-config',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.field.configurationFile',
+    descriptionKey: 'settings.openchamber.tunnel.note.managedLocalUsesConfig',
+    keywords: ['cloudflared', 'config', 'yaml', 'json', 'managed local'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'tunnel.start',
+    page: 'tunnel',
+    titleKey: 'settings.openchamber.tunnel.actions.startTunnel',
+    descriptionKey: 'settings.openchamber.tunnel.note.connectLinksOneTime',
+    keywords: ['connect link', 'qr code', 'public url', 'remote access'],
+    isAvailable: (ctx) => !ctx.isVSCode,
+  },
+  {
+    id: 'notifications.delivery',
+    page: 'notifications',
+    titleKey: 'settings.notifications.page.delivery.title',
+    keywords: ['desktop notifications', 'system notifications'],
+  },
+  {
+    id: 'notifications.events',
+    page: 'notifications',
+    titleKey: 'settings.notifications.page.events.title',
+    keywords: ['completion', 'subtasks', 'errors', 'questions'],
+  },
+  {
+    id: 'notifications.push',
+    page: 'notifications',
+    titleKey: 'settings.notifications.page.push.title',
+    keywords: ['background', 'push'],
+    isAvailable: (ctx) => ctx.isWeb && !ctx.isDesktop && !ctx.isVSCode,
+  },
+] as const;
+
+interface BuildSettingsSearchResultsOptions {
+  query: string;
+  runtimeCtx: SettingsSearchAvailabilityContext;
+  visiblePageSlugs?: SettingsPageSlug[];
+  t: (key: I18nKey) => string;
+  getPageTitle: (slug: SettingsPageSlug) => string;
+}
+
+function normalizeSearchText(value: string): string {
+  return value.trim().toLocaleLowerCase();
+}
+
+export function buildSettingsSearchResults({
+  query,
+  runtimeCtx,
+  visiblePageSlugs,
+  t,
+  getPageTitle,
+}: BuildSettingsSearchResultsOptions): SettingsSearchResult[] {
+  const normalizedQuery = normalizeSearchText(query);
+  if (!normalizedQuery) {
+    return [];
+  }
+
+  const allowedPages = visiblePageSlugs ? new Set<SettingsPageSlug>(visiblePageSlugs) : null;
+  const terms = normalizedQuery.split(/\s+/).filter(Boolean);
+
+  return SETTINGS_SEARCH_ITEMS.flatMap((item) => {
+    if (allowedPages && !allowedPages.has(item.page)) {
+      return [];
+    }
+
+    const pageMeta = getSettingsPageMeta(item.page);
+    if (!pageMeta || (pageMeta.isAvailable && !pageMeta.isAvailable(runtimeCtx)) || (item.isAvailable && !item.isAvailable(runtimeCtx))) {
+      return [];
+    }
+
+    const title = t(item.titleKey);
+    const description = item.descriptionKey ? t(item.descriptionKey) : null;
+    const haystack = normalizeSearchText([
+      title,
+      description,
+      getPageTitle(item.page),
+      ...(item.keywords ?? []),
+    ].filter(Boolean).join(' '));
+
+    if (!terms.every((term) => haystack.includes(term))) {
+      return [];
+    }
+
+    return [{
+      ...item,
+      title,
+      description,
+      pageTitle: getPageTitle(item.page),
+    }];
+  });
+}