DSH Plugins Marketplace

DSH Plugins

Plugins

/

UI & Experience

/

dsh-oh-my-terminal

d

dsh-oh-my-terminal

Manifest valid★ 1

Bottom terminal panel for the DSH Web GUI, providing multi-tab interactive terminals powered by node-pty (Windows ConPTY / POSIX openpty) with split panes, a side terminal list, and a dropdown new/spl

UI (client)hasBundlePatch

dsh-oh-my-terminal

version license node

A bottom terminal panel plugin for DSH Web GUI. Powered by @lydell/node-pty, it provides multi-session interactive terminals over WebSocket using xterm.js in the browser. Supports Windows ConPTY and POSIX openpty with no local compilation required.

中文文档

Features

  • Multiple terminal sessions: manage several sessions simultaneously; a side list replaces the traditional horizontal tab bar, with right-click rename support
  • Split terminals: horizontal splits within the same group; a VSCode-style dropdown next to the + button (new / split / new by kind)
  • Session persistence: sessions survive panel close/reopen and are automatically restored on startup
  • Configurable shortcut: toggle the panel with a keyboard shortcut; integrates with the host shortcut system and the panel label updates to reflect the current binding
  • Resizable panel: drag the top edge of the panel to adjust its height
  • Cross-platform: Windows ConPTY and POSIX openpty are selected automatically by @lydell/node-pty; pre-compiled binaries ship with the package, nothing to compile
  • Profile-driven terminals: a configurable terminal profile table (type / name / path) drives new-terminal creation; profiles are auto-detected at startup and can be added, renamed, and edited in the settings UI
  • Configurable fonts: font family, size, and line height are adjustable and hot-reload on open terminals
  • DSH-better-sidebar compatibility: auto-detects DSH-better-sidebar at runtime and switches to compat mode — registers a "Terminal" tab in its bottom workbench instead of the standalone dock; PTY sessions are not bound to the DSH session write handle, eliminating conflicts with DSH-better-sidebar's own terminal. When the host supports TabDescriptor.rightActions (v0.25.0+), the terminal's action buttons (new / split / restart) are injected into the tab strip's right end, VSCode-style; otherwise it falls back to a header row inside the tab content area

Installation

This package is not yet published to npm. Install directly from GitHub:

dsh plugin --profile web add github:btsd321/dsh-oh-my-terminal

Configuration

