Back to directory

dsh-emacs

Maintenance: Active

vritser/dsh-emacs

An Emacs client for DeepSeek Harness

View on GitHub
$ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs

51

stars

7

forks

Emacs Lisp

Language

GPL-3.0

License

2026-08-23

Created

2026-11-05

Last push

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

  1. 01

    `git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs`

    $ git clone https://github.com/vritser/dsh-emacs.git ~/dsh-emacs

  2. 02

    Add `(add-to-list 'load-path (expand-file-name "~/dsh-emacs"))` to your Emacs configuration and evaluate it, or restart Emacs

  3. 03

    Add `(require 'dsh-emacs)`

  4. 04

    Run `M-x dsh-emacs` — it opens the session list and starts a local server if needed

  5. 05

    Configure a provider with `M-x dsh-emacs-add-provider`, or use `M-x dsh-emacs-open-web` for account sign-in

  6. 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

DSH integrationCompatible

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 configured
  • Streaming 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 model
  • Model 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-only
  • Server 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.
2026-08-232026-11-05v0.8.0

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.

08Data and sources

  • Author-claimedgithub.combc26985f2861…

    from Emacs: streaming replies, tool calls, workspace sessions, subagent chats, file attachments, and model selection. Re…

  • Author-claimedgithub.combc26985f2861…

    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.

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.