dsh-better-sidebar: A Feature-Rich Sidebar Workspace for DeepSeek Harness
omdsh-dev/dsh-better-sidebar
A sidebar framework for DSH plugin with built-in file, terminal, Git workspace, and open services for third-party tabs.
dsh-better-sidebar is a UI plugin for DeepSeek Harness, offering out-of-the-box sidebar capabilities like file management, embedded browser, real terminal, and Git panel, with a service-oriented base for third-party extensions.
dsh plugin --profile web add github:omdsh-dev/dsh-better-sidebar- Category
- UI & Experience
- Platform
- DSH-Plugin
- Author
- omdsh-dev
- Distribution
- Plugin
dsh-better-sidebar Key Features
dsh-better-sidebar Repository
dsh-better-sidebar Repo Summary
dsh-better-sidebar is a UI plugin (DSH plugin) for DeepSeek Harness, maintained by omdsh-dev under the MIT license. It is a service-oriented sidebar framework that addresses the limited sidebar capabilities and poor extensibility of the default DSH interface. It provides a dual workspace with a right sidebar and bottom panel, featuring built-in file management, edit preview, embedded browser, real terminal, Git panel, background tasks, and more. Through the open ctx.betterSidebar service, third-party plugins can register new sidebar pages and file viewers with equal capabilities. Developed in TypeScript, it was last updated in 2026-08 and supports real-time language switching (zh/en).
What core features does the dsh-better-sidebar DSH plugin support?
- File workspace: Resource manager (lazy-loaded directory tree) + CodeMirror editor, with inline preview for images, Markdown, HTML, PDF, and Office files.
- Embedded browser: Multiple web tabs with back/forward/refresh, content runs in a sandboxed iframe, and external links are routed by protocol (HTTP opens in the sidebar, HTTPS goes to the system browser, adjustable in settings).
- Real terminal: A real shell based on xterm.js + node-pty, with reconnection replay, and optional injection of
terminal_*tools for the model. - Git panel: True diff with VSCode-style diff tabs, history, and right-click staging/commit/revert.
- Background tasks page: Subagent topology + background tasks (exit codes, live output, force termination).
- Dual workspace: Right sidebar + bottom panel; drag tabs to split/merge columns (cross-panel), auto-merge to full-width drawer on mobile.
- Session isolation: Layout/tabs/panels persist per session, with automatic cleanup of stale state.
- Declarative settings: Settings page with independent toggles for each sidebar card, secondary settings via gear popup.
- On-demand loading: Only ~325KB core is loaded at startup; heavy dependencies like terminal/editor are fetched on demand.
How to install dsh-better-sidebar?
Prerequisites: DSH installed (dsh web works), Node.js ≥ 20, pnpm ≥ 10. Installation command:
dsh plugin --profile web add github:omdsh-dev/dsh-better-sidebar
How does dsh-better-sidebar extend via the service-oriented base?
The plugin follows a service-first philosophy: the built-in 7 tabs + 6 viewers and third-party plugins register through the same ctx.betterSidebar API, with equal capabilities. The service base provides complete type exports, capability detection (version/features), state subscription (getSnapshot/subscribeState), tab badges, lifecycle callbacks (onOpen/onActivate/onClose), updateTab/activateTab/openFile, targeted opening, meta persistence across refreshes, plugin-specific settings (pluginToggles/render), and external link click target claiming (urlTarget). Third-party plugins can deeply integrate to implement custom sidebar pages and file viewers.
Which DeepSeek Harness versions and platforms are compatible with dsh-better-sidebar?
This plugin targets the DeepSeek Harness ecosystem, depending on multiple official packages (e.g., @deepseek-ai/dsh-client-web-react, @deepseek-ai/dsh-host-webserver, etc.). It supports macOS, Linux, and Windows (Git Bash/WSL or PowerShell). The UI text follows the DSH language (zh/en) in real time. The latest update (v0.12.2) added a "position compatibility mode" that reserves top space for the native Windows title bar, shifting the sidebar down by a customizable distance (0–120px) via the gear popup.