OptionDescriptionDefault
toggleShortcutShortcut to toggle the terminal panel (legacy host only; see below)Ctrl+Shift+`
fontFamilyTerminal font family (CSS font-family string); empty = built-in default stack with CJK fallback''
fontSizeTerminal font size in pixels12.5
lineHeightTerminal line height multiplier1.25
terminalProfilesTerminal profile table (JSON array); empty = use auto-detected $PATH terminals''

Terminal profiles

The terminal profile table is a JSON array of { id, type, name, path, origin } entries:

  • type: determines spawn semantics — pwsh / powershell / cmd / bash / zsh / fish / gitbash / nushell / custom
  • name: display name shown in the dropdown menu (user-editable)
  • path: executable path; empty = resolve by type in $PATH
  • origin: auto (startup-detected) or user (manually added)

Auto-detected profiles (origin: auto) cannot be deleted and their path is read-only, but the name is always editable. The profile table is editable in the settings UI with inline editing, add-row, and delete support.

Development

# Install dependencies (@lydell/node-pty ships pre-compiled binaries — ready to use immediately)
pnpm install

# Type check
pnpm run typecheck

# Build (esbuild, two entry points, output to lib/)
pnpm run build

# Unit tests
pnpm exec tsx --test tests/unit/*.test.ts

Use pnpm, not npm. Peer dependencies pin exact versions; npm's incremental resolution on an existing tree will produce ERESOLVE errors.

About the build output

lib/ is committed to version control. The DSH loader imports plugins as plain ESM; it does not run tsx. This repo also declares no lifecycle scripts (prepare, postinstall, etc.) because pnpm 11 rejects git-hosted packages that declare install-time scripts with ERR_PNPM_GIT_DEP_PREPARE_NOT_ALLOWED. Run pnpm run build manually and commit the output alongside source.

Native dependency notes

Terminal capability comes from @lydell/node-pty (a pre-compiled distribution of microsoft/node-pty with the same API), pinned exactly to 1.1.0. The ^ range is intentionally omitted: the package's dist-tags.latest points at the 1.2.0-beta series.

It is an N-API package. Binaries are split into six platform sub-packages and shipped inside the tarball; no download or compilation happens at install time. A single binary supports both Node 22 and Node 24. Its package.json has no scripts field at all, so pnpm 10, 11, and 12 never enter the build-authorization path, giving consistent behavior across versions.

The host side lazy-loads the package (await import() on first session creation). If the native binding fails to load, the error is contained to session creation; the plugin module itself remains importable and all other routes stay available.

Architecture overview

src/
├── index.ts              # Host entry (Cordis plugin + settings + session lifecycle)
├── routes.ts             # HTTP route handlers
├── ws-handler.ts         # WebSocket handler (pty data forwarding)
├── client.tsx            # Browser entry (React components + plugin registration)
├── client/
│   ├── types.ts          # Shared types
│   ├── hooks.ts          # useReducer state management + custom hooks
│   ├── term-pane.tsx     # xterm.js terminal pane component
│   ├── dropdown.tsx      # Dropdown menu next to the + button
│   ├── side-list.tsx     # Right-side terminal list panel
│   ├── styles.ts         # CSS constants + Campbell dark theme
│   ├── icons.tsx         # SVG icon components
│   ├── clipboard.ts      # Clipboard utility functions
│   ├── shortcut-bridge.ts # Shortcuts service integration (command registration + toggle bridge)
│   ├── compat.ts          # DSH-better-sidebar compat mode detection (soft-probe ctx.betterSidebar + service interface)
│   ├── sidebar-tab.tsx    # Sidebar terminal tab (compat mode: embed in DSH-better-sidebar bottom workbench, no DSH session binding)
│   ├── settings/         # Settings UI (types / store / card / profile-table / api / styles)
│   └── terminal/         # Terminal tab state (use-tabs / reducer / use-terminal-state / geometry)
├── persistence.ts        # Session persistence (log storage, metadata, startup restore)
├── platform.ts           # Platform adapter (POSIX / Windows + shell detection)
├── terminal/             # Terminal kinds, detection, resolution, profile store
├── settings/             # Settings bridge (namespace, bridge routes, patch ops)
├── constants.ts          # Protocol, size, shortcut, and env var constants
├── server-command.ts     # Command-line parsing utilities
├── shortcut.ts           # Shortcut parsing utilities
└── logger.ts             # Structured logger

The host side and browser side communicate over WebSocket at /api/dsh-oh-my-terminal and do not import each other directly.

License

Apache-2.0

Compatibility

DSH 0.2.1-alpha.1: failedDSH 0.2.1-rc.3: failedDSH 0.2.1-rc.4: failed

Versions

Latest versionPublishedSize
0.2.2——
0.2.3——
0.2.4——
0.2.5——
0.2.6——
0.2.7——
0.2.8——
0.3.0——
0.4.0——
0.4.1——
0.4.3——

Comments

Loading…

Similar plugins

terminal

by giiiiiithub

Real PTY terminal panel for the DSH Web UI: host half spawns shells with node-pty (cmd.exe default on Windows), rendered in the browser with xterm.js; multi-tab sessions, dock/floating window, clipboa

UI & ExperienceTerminal & ClientsManifest valid

★ 0

↓ 122/wk

MIT

JavaScript

Aug 15, 2026

dsh plugin --profile web add dsh-terminal

by siberiah2o

Bottom multi-tab terminal panel (node-pty + xterm.js) pinned to the viewport bottom, always below the input box.

Terminal & ClientsManifest valid

★ 7

↓ 204/wk

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-plugin-terminal

by xing-shuyin

Developer tools panel for the DSH web UI: file browser with preview, edit, and path-only file mentions; multi-tab terminals with quick commands; Git panel with commit, push, pull, and branch switching

UI & ExperienceManifest valid

★ 6

↓ 78/wk

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-ui-tools

by JUNQINGV587

Multi-server SSH terminal panel for the DSH Web GUI: floating terminal window with tabs, side-by-side groups, broadcast, host-owned persistent sessions, and password/private-key/SSH-agent auth.

Tools & CapabilitiesTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Aug 19, 2026

dsh plugin --profile web add dsh-ssh-hub

Claude-styled terminal panel for the DSH web GUI: agent shell commands run in a persistent real PTY with a genuine prompt, echo and exit codes, auto-open in the right sidebar and are scoped per conver

UI & ExperienceManifest valid

★ 0

MIT

TypeScript

dsh plugin --profile web add dsh-web-terminal

by EasyTZ

终端面板:在当前工作区敲命令、看实时输出,多标签页、Tab 补全、Ctrl+C 中断。Terminal panel for DeepSeek Harness: run commands with streaming output, tabs, completion.

Development & InfrastructureTerminal & ClientsManifest valid

★ 0

MIT

JavaScript

Sep 5, 2026

dsh plugin --profile web add @easytz/dsh-terminal-panel