At a glance

What it does

An Ink-based full-screen terminal UI for DeepSeek Harness.

Code-evidenced contributions

What it adds to DSH

Terminal UIdshtui terminal interface

Replaces the DSH terminal surface with streaming chat, foldable tool cards, dialogs, and extensible visible-surface contributions.

Mechanism evidence ↗

Before you choose it

dshtui mounts into a DeepSeek Harness profile as a bundle plugin and replaces the terminal interface with streaming chat, foldable tool cards, dialogs, and extension points for visible UI surfaces.

Best for

DeepSeek Harness users who want an interactive, opencode-style terminal experience instead of the default interface.

Common tasks

Run DSH conversations in a full-screen streaming terminal UI.
Fold long tool output and control tool-card expansion behavior.
Customize the interface palette, frame rate, screen mode, and TUI behavior through the profile row or documented environment variables.

Permissions and data

No explicit permissions or data-handling policy is supplied. The plugin is configured within a DSH profile and acts as that profile's terminal interface.

Permissions

Modifies or creates the selected DSH profile through the documented launcher or manual plugin-add flow.

Data handling

The supplied evidence does not describe collection, storage, transmission, or retention of user data.

External services

DeepSeek Harness (dsh) is required.

Credentials

No credential requirement is declared in the supplied evidence.

Limitations

Requires Node.js ^22.19.0 or >=24.0.0 and the dsh CLI.
A DeepSeek Harness version range is not declared in the supplied evidence.
Package lifecycle includes a prepare build step using tsdown.
The npm package identity was verified, but its published package contents were not audited in the supplied record.

What DSHub checked

The pinned source commit, bundle structure, patch syntax assessment, npm package identity, and MIT license were verified.
The README documents launcher-based and manual profile installation paths.

What DSHub did not check

Installation, runtime behavior, terminal rendering, and compatibility with a specific installed DSH version were not executed or verified.

Pinned install

Install dshtui

This plugin bundle does not have a DSH Plugin install action. Use its source documentation for the delivery method.

Visit the source project ↗

Maintainer source

Project README

View at commit 8baf515 ↗

Maintainer-authored contentCaptured from README.md on Sep 12, 2026. The text and repository-relative media are fixed to commit 8baf51501e90 with content hash 129f459da1ba; provider-hosted badges may update independently. README commands are upstream documentation; the DSHub copy action above is the verified, version-pinned install.

dshtui

English | 中文

dshtui is a terminal UI plugin for DeepSeek Harness (dsh), built on Ink, in the TUI style of opencode. It mounts into a dsh profile as a bundle plugin and takes over the whole terminal interface: streaming chat, foldable tool cards, dialogs, and a plugin contribution API covering every visible surface.

This project exists as a plugin of DeepSeek Harness.

Requirements

Node.js ^22.19.0 or >=24.0.0
The dsh CLI: npm install -g @deepseek-ai/dsh

Install

npm install -g @xp266/dshtui@latest
dshtui

dshtui first resolves the profile to boot (DSH_TUI_PROFILE overrides; otherwise the dshtui profile, an existing profile that already mounts this package, or a freshly created one), installs or upgrades the plugin inside it, then launches dsh --profile <name>.

The launcher is optional; install the plugin into any profile by hand:

dsh plugin --profile <name> add @xp266/dshtui@latest
dsh --profile <name>

Configuration

The plugin reads its config from the matching profile row:

- id: tui
  name: '@xp266/dshtui'
  config:
    colors: {}            # palette overrides (color name -> hex)
    maxFps: 240
    bootListTimeout: 10000
    alternateScreen: true
    collapse:             # tool-card fold policy
      maxLines: 16        # fold bodies over this many rendered rows
      previewLines: 8     # rows kept visible while folded
      folded: []          # tool names that always fold
      expanded: []        # tool names that never fold

Environment variables: DSH_TUI_PROFILE, DSH_TUI_COLOR, DSH_TUI_ASCII, DSH_TUI_WIDTH, DSH_TUI_BG, DSH_TUI_LANG, DSH_TUI_HOT_THEME, DSH_TUI_THEME_PATH, DSH_TUI_DEBUG, and the DSH_TUI_LOG_* family.

Plugin development

Every visible surface of the interface is a keyed contribution registry behind the tui service. The full contribution map lives in the extension point guide.

Run or develop from source

git clone https://github.com/xp266/dsh-tui.git
cd dsh-tui
pnpm install
pnpm typecheck
pnpm build
pnpm verify

License

MIT

Operate deliberately

Install and manage

Prerequisites and target Profile

Target： Deepseek Harness Profile

Delivery： Dsh Bundle Git — xp266/dsh-tui#8baf51501e9062c3d43463b85409ff0871608ed1。

Verify, update, and remove

Show lifecycle commands

Verify

dsh plugin --profile deepseek-harness list

Compatibility and access

DeepSeek Harness bundle; Node.js version requirement declared： Not declared in supplied evidence。

Review compatibility evidence ↗

Risk facts

Terminal Interface Replacement

Takes over the whole terminal interface for the selected DSH profile.

Evidence ↗

Profile Configuration

Its bundle patch adds TUI, workspace, agent-preset, model-selection-settings, and host-runner rows, while disabling several default profile rows.

Evidence ↗

License

MIT licensed; supplied license disclaims warranties.

Evidence ↗

Evidence and editorial reviewManifest, Bundle patch, distribution and freshness

Immutable evidence

Review status and source activity

AI reviewed

Use it when you intentionally want the selected DSH profile to use dshtui as its complete terminal interface; review profile-level changes before adding it alongside other bundles.

AI reviewed Sep 12, 2026, 2:08 PM UTC。GitHub facts last checked Sep 12, 2026, 2:08 PM UTC。

No material source change has been recorded since this evidence baseline.

Next step

Follow the Plugin installation workflow →

Subscribe to material changes for dshtui →