dsh-session-search

Full-text search across every DeepSeek Harness conversation. Press ⌥K (Alt+K), type, and jump straight to the message — not just the session.

Search behaviour is modelled on obsidian-omnisearch — an excellent plugin for a different app — and built on the same engine, MiniSearch. This project is not affiliated with it and does not reuse its name.

Why

The Harness sidebar search matches session titles and metadata. This plugin indexes the message bodies — every prompt you typed and every reply you got — so you can find that command you ran three weeks ago in a session you never named.

Install

dsh plugin --profile web add dsh-session-search

Not on npm yet — until it is, install straight from GitHub:

dsh plugin --profile web add github:ivanearisty/dsh-session-search

Then restart the harness (the host half builds its index at boot).

Use

Key	Action
⌥K / Alt+K	Open search
↑ ↓ (or Ctrl+N / Ctrl+P)	Move through results
↵	Open the session and scroll to that message
Esc	Close

Results group by session, newest first, with the matched terms highlighted. Choosing a hit opens the session, pages its history back until the message is on screen, and flashes it.

How it works

The index lives entirely on the host — the browser never downloads it, and each query returns only a page of short snippets. The tab stays light.

• One document per message: your prompts (user/message with a human source — plugin and system snapshots are skipped) and the assistant's replies.
• Built once at boot from the session store, then kept current from the live session/event stream. No polling, no rescans.
• Ranking mirrors omnisearch: prefix + fuzzy matching, a 3× boost on the session title, strict AND with an OR fallback when nothing lines up.
• Renames restamp every document of a session, so a result always shows the session's current name.
• Forks are de-duplicated — a forked session inherits its parent's history verbatim, so the inherited prefix is skipped when the parent is also present. When it is not (archived, deleted, or never on this machine), those messages are indexed here, because they exist nowhere else.

Reference scale: ~70 sessions / ~1,200 messages indexes in about a second, and queries answer in single-digit milliseconds.

Permissions and data

• Reads your local session logs through the harness's own session-store service. Nothing leaves your machine; there is no network call, no telemetry, and no external service.
• Registers one private host channel (/dsh-session-search) with search and status endpoints, plus one browser overlay and one keydown listener.

Optional companion

If dsh-kepler-graveyard is also installed, hits in archived sessions show a Resurrect button. Without it, archived sessions still appear, marked 🪦 and not openable. The companion is detected at runtime and is in no way required.

Settings

The plugin registers a dsh-session-search settings namespace, so it appears as a card under Settings → Plugins (showing live index size) like any other installed plugin, and its section lives in settings.yaml:

dsh-session-search:
  resultLimit: 60        # maximum hits per query
  indexAssistant: true   # index assistant replies as well as your prompts

Compatibility

• DeepSeek Harness 0.1.x (developed against 0.1.1-rc.2), web profile.
• Node ^22.19 || >=24.
• Harness packages are optional peer dependencies: the plugin resolves them from the host installation rather than bundling its own copies.

Known limitations

• Only text is indexed — images, tool call arguments, and reasoning blocks are not.
• The reveal step finds the message by text. If a message was compacted out of the visible history, the session still opens but nothing is highlighted.
• Chord is fixed at ⌥K in this version; it is not yet rebindable.

License

MIT