Preface

Backtracking requirements in long conversations often requires extensive scrolling. The native scroll bar forces you to guess positions and scroll repeatedly. dsh-turnbar provides a video-style timeline for the DeepSeek Harness chat interface: hover preview, drag seeking, and ⌘K search.

Plugin Overview

dsh-turnbar is a plugin that provides a progress bar for agentic conversations. It is included in the DeepSeek Harness Web configuration file and is designed to solve navigation issues in long sessions.

Core Features

The plugin provides the following features:

  • Full-map progress bar: Each turn is a segment, and the playhead highlights the segment you are currently reading.
  • Hover preview card: View turn content, tool call count, file edits, and token usage.
  • In-conversation search: Open via the magnifier button or ⌘K, search all content, and matching turns are highlighted on the bar chart.
  • Context fuel table: Displays context window usage, with color-coded warnings when exceeding 80%/95%.
  • Chapter ticks: Turns marked with /goal are displayed as ticks.
  • Trajectory view jump: ⌘/Alt + click to jump to the Trajectory view.
  • Click / drag seek: Click to jump or drag like a video timeline.
  • ⌘↑ / ⌘↓ navigation: Jump between turns, automatically skipping empty turns.
  • Esc return: Press Esc after jumping to return to the original position.
  • Graceful degradation: Hides itself when the API changes, without breaking the session.

Installation and Enablement

Install it with the following command:

dsh plugin --profile web add dsh-turnbar

After installation is complete, restart DeepSeek Harness.

Usage Examples

After installation, the progress bar automatically backfills historical sessions. You can:

  • Click the bar chart to jump to a specific turn.
  • Drag the bar chart for quick browsing.
  • Use ⌘K to search keywords; matching turns will glow.
  • Hover to view context usage.

Environment and Notes

Check the environment dependencies before use:

  • Requires DeepSeek Harness >= 0.1.0-rc.5
  • Requires Node >= 22.19.0
  • Requires @deepseek-ai/cordis >= 4.0.1

Feature limitations:

  • Cross-conversation search and bookmarks are handled by dsh-milestone.
  • Trajectory view jump is shared with dsh-chat-outline.

Conclusion

dsh-turnbar provides a video-style navigation experience, suitable for users who need to frequently locate content in long conversations. For more information, visit GitHub or Skill Catalog.