deepseekplugins

DeepSeek Harness plugin

dsh-session-nav-karmiy

Codex-style session navigator plugin for DeepSeek Harness Web.

Tools & Capabilities
Jump to install

Source facts

Repository
karmiy/dsh-session-nav
Latest update
Aug 21, 2026
Category
Tools & Capabilities
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/karmiy/dsh-session-nav
Plugin: dsh-session-nav-karmiy
Author: karmiy

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-session-nav

![dsh-plugin](https://github.com/topics/dsh-plugin)

English | 中文

A DeepSeek Harness Web plugin that adds a Codex-style session navigator on the left of the conversation.

![Session navigator: packed left-edge dashes, Worked-for duration, and a prompt bubble over the conversation](docs/screenshot.png)

It is an overlay only. It does not replace Chat, the sidebar, or the Trajectory tab.

What you get

  • Idle: a packed stack of short dashes on the left edge of the conversation column — one dash per user, steering, or slash-command turn.
  • Hover: neighbouring dashes lengthen in a delayed wave, then a prompt bubble, an optional Worked for duration, and an optional Edited N files +X −Y card.
  • Jump: click a dash (or use ↑ / ↓ on the rail) to scroll that turn into view.
  • Full log: older turns are listed from session.history even if Chat has not loaded them yet. Clicking one pages loadOlder until the row exists, then scrolls to it.
  • Toggle: a tick-mark button in the session header. Preference is stored as dsh-session-nav:enabled in localStorage.

The rail sits vertically centered, capped at 66% of the conversation column, and scrolls inside itself when the stack is long.

Install

Wait until DSH is idle. Adding a plugin rebuilds the web profile and will interrupt a running task.

dsh plugin --profile web add github:karmiy/dsh-session-nav

Git-hosted plugins build on install. pnpm ≥10 blocks that prepare script until you allow it, so the first add fails with an allowBuilds hint. Copy the exact key into ~/.dsh/profiles/web/pnpm-workspace.yaml:

allowBuilds:
  dsh-session-nav: true

Then run the same add again and restart the web profile.

Pin a commit if you do not want a later push to change what runs:

dsh plugin --profile web add github:karmiy/dsh-session-nav#v0.1.0

Local checkout (after pnpm install):

dsh plugin --profile web add link:/absolute/path/to/dsh-session-nav

Find more community plugins under the dsh-plugin topic.

How it maps to the session

UISource
One tickA visible user, steering, command, or manual-compaction Chat Node in the loaded window, plus older human user/message events from session.history
Idle lengthShort dash; hover applies a Gaussian envelope around the pointer
Scroll markSlightly brighter dash nearest the upper third of [data-conversation-scroll] — not expanded
Worked for / bubble / file cardShown only while the pointer is on the rail
Worked forturn/start … turn/end (live while the turn is open)
BubbleText of that user / steering / slash-command message
File cardDiff / edit tool cards in the turn (locations + oldText / newText line counts)

Development

Requires Node ^22.19 || >=24. Keep a DeepSeek Harness checkout as a sibling if you want pnpm typecheck / pnpm build (they resolve host types through ../deepseek-harness). Unit tests and prepare do not need it.

../deepseek-harness
../dsh-session-nav
pnpm install
pnpm test
pnpm typecheck
pnpm build

prepare runs tsdown only — no typecheck — so dsh plugin add github:… can build on a machine that does not have the harness source.

Do not dsh plugin add against a profile that is currently running a task.

License

MIT

Back to searchOpen GitHub repository

More related plugins

View category