dsh-command-menu

A Cmd/Ctrl+K command menu for the DeepSeek Harness (dsh) Web UI, in the style of Linear, Raycast, and VS Code. One keyboard-first search box finds and acts on:

• sessions by title, and message text through the server's session search; opening a message hit scrolls to the match;
• the current session's slash commands;
• settings pages, themes, and workspaces;
• models: switch the current session's model;
• actions: new session, toggle the sidebars, toggle light and dark, fork the session, stop the running turn, focus the message box.

Contents

• Install
• Using it
• What each row does
• Configuration
• Privacy
• Known limitations
• Compatibility
• Development

Install

dsh plugin --profile web add dsh-command-menu

From a packed tarball (for example one built from this repository with pnpm pack):

dsh plugin --profile web add /absolute/path/to/dsh-command-menu-0.2.0.tgz

The bundle patch (cordis.patch.yml) inserts one plugin row with id command-menu. Restart dsh if the profile does not reload live.

Message text search needs the server's session search index, which the stock Web profile keeps off. Turn it on with a profile patch:

- id: session-query-sqlite
  config:
    path: ':memory:'          # or a file path to keep the index across restarts
    openAt: first-search

Without it the menu still matches session titles and says that message search is off.

Using it

Press Cmd+K (macOS) or Ctrl+K (Windows, Linux) anywhere, including while typing in the message box. Press it again, or Escape, to close. On a phone, tap the search button at the bottom of the sidebar; the menu fills the screen.

With an empty search box the menu lists Recent entries you used, then Actions, your latest Sessions, and the search Scopes. Type to search everything; results are grouped (Sessions, Commands, Settings, Models, Messages, ...) and the group with the best match comes first.

| Key | Action | |---|---| | ↑ ↓ (or Ctrl+P Ctrl+N) | Move | | Enter | Run the highlighted row, or open its list | | Backspace in an empty box | Back one list | | Esc | Back one list, then close |

Start the search with a prefix to narrow it:

| Prefix | Searches | |---|---| | > or / | Slash commands (and actions) | | @ | Sessions, message text, and workspaces | | # | Settings pages and themes | | ? | Lists these scopes |

Rows ending in › open a nested list: Switch model…, Change theme…, Open workspace…, and each workspace (its sessions plus "New session in ..."). The field shows where you are; Backspace in an empty field goes back.

What each row does

| Row | Effect | |---|---| | Session | Opens the session. | | Message hit | Opens the session, scrolls the matching text into view, and highlights it for a moment. If the match is in older history that is not loaded yet, a notice says to scroll up. | | /command | Runs the command in the current session, exactly as if you typed it in the message box. A command that takes input (such as /goal <objective>) is placed in the message box for you to finish. The message box draft is replaced. | | Settings page | Opens Settings on that page. | | Theme | Sets the theme preference (Follow system, Light, Dark, or an installed theme). | | Model | Switches the current session's model; the composer's model control shows the change. | | Workspace | Opens a list of its sessions and "New session in ...". |

Rows appear only when the part of dsh behind them is loaded: no model or command rows without an open session, no Stop without a running turn, no right-panel toggle without the right sidebar.

Configuration

A profile patch targeting the command-menu row:

- id: command-menu
  config:
    hotkeys: [Mod+K, Mod+Shift+P]   # Mod = Cmd on macOS, Ctrl elsewhere
    recentLimit: 5                  # recents on the empty menu, 0 to 20
    groupLimit: 8                   # rows per group while searching, 1 to 50
    messageSearch: true             # search message text through the server

| Field | Default | Meaning | |---|---|---| | hotkeys | [Mod+K] | Key combinations that open and close the menu: Mod, Ctrl, Meta, Alt, Shift joined with +, then a letter, digit, F1–F12, or a named key (Slash, Period, Comma, Space, ...). Keys match the physical key, so they work in any keyboard layout. An empty list leaves only the sidebar button. | | recentLimit | 5 | Recently used entries listed when the search box is empty. | | groupLimit | 8 | Rows each group shows while searching; the rest are counted. | | messageSearch | true | Also search message text. |

The hotkey yields when another handler already took the key (for example a shortcut plugin bound to the same combination), while an input method is composing, and inside any element marked data-command-menu-ignore.

Privacy

Recently used entries are stored in this browser's localStorage (dsh-command-menu:recents) as ids only (session:<id>, command:<name>, ...). Search text, titles, and message snippets are never stored. Message search sends the query to your dsh server's session search, like the sidebar search does.

Known limitations

• Client-only slash commands (added by browser plugins through commandUi.register) are not listed; dsh has no public list of them. Host commands, skills, and plugin commands are listed.
• Opening a settings page clicks the sidebar Settings button and then the page's tab, because the settings dialog has no public "open page" call. A layout without that button shows a notice.
• Scroll to match searches the rendered conversation for the query text. Message search returns no message position, so a match in history that is not loaded yet cannot be revealed.
• Recent files are not listed; dsh exposes no list of recently opened files. Use @ in the message box for files.

Compatibility

• dsh >=0.2.0-rc.1 <0.3, Web profile (dsh.client.platform: web).
• Node.js ^22.19 || >=24.
• Coexists with keyboard-shortcut plugins such as @hytime/dsh-client-ui-shortcuts (its default chords use Meta+Alt+Shift).

Development

pnpm install
pnpm --filter dsh-command-menu run typecheck
pnpm --filter dsh-command-menu test
pnpm --filter dsh-command-menu run build
pnpm --filter dsh-command-menu run pack:tarball   # writes .artifacts/dsh-command-menu-<version>.tgz

The unit tests cover ranking, prefixes, grouping, recents, and hotkey matching; the menu's keyboard behavior, nested pages, and ARIA wiring in jsdom; the service adapter against fake dsh services (commands, model switch, settings, message reveal); the client plugin's registrations and global hotkey; and the Host half through a real Cordis Loader.

The browser test (e2e/) installs the packed plugin and a test-only model route into a throwaway DSH_HOME, boots the web profile with message search on, and drives Chromium through the hotkey, a new session, message search and reveal, the nested model page and a model switch, slash commands, a settings page, themes, recents, and the phone-width sheet:

# @deepseek-ai/dsh from npm, at the version of the pinned @deepseek-ai/dsh-* dev dependencies
pnpm --filter dsh-command-menu run test:e2e
# another npm version, a built dsh checkout, or any other launcher
DSH_E2E_VERSION=0.2.0-rc.2 pnpm --filter dsh-command-menu run test:e2e
DSH_E2E_CHECKOUT=/path/to/deepseek-harness pnpm --filter dsh-command-menu run test:e2e
DSH_E2E_BIN="npx -y @deepseek-ai/dsh@next" pnpm --filter dsh-command-menu run test:e2e

DSH_E2E_KEEP_HOME=1 keeps the throwaway DSH_HOME; DSH_E2E_SCREENSHOT=/path.png saves a screenshot of the open menu. It needs Playwright's Chromium (pnpm exec playwright install chromium).

Design notes and research: docs/design.md.

License

MIT