OpenTerminal for DeepSeek Harness

OpenTerminal for DeepSeek Harness adds an interactive terminal, a file manager, and OpenTerminal tools to every workspace in a DSH Web profile. It connects to an existing Open Terminal server without requiring MCP configuration.

Features

• Interactive terminal — a WebSocket-backed xterm.js terminal with scrollback.
• Floating window — the terminal opens above the chat, keeps the chat interactive, and closes only with the × button.
• Responsive layout — the window adapts to the browser viewport and uses the available screen area on narrow displays.
• File manager — browse directories, upload multiple files, download and delete files, edit text files, and preview images or PDFs.
• Agent tools — DSH agents can manage processes and work with files through the open_terminal_* tools.
• Profile-wide access — the sidebar button and tools are available in every workspace using the installed DSH profile.
• Protected credentials — the Open Terminal API key is stored in DSH Credentials and is not exposed to the browser.

Requirements

• DeepSeek Harness 0.1.1-rc.2, or a compatible version;
• Node.js ^22.19.0 or >=24;
• pnpm when building the package from source;
• a running Open Terminal server and its API key;
• a DSH Web profile, named web by default.

Build the installation package

From the plugin directory, install dependencies, validate the package, and create the tarball:

pnpm install
pnpm run check
pnpm pack

pnpm pack creates a file named from the package name and the version field in package.json:

dsh-open-terminal-<version>.tgz

To inspect the package contents without extracting it:

tar -tzf dsh-open-terminal-<version>.tgz

Install

Install the prebuilt package attached to the current GitHub release:

dsh plugin --profile web add "https://github.com/d3cker/dsh-open-terminal/releases/download/v0.1.4/dsh-open-terminal-0.1.4.tgz"

or with pnpm version:

pnpm dsh plugin --profile web add "https://github.com/d3cker/dsh-open-terminal/releases/download/v0.1.4/dsh-open-terminal-0.1.4.tgz"

Use the release asset named dsh-open-terminal-<version>.tgz. The repository URL and GitHub's automatically generated Source code archives contain source files and require permission to run build scripts during installation.

Restart the DSH Web profile, then refresh the browser. The plugin applies to all sessions and workspaces that use that profile. Install it separately for every additional DSH profile where it should be available.

To verify that the plugin is part of the profile configuration:

dsh --profile web --dump-config

The output should include:

- id: open-terminal
  name: dsh-open-terminal

Configure

1. Open Settings → Plugins → OpenTerminal in DSH Web.
2. Set the OpenTerminal URL. The packaged default is http://192.168.0.74:7000; replace it with the address of your server when necessary.
3. Leave the credential reference as OPEN_TERMINAL_API_KEY, or enter another DSH credential reference.
4. Enter the API key in the write-only API key field.
5. Optionally adjust the request timeout, tool-output limit, and upload/proxy body-size limit. The default upload limit is 8 MiB and the maximum is 64 MiB.
6. Click Save settings, followed by Test connection.

Open the settings page through a loopback DSH address such as http://127.0.0.1:3080. DSH does not allow a remote page to modify global settings or credentials.

Use the terminal

Click OpenTerminal in the left sidebar. The terminal opens in a floating window on the right side of the chat.

• Scroll the terminal with the mouse wheel or trackpad.
• Continue using the chat while the terminal is open.
• Switch between Terminal and Files without closing the window.
• Close the window with the × button in its top-right corner.

The window scales with the viewport. On narrow screens it uses the available screen area so the terminal and its controls remain accessible.

Use the file manager

Open the Files tab in the OpenTerminal window.

• Use Up to move to the parent directory.
• Use Refresh to reload the current directory.
• Use Upload… to select and upload one or more files.
• Select a file and click Download to save it locally.
• Select a text file to edit it, then click Save.
• Select an image or PDF to preview it.
• Click Delete and confirm the prompt to remove a file.

File operations are performed on the machine or container running Open Terminal, not on the machine running the browser.

Agent tools

DSH agents receive the open_terminal_* tools automatically. They can:

• list, start, inspect, interact with, and stop processes;
• list, read, write, replace, search, and inspect files.

No MCP server selection or separate MCP configuration is required.

Update

Run the installation command from the current README, then restart the DSH Web profile. The command points to the package attached to the corresponding GitHub release.

Uninstall

dsh plugin --profile web remove dsh-open-terminal

Restart the DSH Web profile after removing the plugin.

Security note

The Open Terminal API key allows command execution and file access on the Open Terminal server. Use a trusted, isolated server, keep DSH Web restricted to trusted users, and use TLS or a VPN when the connection crosses an untrusted network.

License

MIT