Back to directory

dsh-better-sidebar

Curated pickMaintenance: Active

omdsh-dev/dsh-better-sidebar

Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.

View on GitHub
$ dsh plugin --profile web add dsh-better-sidebar@latest

3,461

stars

310

forks

TypeScript

Language

MIT

License

2026-08-07

Created

2026-09-09

Last push

MIT-licensed, service-first sidebar framework for DeepSeek Harness — installs natively into the DSH web profile via the official dsh plugin CLI, shipping a file workbench, real terminal, Git panel and an extension API for third-party tabs.

DSH integration

Native runtime

Author-claimed

Safety audit

Unaudited

Last verified

2026-08-21

License

MIT

01What can it help you accomplish?

  • Turn the DeepSeek Harness web UI into a full IDE-style workbench: files, terminal, Git and subagents in a sidebar

    Right sidebar + bottom panel dual workbench with 7 built-in tabs: file explorer + CodeMirror editor with inline image / Markdown / HTML / PDF preview, embedded browser, real terminal, Git panel, background tasks and a plugin directory

    DeepSeek Harness (dsh web) users who want an IDE-grade sidebar UI without leaving the harness

  • Extend the DSH sidebar with custom tabs and file viewers from other plugins

    New sidebar pages and file previewers registered through the `ctx.betterSidebar` service (`registerTab` / `registerFileViewer`), with the same API the built-in 7 tabs + 6 viewers use

    DSH plugin developers building UI panels on top of a shared sidebar foundation

02How to install into DeepSeek Harness

Prerequisites

  • DSH installed and running (`dsh web` works)
  • Node.js ≥ 20 and pnpm ≥ 10
  • DSH 0.1.0-rc.8 — this release pins all `@deepseek-ai/*` dependencies to `^0.1.0-rc.8`; rc.7 and earlier cannot resolve the dependencies

Installation steps

  1. 01

    Run `dsh plugin --profile web add dsh-better-sidebar@latest`

    $ dsh plugin --profile web add dsh-better-sidebar@latest

  2. 02

    Hard-refresh the browser (Cmd/Ctrl+Shift+R) to load the sidebar — DSH hot-loads client changes, so no restart is needed unless the host half updates

Verify the integration

  • Hard-refresh the browser (Cmd/Ctrl+Shift+R); the sidebar workbench appears in the DSH web UI

03DSH integration and capability boundaries

DSH integrationNative runtime

Native DSH web-profile plugin installed via the official `dsh plugin --profile web add` command, organized per the official DSH plugin spec (host/client dual-half, dual client bundles)

  • File workbench with inline preview

    workspace fileslazy-loading directory tree + CodeMirror editor; inline preview for images, Markdown (Mermaid with strict safe rendering), HTML and PDF; drag-and-drop file/folder upload

    saves go through atomic `fs.write`; uploads write files into the workspace (media/preview routes are limited to the session cwd)
  • Real terminal (xterm.js + node-pty)

    shell configuration (shell / shellArgs settable in the settings page or cordis.patch.yml)real shell with disconnect-reconnect replay; optional `terminal_*` tools injected for the model

    spawns real shell processes on the host; optionally exposes terminal tools to the model
  • Service-first extension API (ctx.betterSidebar)

    third-party DSH plugins injecting the `betterSidebar` servicecustom sidebar tabs and file viewers registered via `registerTab` / `registerFileViewer`

  • Git panel + session-isolated dual workbench

    the session's git repository and open tabsreal diff with VSCode-style diff tabs, history, right-click stage / commit / restore; layout, tabs and panels persisted per session

    invokes the git CLI (stage/commit/restore) but never sets git identity

04Who is it for? When not to use it?

Good for

  • DeepSeek Harness (dsh web) users who want an IDE-grade sidebar UI without leaving the harness
  • DSH plugin developers building UI panels on top of a shared sidebar foundation

Not for

  • The current release requires DSH 0.1.0-rc.8 — all `@deepseek-ai/*` peer/dev dependencies are pinned to `^0.1.0-rc.8`, and DSH rc.7 or earlier cannot resolve the dependencies (upgrade DSH first).
  • The real terminal depends on node-pty prebuilt binaries; if your Node version has no prebuild (common on Windows), a compile toolchain such as VS Build Tools is required.

05Compatibility, maintenance and safety notes

  • The current release requires DSH 0.1.0-rc.8 — all `@deepseek-ai/*` peer/dev dependencies are pinned to `^0.1.0-rc.8`, and DSH rc.7 or earlier cannot resolve the dependencies (upgrade DSH first).
  • Git integration has no push/pull/fetch, there is no file watcher (manual refresh needed), and inline file-open buttons in tool output cannot be intercepted.
  • The real terminal depends on node-pty prebuilt binaries; if your Node version has no prebuild (common on Windows), a compile toolchain such as VS Build Tools is required.
2026-08-072026-08-19v0.14.0

MIT · actively maintained (latest release v0.14.0, 2026-08-19)

06Frequently asked questions

How do I install dsh-better-sidebar in DeepSeek Harness?

With DSH running (`dsh web`), execute `dsh plugin --profile web add dsh-better-sidebar@latest`, then hard-refresh the browser (Cmd/Ctrl+Shift+R) to see the sidebar. DSH hot-loads client changes, so no restart is needed unless the host half updates. Prerequisites: Node.js ≥ 20 and pnpm ≥ 10.

Is it a native DSH plugin or an MCP server?

It's a native DSH plugin organized per the official DSH plugin spec (no default export, dual client bundles) and installed into the web profile through the official `dsh plugin` CLI — not MCP. Runtime `@deepseek-ai/*` modules are provided by the web profile.

Which DSH version do I need?

The current release targets DSH 0.1.0-rc.8: all `@deepseek-ai/*` dependencies are pinned to `^0.1.0-rc.8`. DSH rc.7 or earlier cannot resolve the dependencies, so upgrade DSH first.

Can other plugins add sidebar pages?

Yes. Since v0.4.0 the plugin exposes a `ctx.betterSidebar` service; other plugins register sidebar tabs and file viewers via `registerTab` / `registerFileViewer`, using the same API as the built-in 7 tabs and 6 viewers.

What are the known limitations?

Git has no push/pull/fetch, and there is no file watcher (manual refresh). The real terminal depends on node-pty — on Windows, a build toolchain (VS Build Tools) may be needed if no prebuilt binary exists for your Node version.

08Data and sources

  • Author-claimedgithub.com50a888845fc6…

    dsh plugin --profile web add dsh-better-sidebar@latest

  • Author-claimedgithub.com50a888845fc6…

    插件按 DSH 官方规范组织(无 default 导出、双 client bundle),运行期不依赖 npm / checkout(`@deepseek-ai/*` 由 web profile 提供)。

This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-21. Found an error? Submit a correction.

🏆

Best DeepSeek Harness Plugins

Twelve plugins worth installing first — picked from the whole catalog, across every category.

DSH Plugins is an independent community directory of DeepSeek Harness plugins. Not affiliated with or endorsed by DeepSeek. Third-party plugins are not security-audited — review the source before installing.

New DeepSeek Harness plugins, weekly. No spam.