relay-dsh-plugin-terminal

Relay DSH Terminal Plugin

Now supports DSH 0.1.2-rc.1 while retaining 0.1.2-alpha.3 compatibility. Plugin 0.2.2 is verified on both releases. Install it from npm · Compatibility evidence.

Release channels: latest → 0.2.2; next → 0.2.1-rc.1.

npx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@0.2.2 relay-dsh-plugin-terminal@0.2.2 relay-dsh-plugin-codex@0.2.2
npx @deepseek-ai/dsh@0.1.2-rc.1 web

English | 中文

npm package: relay-dsh-plugin-terminal · All Relay DSH plugins

Real npm-installed demo on official DSH: Terminal starts a live workspace shell and executes a command below the conversation. Watch the H.264 MP4.

relay-dsh-plugin-terminal adds an xterm-based bottom terminal panel to the official DeepSeek Harness (DSH) Web UI. It provides the browser terminal surface, bounded scrollback, and a public provider registry for execution backends.

The plugin uses relay-dsh-plugin-workbench as its panel host. Install Workbench in the same DSH Profile.

The screenshot was captured from official DSH 0.1.1-rc.2 with Workbench, Files, and Terminal installed. Terminal can load without a provider and shows a clear provider-unavailable state; install a compatible backend when you want a live shell.

Do I Need This Plugin?

Install this plugin when you want to:

• add a terminal panel to official DSH Web through the plugin system;
• use a compatible execution backend, such as relay-dsh-plugin-codex, as the terminal transport;
• develop another backend that contributes terminal sessions through the public ctx.relayTerminalProviders registry.

Terminal is provider-neutral. If you install only this package, DSH can load the panel but cannot start a live shell until another plugin registers a terminal provider.

Quick Start With Official DSH

The current development build has been validated with:

• DeepSeek Harness 0.1.1-rc.2, commit b150a551
• Node.js 22.13 or newer
• pnpm available on PATH

DSH is a developer preview and may introduce compatibility-breaking changes.

1. Install

Stop a running DSH Web process before changing Profile plugins.

GitHub development build

Use this when you want the latest unreleased development build:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main github:yangbobo2021/relay-dsh-plugin-terminal#main

For an interactive terminal through Codex, install both development plugins:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add github:yangbobo2021/relay-dsh-plugin-workbench#main github:yangbobo2021/relay-dsh-plugin-terminal#main github:yangbobo2021/relay-dsh-plugin-codex#main

For a reproducible install, replace each #main with a tag or full commit SHA. The Workbench package is listed explicitly because DSH's pnpm profile blocks GitHub packages as transitive dependencies.

npm release

Install the published packages with:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-terminal@latest

For an interactive terminal through a published Codex plugin:

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 plugin --profile web add relay-dsh-plugin-workbench@latest relay-dsh-plugin-terminal@latest relay-dsh-plugin-codex@next

2. Start or restart DSH Web

pnpm dlx @deepseek-ai/dsh@0.1.2-rc.1 web

If you already have a dsh command installed, dsh web is equivalent. Restart DSH Web after installing, updating, or removing plugins.

3. Open the terminal panel

In DSH Web:

• Open the DSH URL printed by the terminal.
• Complete the first-launch screen if DSH shows one.
• Create or select a conversation that has a workspace directory.
• Open the Workbench bottom panel and choose Terminal.
• Start a terminal session.

If no compatible terminal provider is installed, the panel reports that no interactive terminal provider is available.

What It Provides

• A Terminal view in the Workbench bottom panel
• An xterm-based browser terminal surface
• Bounded scrollback on the Host side
• A versioned ctx.relayTerminalProviders registry
• Provider-neutral spawn, input, resize, output, and termination wiring
• Composition with the shared Workbench shell

This package does not spawn shells by itself. Shell execution is supplied by a provider plugin, currently including the Relay Codex DSH plugin.

Manual terminal permissions

With the Codex provider, each user-operated terminal explicitly requests sandboxPolicy: { type: "dangerFullAccess" } for its shell. This allows ordinary SSH connections and user-file writes without changing the shared Codex server configuration or any Agent conversation's sandbox or approval policy. It does not grant administrator privileges or bypass operating-system permissions.

Terminal access is equivalent to command execution as the DSH host user. Expose it only through trusted, authenticated access; a session ID is not an authentication credential. Do not expose this manual-terminal capability as an Agent tool. If the provider rejects the requested policy, startup fails without retrying with a different policy.

Plugin Boundary and Relay

This plugin owns only terminal presentation and provider registration. It does not depend on Claude, Relay Events, or any private Relay runtime. Codex is an optional provider plugin, not a hard dependency of Terminal.

The repository is maintained as part of Relay, an open-source project for long-running agent work, external-event delivery, reusable DSH workbench views, and multiple conversation backends.

Update, Inspect, or Remove

Stop DSH Web before changing plugins, then restart it afterward.

dsh plugin --profile web why relay-dsh-plugin-terminal
dsh plugin --profile web update relay-dsh-plugin-terminal
dsh plugin --profile web remove relay-dsh-plugin-terminal

For GitHub installs, pnpm records the package source inside the DSH Profile. Run dsh plugin --profile web why relay-dsh-plugin-terminal to inspect it.

Troubleshooting

The Terminal panel does not appear

Restart DSH Web after installing the plugin. Then inspect the Profile:

dsh plugin --profile web why relay-dsh-plugin-terminal

If the package came from GitHub main, try pinning a known commit SHA.

The panel says no interactive terminal provider is installed

This means Terminal loaded correctly, but no backend plugin registered a PTY provider. Install a compatible provider such as relay-dsh-plugin-codex.

A terminal cannot start because no workspace is available

Create or select a DSH conversation that has a workspace directory. Terminal sessions start inside the active workspace.

SSH reports "Operation not permitted" although a system terminal connects

Older plugin builds omitted the shell's sandbox policy and inherited the Codex server's default restrictions. Update the plugin, restart DSH Web, and create a new terminal. Existing shell processes retain the permissions they started with. If the error remains, check the host application's operating-system network permissions and any administrator-managed restrictions.

Installation says pnpm is missing

Install pnpm using the official guide: https://pnpm.io/installation.

Development

git clone https://github.com/yangbobo2021/relay-dsh-plugin-terminal.git
cd relay-dsh-plugin-terminal
npm install
DSH_ROOT=/path/to/deepseek-harness npm run verify
npm pack

npm run verify runs type checking, tests, and the production build against an official DSH checkout.

Feedback

Report bugs and feature requests in this repository's issue tracker: https://github.com/yangbobo2021/relay-dsh-plugin-terminal/issues