deepseekplugins

DeepSeek Harness plugin

dsh-plugin-terminal-mervyn-teo

DSH Web plugin: a real PTY terminal in a VS Code-style collapsible footer panel (host PTY + WebSocket + xterm.js)

Development & Runtime
Jump to install

Source facts

Repository
mervyn-teo/dsh-plugin-terminal
Latest update
Aug 20, 2026
Category
Development & Runtime
GitHub stars
3
Format
plugin
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/mervyn-teo/dsh-plugin-terminal
Plugin: dsh-plugin-terminal-mervyn-teo
Author: mervyn-teo

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer4 files
README.mdSource · read only
README language

dsh-plugin-terminal

<p align="center"> <a href="https://github.com/mervyn-teo/dsh-plugin-terminal"> <img src="assets/banner.png" alt="dsh-plugin-terminal banner — a real PTY terminal in the DeepSeek Harness footer" width="100%"> </a> </p>

English | 中文

A DeepSeek Harness (DSH) Web plugin that adds a real interactive terminal — a VS Code-style collapsible panel docked to the footer. This plugin runs an actual shell in a PTY and streams the raw terminal bytes to the browser. It is a persistent bundle plugin (a host half plus a browser half) that loads on every boot.

Demo

<p align="center"> <img src="assets/demo.gif" alt="dsh-plugin-terminal demo — a real terminal in the footer" width="640"> </p>

What it does

  • Actual terminal — a real interactive shell (PowerShell on Windows,

$SHELL//bin/bash elsewhere, by default) running in a PTY via the harness's subprocess.spawnTerminal primitive (node-pty).

  • Full terminal rendering — xterm.js renders ANSI colors, cursor movement,

full-screen apps (vim, htop, top, …), and 256-color output.

  • VS Code-style footer panel — a collapsible bottom panel with a header,

drag-to-resize top edge, restart button, and collapse toggle.

  • Keyboard shortcut — Ctrl+ ` toggles the panel (the VS Code default).
  • Live resize — the PTY reflows when you resize the panel.
  • A Terminal settings card under Settings → Plugins configures theme, font

size, panel height, opacity, start-collapsed, shell, and working directory at runtime.

  • Graceful fallback — if xterm.js cannot load (offline), a plain streaming

view still exposes the real shell.

Files

FilePurpose
lib/index.jsHost half — spawns the PTY and bridges it over the /api/terminal WebSocket.
lib/client.jsBrowser half — the footer panel and the settings card.
cordis.patch.ymlComposition patch that inserts the plugin row.
package.jsonPackage metadata (dsh.bundle + dsh.client manifest).

Install

dsh plugin --profile web add github:mervyn-teo/dsh-plugin-terminal

Then restart dsh web — host bundles load at boot.

Defaults live in cordis.patch.yml. Change them there (or in the profile's own cordis.patch.yml) and restart, or adjust them at runtime from the settings card. The host half serves two same-origin routes the browser half uses:

GET|POST /api/terminal/config and the /api/terminal WebSocket upgrade.

Requirements

  • DSH with the subprocess and webServer services mounted.
  • Network access to jsDelivr the first time the terminal renders xterm.js

(the plain fallback works without it).

Settings

Settings → Plugins → Terminal exposes:

SettingDescription
Themedark or light terminal theme (applied live).
Font sizeTerminal font size in pixels (applied live).
Max heightMaximum panel height in pixels.
OpacityTerminal background opacity 0–100% (100 = fully opaque).
Start collapsedWhether the panel starts collapsed.
ShellShell executable for new sessions.
Working directoryDefault directory for new sessions (empty = home directory).

Shell and working directory apply the next time you open the terminal; theme, opacity, font size, and max height apply immediately.

Notes and limitations

  • The terminal renders xterm.js from the jsDelivr CDN; the first expansion

requires network access. The plain fallback still works offline.

  • A session is process-local and does not survive a harness restart.
  • The WebSocket route is loopback-bound like the rest of the Web GUI.
  • Windows — on Windows the default shell is powershell.exe (set shell to

cmd.exe for Command Prompt, with shellArgs: []). It needs a Windows-built node-pty (conpty/winpty) from the DSH host.

License

[MIT](LICENSE)

Back to searchOpen GitHub repository

More related plugins

View category