GPL-3.0 Emacs client for DeepSeek Harness that speaks the dsh server protocol directly — Recents-first session list, streaming transcripts with folding, @ references, slash commands and skills, attachments, subagents and a model/usage mode line — installable from a plain `load-path` entry with Emacs 28.1+.
DSH integration
Compatible
Author-claimed
Safety audit
Unaudited
Last verified
2026-11-18
License
GPL-3.0
01What can it help you accomplish?
Work a DeepSeek Harness session without leaving Emacs
A chat buffer with streaming replies, tool calls, folding, an editable draft, and the session list ordered Recents-first
Emacs users who already live in their editor and do not want a browser or a separate terminal UI
Attach workspace context and drive commands from the keyboard
`@` references to server-side files, directories and sessions, `TAB` completion for `/` commands and skills, staged attachments and local `!` shell commands
Developers running multi-file tasks where the agent needs explicit file and command context
Follow child conversations and long transcripts
`M-x dsh-emacs-list-subagents` for child conversations (continuable ones accept follow-up input, one-shot ones are read-only) plus paged history loading
Users running subagent-heavy workflows who need to inspect or continue a child task
02How to install into DeepSeek Harness
Prerequisites
- Emacs 28.1 or newer — no mandatory third-party Emacs packages
- A `dsh` CLI / server: `M-x dsh-emacs` offers to install the CLI when it is missing
- Development version (0.9.0, unreleased) targets dsh 0.2.2-rc.1; the last live E2E validation was dsh 0.2.1-rc.2 with dsh-emacs 0.8.0
Installation steps
- 01
`git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`
$ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs
- 02
Add `(add-to-list 'load-path (expand-file-name "~/dsh-emacs"))` to your Emacs configuration and evaluate it, or restart Emacs
- 03
Add `(require 'dsh-emacs)`
- 04
Run `M-x dsh-emacs` — it opens the session list and starts a local server if needed
- 05
Configure a provider with `M-x dsh-emacs-add-provider`, or use `M-x dsh-emacs-open-web` for account sign-in
- 06
Press `c` to create a session, `C-c C-m` to choose a model, type after `❯` and press `C-c C-c` to send
Verify the integration
Not specified by the author
03DSH integration and capability boundaries
Emacs client of the dsh server: the package runs inside Emacs, manages (or connects to) a local `dsh` server over its RPC protocol, and renders the session transcript in a normal Emacs buffer — it is not installed into a dsh profile.
Session list with Recents
an optional local project or chat context→the 15 most recently updated visible sessions with workspace labels, followed by their workspace groups
starts a local dsh server when none is configuredStreaming chat buffer with folding
a session or a new editable draft→streaming transcript with independently folding tool and thinking cards, activity summaries and `Completed…` groups
loads earlier rounds into the buffer on `C-c C-o`References, slash commands and attachments
`@` paths, `/` commands or skills, staged files and clipboard images→server-side file/directory/session references, completed commands and sent attachments
stages files from the machine running Emacsruns `!` shell commands locally in the session workspace without sending them to the modelModel and reasoning controls
a key press in the chat buffer→model selection (`C-c C-m`) and a reasoning-effort change (`C-c C-e`), with the active model on the mode line
Subagent and question handling
an agent question or a subagent list request→minibuffer completion for agent questions (comma-separated multiple choice) and a child-conversation list
continuable children accept follow-up input, one-shot children stay read-onlyServer management and source reload
`dsh-emacs-base-url` / `dsh-emacs-server-auto-start` settings, or an edited source tree→a managed local server, a connection to an external server, or a live reload that preserves chats and drafts
`M-x dsh-emacs-reload` re-evaluates the package inside the running Emacs
04Who is it for? When not to use it?
Good for
- Emacs users who already live in their editor and do not want a browser or a separate terminal UI
- Developers running multi-file tasks where the agent needs explicit file and command context
- Users running subagent-heavy workflows who need to inspect or continue a child task
Not for
- Requires Emacs 28.1+ and a dsh server; the development version targets dsh 0.2.2-rc.1 and the last live E2E validation (dsh 0.2.1-rc.2 with dsh-emacs 0.8.0) does not validate that new baseline.
- Remote addresses, including HTTPS, never trigger a local server start, and authentication is automatic only for servers dsh-emacs started — an external server needs its launch token or `dsh-emacs-server-auth-token`.
- Upgrading live 0.8.0 connections requires disconnecting and reconnecting, and removed definitions or changed struct layouts require a restart rather than a reload.
05Compatibility, maintenance and safety notes
- Requires Emacs 28.1+ and a dsh server; the development version targets dsh 0.2.2-rc.1 and the last live E2E validation (dsh 0.2.1-rc.2 with dsh-emacs 0.8.0) does not validate that new baseline.
- Remote addresses, including HTTPS, never trigger a local server start, and authentication is automatic only for servers dsh-emacs started — an external server needs its launch token or `dsh-emacs-server-auth-token`.
- Upgrading live 0.8.0 connections requires disconnecting and reconnecting, and removed definitions or changed struct layouts require a restart rather than a reload.
- Several options and helpers were removed without aliases (0.7.0 dropped `dsh-emacs-group-consecutive-tools` and `dsh-emacs-assistant-divider`), so personal configuration must be cleaned up after upgrading.
GPL-3.0 · README branch main · latest release v0.8.0 (2026-11-04)
06Frequently asked questions
How do I install dsh-emacs into Emacs?
Clone it (`git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`), add the directory to `load-path` and `(require 'dsh-emacs)`, then evaluate or restart Emacs. Run `M-x dsh-emacs`: it opens the session list and starts a local server if needed, offering to install the dsh CLI when it is missing.
Which DSH and Emacs versions does it target?
The development version (0.9.0, unreleased) targets dsh 0.2.2-rc.1 and requires Emacs 28.1+ with no mandatory third-party packages. The last live end-to-end validation used dsh 0.2.1-rc.2 with dsh-emacs 0.8.0, so that run does not validate the new baseline.
Do I need to run a dsh server myself?
No — by default dsh-emacs manages a local server. For a server you run yourself, set `dsh-emacs-base-url` and `dsh-emacs-server-auto-start` to nil; remote addresses, including HTTPS, never trigger a local server start, and authentication is automatic only for servers dsh-emacs started.
Where do credentials live?
On the dsh server. You configure a provider with `M-x dsh-emacs-add-provider`, or use `M-x dsh-emacs-open-web` for account sign-in; credentials and model settings stay on the dsh server, not in Emacs.
How do I upgrade or reload it?
`M-x dsh-emacs-reload` reloads edited source while preserving chats and drafts, but upgrading live 0.8.0 connections requires disconnecting and reconnecting, and removed definitions or changed struct layouts require a restart.
07Related DSH workflows
dsh-oil-creator
by oil-oil
AI-assisted local creator workbench for DeepSeek Harness
dsh-novel-writer
by akira399
网络小说创作插件:九阶段门禁式创作流程 + 世界书设定注入 + 本地书籍导入 + AI 一键润色 + 去 AI 味。
dsh-multica-runtime
by multica-ai
Support dsh runtime on Multica.
dsh-plugin-radar
by adamplatin123
An ecosystem radar for the DeepSeek Harness (dsh) plugin community that auto-discovers thousands of candidate plugins and runs continuous k8s-level validation, publishing the results as a browsable plugin catalog.
08Data and sources
from Emacs: streaming replies, tool calls, workspace sessions, subagent chats, file attachments, and model selection. Re…
3. Run `M-x dsh-emacs`.
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-11-18. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.
