Skip to content

invalidnaaaame/dsh-scroll-timeline

31Last commit Aug 14, 2026

dsh-scroll-timeline DSH plugin

dsh-scroll-timeline adds a vertical node rail on the right edge of the chat sidebar, one horizontal bar per user message. It features a reading-position peak bar, magnetic mountain hover effect, hover preview cards, and smooth click-to-jump navigation. It auto-hides when fewer than 2 user messages are present.

How to install the dsh-scroll-timeline DSH plugin

dsh plugin --profile web add "github:invalidnaaaame/dsh-scroll-timeline#main

Copying does not run this command. Review the repository and version before installing the dsh-scroll-timeline DSH plugin.

dsh-scroll-timeline DSH plugin data source

dsh-scroll-timeline DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-scroll-timeline DSH plugin can do

  • Scroll timeline: vertical node rail on sidebar right edge, one bar per user message (3px tall, 14px hit area).
  • Reading position peak: the peak bar (39px brand blue) follows the current scroll position.
  • Magnetic mountain hover: while hovering over the rail, the nearest node becomes the peak and neighbors extend in progressive ratios (39/30/21/15/9).
  • Hover preview: hovering a node shows a message preview card (6-line clamp, aligned with official HoverCard look).
  • Click to jump: smooth-scrolls to the message and applies a brand-blue highlight ring.
  • Full history: always shows all historical nodes; long sessions scroll within the container.
  • Auto-hide: hidden when there are fewer than 2 user messages or outside the chat page.

Where the dsh-scroll-timeline DSH plugin fits

  • Quickly navigate long chat histories by scrolling through the timeline and clicking a node.
  • Preview message content without leaving the current scroll position using hover cards.
  • Visually track reading progress in a busy conversation with the peak bar indicator.

Who the dsh-scroll-timeline DSH plugin is for

  • Heavy chat users who frequently need to revisit earlier messages.
  • Users who prefer a visual timeline over traditional scrollbar for navigation in long conversations.

dsh-scroll-timeline DSH plugin limitations

  • Browser-only: the plugin only works in the web client (browser), not in the Node half.
  • Requires at least 2 user messages in the chat to become visible; it stays hidden otherwise.
  • Depends on the official anchor attribute `data-time-hover-root` (user rows since 0806); may break if DSH changes this contract.
  • No configuration UI; all customization is via CSS variables on the rail container.

dsh-scroll-timeline DSH plugin: from the repository README

Quoted from the invalidnaaaame/dsh-scroll-timeline README, the upstream source of the dsh-scroll-timeline DSH plugin. Copyright remains with the original authors.

An evenly spaced node rail on the right edge of the sidebar (one horizontal bar per user message) — the peak bar follows your reading position, hovering grows a magnetic "mountain" (design ratios 39/30/21/15/9; base and peak widths are adjustable via CSS variables), a hover preview card (6-line clamp), click-to-jump with smooth scrolling and a brand-blue highlight, full history always visible, and auto-hide when there are fewer than 2 user messages. Form factor: an official **bundle plugin** (`dsh.bundle` + dshClient channel, **browser-only**, empty Node half), 0 patches. > Derived from [vlln/dsh-navbar](https://github.com/vlln/dsh-navbar) (MIT, spec issue dsh-external/issues#144), with the interaction redesigned: horizontal bar nodes, magnetic mountain hover, sidebar-adjacent positioning, and full history. ## Preview ![dsh-scroll-timeline (left: reading-position peak bar; right: hover magnetic mountain)](docs/preview/navbar.png) ## Features | Feature | Description | |---|---| | Scroll timeline | Vertical node rail on the right edge of the sidebar, one horizontal bar per user message (3px tall, 14px hit area) | | Reading position | Peak bar (39px brand blue) follows the curren

Read the full READMERepository license: MIT

dsh-scroll-timeline DSH plugin questions

How do I install dsh-scroll-timeline?

Run the one-line git install command: `dsh plugin --profile web add "github:invalidnaaaame/dsh-scroll-timeline#main"`. After installation, restart the web client for the plugin to take effect. You can also clone the repo and run `dsh plugin --profile web add .` from the local directory.

Why is the scroll timeline not showing up?

The timeline only appears when there are at least 2 user messages in the current chat. It also auto-hides outside the chat page. Make sure you are in a conversation with enough messages. If it still doesn't appear, check that the plugin is enabled in Settings → Plugins.

Can I customize the width of the timeline bars?

Yes, you can adjust the base and peak widths via CSS variables on the rail container. For example, set `--dsh-navbar-base-w: 9px;` and `--dsh-navbar-peak-w: 39px;` in your custom styles. There is no built-in UI for this.

Does dsh-scroll-timeline work on mobile?

The plugin is browser-only and designed for desktop sidebar layout. It may not work well on mobile screens due to the narrow sidebar. The preview card may also be clipped on small screens.

How do I uninstall dsh-scroll-timeline?

Use the DSH plugin management command: `dsh plugin --profile web remove invalidnaaaame/dsh-scroll-timeline`. Alternatively, you can disable it in Settings → Plugins without uninstalling.