@akshaydev17/dsh-spotlight-english
v0.0.3
Published
Keyboard-first command palette for DeepSeek Harness Web
Readme
DSH Spotlight
English
A keyboard-first command palette for DeepSeek Harness Web. Open one palette to find native slash commands, recent sessions, visible UI actions, and installed plugin settings—without leaving the keyboard.
Features
- One shortcut:
⌘Kon macOS,Ctrl+Kon other platforms. - Customizable: click the shortcut control in the footer, then press a new key combination. The setting is stored in the current browser.
- Native actions: discovers and triggers the actions already provided by
DSH Web, and contributes one
/spotlightcommand to the native slash menu instead of maintaining a second command registry. - Fast search: deterministic fuzzy matching across slash commands, recent sessions, UI actions, and plugin settings.
- Keyboard navigation: Arrow Up/Down to select, Enter to run, Escape to close.
- Clean lifecycle: removes its event listeners, styles, and DOM nodes when unloaded.
Install
Install the bundle into your DSH Web profile:
dsh plugin --profile web add "@akshaydev17/dsh-spotlight-english"The npm release already contains the built lib/ files and does not run
prepare during installation.
Then start DSH Web and press ⌘K or Ctrl+K:
dsh --profile webUsage
- Open Spotlight with the global shortcut, or type
/spotlightin the DSH Web composer and pick the entry from the slash menu. - Type to filter commands and actions.
- Use Arrow Up/Down and Enter, or click a result.
- Click Shortcut in the footer to record a different key combination.
- Click Reset to restore the platform default.
Shortcut preferences are local to the current browser origin and profile.
How it works
DSH Spotlight is a standalone Cordis bundle with a small Web client. The client mounts once the host's sessions, command-plane, plugin-inventory, and command-UI services exist — all standard in every stock DSH Web deployment — then reads recent sessions, slash commands, and the plugin inventory directly from those services. It also discovers actionable elements in the current page and delegates execution back to those native elements. A catalog RPC failure degrades only its own category. The plugin adds no server data channel and stores no durable server-side state.
src/index.ts Loader metadata
src/client/index.ts Web client activation and disposal
src/spotlight/ Host + DOM discovery, search, keyboard handling, and UI
cordis.patch.yml DSH Web profile compositionBecause part of the discovery follows the current DSH Web DOM, host UI
changes may require updating the selectors in src/spotlight/discovery.ts.
Development
Requirements: Node.js ^22.19.0 || >=24.0.0 and pnpm 11.7.0. In a checkout
of the repository on the english branch:
pnpm install
pnpm run verify:self-contained
pnpm run typecheck
pnpm test
pnpm run buildTest a local checkout in DSH Web:
pnpm run prepare
dsh plugin --profile web add "link:$(pwd)"
dsh --profile webInspect the package contents before publishing:
pnpm pack --dry-run --json