deepseekplugins

DeepSeek Harness plugin

dsh-conversation-minimap-braidywu

DSH Web GUI prompt-based conversation minimap: a vertical navigation rail on the left of long conversations, each anchor = one user prompt; hover shows the prompt preview, click jumps to that message.

UI Enhancements
Jump to install

Source facts

Repository
Braidy-Wu/dsh-conversation-minimap
Latest update
Aug 19, 2026
Category
UI Enhancements
GitHub stars
1
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/Braidy-Wu/dsh-conversation-minimap
Plugin: dsh-conversation-minimap-braidywu
Author: Braidy-Wu

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-conversation-minimap

English | 中文

A DeepSeek Harness (DSH) Web GUI plugin: Prompt-based Conversation Minimap — a ChatGPT-desktop-style navigation rail for long conversations.

  • Anchors: one capsule per user prompt, evenly spaced, centered in the rail
  • Fish-eye: bars magnify on a Gaussian bell curve toward the right under the cursor (44px peak), stay magnified while the pointer moves inside the enlarged area, slide smoothly
  • Edge fade: the rail fades at the top/bottom via a mask — overflowing anchors fade out and never exceed the rail bounds
  • Position tracking: a blue glowing highlight follows the current prompt (switches when the prompt's center crosses the viewport center); after window resizes the view snaps back to the bottom and the visible anchors always follow where you are
  • Interaction: hover shows the full prompt preview; click smooth-scrolls to that message and highlights it for 2s (no stuck highlights on rapid clicks)
  • Full history: pulls the entire conversation via the official loadOlder API, so every prompt in a long conversation is reachable

![screenshot](docs/screenshot.png)

Installation

Option 1 — npm (recommended)

dsh plugin --profile web add dsh-conversation-minimap

Option 2 — from GitHub

dsh plugin --profile web add github:Braidy-Wu/dsh-conversation-minimap

Restart dsh web.

Configuration (cordis.patch.yml, all optional — restart dsh web after changes)

- insert:
    - id: conversation-minimap
      name: dsh-conversation-minimap
      config:
        enabled: true    # master switch (false = never loads)
        minPrompts: 4    # show the rail once the session has at least this many user prompts (default 4, range 0-100)
        anchorSize: 3    # anchor bar height in px (default 3, range 2-8)

How it works

  • Data: pulls full history through the official ctx.sessions + conversation.loadOlder() API; observes the rendered conversation DOM — user messages carry data-chat-flow-kind="user" (and steering), jump targets use the rows' data-chat-anchor-key (the same mechanism the official UI scrolls by)
  • Mounting: an absolutely positioned seat on the conversation viewport wrapper — no layout impact; edge clipping + mask fade
  • Updates: MutationObserver on the message list (debounced + key-set diff, no jitter while streaming); polling handles session switches; nothing renders during history sync — the full rail appears at once
  • Safety: everything is guarded by try/catch; any unexpected failure only disables the minimap, never the GUI

A plain-vanilla-JS client plugin (inject: ['sessions'], mirroring the dsh-theme-plugin shape) with no build step and no dependencies.

Development

node --check client.js index.js   # syntax check
# smoke test: test/smoke.html + python3 -m http.server

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category