Windows Electron companion sharing the DSH Web profile, conversations and plugins, with startup logs, update recovery and diagnostics.
Install
# from GitHub (first run asks for allowBuilds approval — follow the hint, retry)
dsh plugin --profile web add github:CaT-Hode/DSH-app
Any plugin you install runs third-party code with your own permissions — it can read your files, use your credentials, and reach the network, and tool approvals don’t sandbox it. GitHub-sourced plugins also run build scripts at install time — pnpm blocks those until you allow them, so an install can stop with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED or ERR_PNPM_IGNORED_BUILDS; dsh prints the exact key to add under allowBuilds in your profile’s pnpm-workspace.yaml, and the install works on the next run. Allowing a build is a trust decision: only install sources you trust, and pin a commit (github:owner/repo#sha).
README
DSH App brings DSH conversations, projects, files and extensions into one workbench. Desktop and browser connect to the same web profile, keeping your existing models, sessions and compatible plugins. Open the right-hand workbench yourself, or let the agent in your current conversation control it.
This community plugin provides its own layout and Electron shell. Codex is an interaction design reference; DSH App does not depend on the Codex UI plugin and is not the official DeepSeek desktop client.
See it in action
One canvas. A workbench when you need it.
The floating sidebar holds outputs, session information and working content. Opening it leaves reading space for the conversation; hiding it recenters the text. New chats start with the workbench hidden. Files, previews and Side Chat share one tool launcher.

Plugin pages and settings, together
The left-rail … menu collects third-party extension pages. Separate settings open from a gear on the same row. A single-page plugin opens directly without a redundant settings button.

Skills and MCP belong to the workflow
Switch between Browse, Skills and MCP in one plugin center instead of searching through separate management plugins.

These GIFs show an earlier DSH App build on DSH 0.2.0-rc.2, using an isolated demo profile, sample workspace and locally prepared conversation. They contain no personal conversations or API keys. Side Chat shows an unsent draft; no model messages are sent. Pauses and playback timing are adjusted for clarity and are not a performance benchmark. The header is generated brand artwork; the GIFs show the actual interface.
Asset provenance and recording notes
What makes it different
Conversations and working content share a canvas
The navigation rail, project sidebar, title bar and Windows caption buttons share a background in light and dark mode. A fine divider with rounded corners separates the navigation buttons from the session list and workspace. The main pane reaches the right and bottom edges of the window. The whale welcome screen asks what to do in the selected project. With no project selected, it invites you to explore.
The composer starts compact in new and existing chats and grows as you type more lines. In an existing chat it leaves space above the bottom edge of the window. An empty, editable composer shows Work with DeepSeek Harness.
Files, previews and Git stay close to the conversation
Built-in tools include a file tree, search, uploads, ZIP downloads, CodeMirror editing, Markdown / Mermaid / HTML / web previews, Git changes and changes from the current AI turn. The Better Sidebar extension APIs remain available while its layout, start page and settings are redesigned. Working content restores with its conversation; the original sidebar plugin is not required.
Agents can put relevant content in front of you
Enable agent sidebar control to let the current agent open a file at a line, show a web page or extension tab, read tab state, switch content and hide the workbench. Commands bind to the calling conversation and receive client execution acknowledgements. Preparing a Side Chat draft and references never sends the message automatically.
// Open a file in the current workspace at a specific line
sidebar_open_view({ target: "src/main.ts", line: 20 })
// Prepare an editable review draft for the user
sidebar_open_view({
target: "sidechat", type: "tab", title: "Code review",
draft: "Please review the current changes",
context: [{ title: "Focus", text: "Check error handling and boundary cases" }]
})
| Agent tool | Purpose |
|---|---|
sidebar_open_view |
Open a file, folder, web page, DSH resource or registered tab |
sidebar_get_tabs |
Read actual tabs, available content, visibility and connection state |
sidebar_activate_tab |
Activate a tab and reveal the workbench |
sidebar_close_tab |
Close a tab |
sidebar_set_visibility |
Show or hide the workbench while retaining its contents |
See the integrated sidebar guide for complete behavior, acknowledgement states and extension interfaces.
Side Chat is a conversation you can keep using
Side Chat supports multiple conversations, history, renaming, independent drafts and context references. Reference a main-chat draft, selected text or an open file. Copy an answer, add it to the main-chat draft, or turn a completed side conversation into a continuing main conversation. Streaming responses, reasoning, tools, subagents, stopping and reconnection remain available.
Later main-chat messages are not automatically synchronized into an existing Side Chat. You review and send the draft and references. Open side conversations can restore after a refresh or restart.
Plugin compatibility goes beyond adding a button
Third-party settings.section and settings.plugins.tab registrations retain their native forms and controllers. Pages and settings with reliable ownership share one row without duplicate destinations. Single-page plugins have no gear; multiple settings pages offer a chooser. The menu follows plugin registration, disabling and unloading.
The built-in marketplace places official plugins first and labels their provenance, version and optional bundled status. Install, update and uninstall operations enter a cancellable queue, apply through the official CLI after restart, and retain backup and recovery records.
Skills, MCP and usage have clear destinations
| Area | What it provides |
|---|---|
| Skills | Browse, create, edit, enable and import skills; connect local and project libraries; recover deleted skills |
| MCP | Connections, catalogs, OAuth, custom servers, tool policies, project scope and backup restoration |
| Cost and usage | Official DeepSeek balance, a local usage ledger, token heatmaps, model prices, historical costs and budgets |
| Current-session insight | Context use and composition, request trends, tool latency, failures and compaction activity |
| Desktop maintenance | Single instance and tray, in-window startup logs, diagnostics, retry and backup-supported update recovery |
Skills and MCP remain in the plugin center. Cost and usage keeps its own entry instead of being duplicated in the third-party … menu.
The ring beside the model name brings the composer statistics into one place. Hover to see turns, steps, generation speed, total tokens, cache hit rate and context occupancy for the current conversation. Click it to open the conversation details in Cost and usage.
Quick start
Requirements
- Windows, Node.js 24+ and pnpm 11.
- DeepSeek Harness installed, with
dshavailable in your terminal. - DSH App 0.3.8 supports DSH 0.2.0-rc.2, 0.2.1-rc.2 and 0.2.2-rc.5. The desktop shell uses Electron 44.
- Read the migration notes first if you already use separate sidebar, Codex UI, marketplace, MCP or cost plugins.
1. Install into your Web profile
dsh plugin --profile web add 'git+https://github.com/CaT-Hode/DSH-app.git'
Use the GitHub source, or pass a Releases .tgz path to the same command. This project currently does not use an npm release as its installation source.
2. Activate it once
dsh --profile web --no-open
Wait for the Web service to become ready, then stop it with Ctrl+C. The plugin records the DSH launch entry point.
3. Open the desktop client
$dshData = if ($env:DSH_HOME) { $env:DSH_HOME } else { Join-Path $HOME '.dsh' }
& (Join-Path $dshData 'profiles\web\node_modules\.bin\dsh-app.cmd')
Use step three for subsequent launches. Configure a model in Settings → Models and add a working directory. Closing the window keeps it in the tray; quit completely through the tray menu or dsh-app --quit.
Install DSH App into my web profile using https://github.com/CaT-Hode/DSH-app and its README. Verify Node.js 24+, pnpm 11 and the DSH core version. Back up the profile, handle conflicting plugins using the migration table, and preserve models, conversations, MCP storage, skills and accounting data. Use the GitHub source, activate Web once, then open dsh-app.cmd. Do not delete the DSH data directory.
Plugin compatibility and migration
Upgrade to DSH 0.2.2
DSH App 0.3.8 supports the workspace interface in DSH 0.2.2-rc.5. A Skills refresh now reads the plugin inventory once. Back up the Web profile before upgrading and keep the existing model settings, conversations and plugin data.
Verified community plugin versions include IM Connect 1.0.46, Code Review 1.0.14 and Simplify 1.0.11. If @deepseek-ai/dsh-experimental-agent-team-profile is enabled, remove it from the enabled list during the upgrade. The DSH 0.2.2 base profile provides Agent Team.
Built-in features and predecessor plugins
These capabilities are integrated. Do not enable their original plugins in the same profile. Hiding a button can leave duplicate routes, services or listeners. Back up configuration and data before migrating; DSH App does not uninstall other plugins automatically.
| Integrated original plugin | Destination |
|---|---|
dsh-better-sidebar |
Right workbench: files, Git, previews and Side Chat |
@michengai/dsh-codex-ui |
DSH App navigation rail, project sidebar, header and conversation layout |
dshmarket |
Plugins → Browse |
dsh-mcp-connector |
Plugins → MCP |
dsh-cost-meter / dsh-context |
Cost and usage / current session |
@linxin666/dsh-client-ui-skill-explorer / @michengai/dsh-skills-manager |
Plugins → Skills |
Complete conflict and migration instructions · Licenses and attribution
Extensions checked in the installed client:
| Plugin | Verified scope |
|---|---|
@zzerx/dsh-plugin-notes 0.4.2 |
Page and same-row settings gear |
@linxin666/dsh-client-ui-task-board 0.4.4 |
Page, draft creation and deletion, disable and re-enable |
@linxin666/dsh-client-ui-git-graph 0.4.4 |
Real project branches and commit history |
dsh-image-gen 0.8.5 |
Native provider settings, single-page entry, disable and re-enable |
These records apply to specific versions, not the entire plugin ecosystem. Image generation was not requested, and Task Board checks did not execute model tasks.
FAQ
No. Both use the same conversations, models and plugin configuration when connected to the same backend and web profile. Open the current service in a browser from the header or tray menu.
Electron is an optional dependency; its first download needs network access. Check whether the package manager blocked its install script, or point DSH_APP_ELECTRON to a compatible electron.exe. Complete the initial Web activation before opening the desktop client.
New chats start with the workbench hidden. In an existing conversation, the upper-right list icon toggles it and + opens the tool launcher. Enable agent control in Settings → General → Workbench. Tools affect the calling conversation; disconnected commands wait for that conversation's view to reconnect.
Marketplace changes apply through a cancellable queue and restart. Disabling and uninstalling retain plugin data. Failed updates retain logs, queued operations and recovery backups. Updating the DSH core and migrating an old plugin are separate actions; a core rollback does not replace data migration.
The balance comes from the official DeepSeek account endpoint. Costs are local estimates based on configured model prices. Unpriced calls, estimated context composition and actual API tokens are labeled separately; character-based context estimates are not used for billing.
See the usage guide for navigation, configuration, diagnostics, updates and uninstalling.
Development and credits
client/ contains UI source, desktop/ the Electron shell, and lib/ Host services and integrated engines. npm run build generates the client and sandbox preload. Development setup and focused behavioral checks are documented in tests/README.md.
DSH App uses official DSH session, project, model, skill and connection services. The MCP engine is integrated from dsh-mcp-connector@0.2.63, and the sidebar engine from dsh-better-sidebar@0.24.1, retaining their licenses, provenance, hashes and modification records. Thanks to DeepSeek Harness and the community plugin authors.
Links
More in this category
zhu1090093659/dsh-web#packages/dsh-task-board★ 10562
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
zhu1090093659/dsh-web#packages/dsh-web-all★ 10562
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
ccch1mneyyy/dsh-TUI★ 8043
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
MeteorNOX/DeepSeek-Balance-Whale-Widget★ 7387
A fixed-corner whale widget for the DSH web GUI — balance, today's usage and per-turn cost with peak/off-peak pricing, editable balance-alert and daily-budget bubbles, a module-based custom bubble queue with A/B weighted choices and random lines or images, 30+ vendor templates (OpenAI, OpenRouter, Kimi, SiliconFlow, Ark, Zhipu, MiniMax and more) with per-model balance and subscription quota, plus task-end sound, imported audio, custom roles and a resource manager. Local-only, no telemetry.
omdsh-dev/DSH-better-sidebar★ 5269
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
omdsh-dev/dsh-genui★ 1040
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Community comments
Comments are public GitHub Discussions. Loading them connects to GitHub and Giscus; a GitHub account is required to post.