Introduction

In DSH’s plugin extensibility model, the terminal client is not merely a wrapper for a chat window. Many real-world tasks simultaneously involve long-term Assistants, multiple project sessions, current plans, runtime status, model information, and context usage. dsh-tui-pro is a multi-session terminal workspace designed for this scenario: it puts the durable Assistant and active project sessions into the same full-screen TUI, enabling session switching, runtime control, and context viewing to happen on the same screen.

The plugin directory here is an independent site with no official affiliation with DeepSeek/Huafan, and should not be interpreted as an official app store. dsh-tui-pro belongs to the terminal workspace in the community plugin leads.

What is it

dsh-tui-pro is a multi-session terminal workspace for DeepSeek Harness.

  • Repository and Plugin Name: lk251066/dsh-tui-pro
  • NPM Package Name: @lk251066/dsh-tui
  • Maintainer: lk251066
  • License: MIT
  • Positioning: DSH Terminal Workspace / Client
  • Form: out-of-tree dsh plugin bundle, containing cordis.patch.yml profile layer, not a fork of DeepSeek Harness
  • Basis: Based on the original TUI implementation of DeepSeek Harness

In one sentence: It makes a durable Assistant and several active project sessions continuously available in the same full-screen TUI.

Core Features

Persistent Assistant and Project Sessions

dsh-tui-pro uses the Assistant as a durable session, which can persist across restarts. Project sessions are grouped by workspace and displayed in a fixed sidebar.

The Assistant can manage active project sessions and can also read completed user/assistant dialogue within these sessions. Note: hidden reasoning, tool traffic, and unfinished output are not exposed across sessions.

Full-screen TUI

This workspace provides a full-screen TUI containing:

  • transcript
  • editor
  • current plan
  • live status
  • model
  • context usage
  • active sessions

The purpose is to place frequently used information in the same visual area, reducing the need to switch back and forth between terminal output, status bar, and session list.

Session Management Commands

Common session commands include:

  • /new: Create another session in the current project
  • /new <path>: Create a session for another project
  • /assistant: Return to the fixed Assistant
  • /switch: Switch active project session
  • /quit: Close the current project session, preserve its history, and return to the Assistant
  • /sessions: Browse the full history
  • /exit: Close the TUI

In addition to commands, you can switch active project sessions via Alt+Left, Alt+Right, or clicking the sidebar.

Interaction Controls

During an active turn, dsh-tui-pro provides several categories of controls:

  • Enter: When a turn is running, send immediate steering
  • Tab: Queue the next turn
  • Esc: Restore the most recent queued message before cancellation
  • Double-click Esc: Browse checkpoints of the current conversation
  • Ctrl+O: Toggle tool and context body detail
  • Ctrl+R: Expand settled reasoning

These controls primarily serve steering, queuing, restoring, and viewing details during runtime.

File Completion and Image Attachments

The input side supports workspace file completion and clipboard image attachments:

  • @: Complete workspace files
  • Alt+V: Attach clipboard image when the selected model declares support for image input

Clipboard image attachments have dependencies on different systems:

  • Windows: uses PowerShell
  • macOS: requires pngpaste
  • Linux: requires wl-paste or xclip

Memory Control

Assistant memory is enabled by default. Related commands include:

  • /memory
  • /memory on
  • /memory off

/memory off removes memory from the model context of that session but does not delete it.

Installation and Enabling

Prerequisites

Before installing and running, you need to meet:

Node.js ^22.19.0 || >=24.0.0
DEEPSEEK_API_KEY
ANSI-capable terminal

DEEPSEEK_API_KEY must be configured outside the repository.

Using dsh CLI

First, install the plugin and its profile layer:

dsh plugin --profile tui add @lk251066/dsh-tui

After the above steps, you can start from any project directory:

dsh --profile tui

This package contains both the TUI plugin and the cordis.patch.yml profile layer, so you do not need to install a separate bundle package.

Without installing global dsh

If you do not have the global dsh CLI, you can use npx to run with the same profile:

npx -y @deepseek-ai/dsh@latest plugin --profile tui add @lk251066/dsh-tui
npx -y @deepseek-ai/dsh@latest --profile tui

Typical Usage

Start from project directory

Execute in the target project directory:

dsh --profile tui

After starting, you can first confirm if the current Assistant and current project session display as expected, and then proceed with subsequent operations.

Create and Switch Sessions

Common workflows are as follows:

  1. Create a new session in the current project:
/new
  1. Create a session for another project path:
/new /path/to/project
  1. Return to the fixed Assistant:
/assistant
  1. Switch active project session:
/switch

You can also use Alt+Left, Alt+Right, or directly click the sidebar.

Close and Exit

Close the current project session and return to the Assistant:

/quit

/quit preserves the history of the current project session.

Browse the full history:

/sessions

Close the TUI:

/exit

Control running conversations

If the current turn is still running:

  1. Use Enter to send immediate steering.
  2. Use Tab to queue the next turn.
  3. Use Esc to restore the most recent queued message before cancellation.

If you need to view checkpoints of the current conversation, double-click Esc.

View tools and reasoning

  • Ctrl+O: Toggle tool and context body detail
  • Ctrl+R: Expand settled reasoning

These controls are suitable when there is a lot of tool output and reasoning content.

Use file completion and clipboard images

Use @ in the input area to complete workspace files.

If the selected model declares support for image input, you can use:

Alt+V

to attach an image from the clipboard.

Control Assistant memory

View or toggle memory status:

/memory
/memory on
/memory off

/memory off only affects the model context of that session and does not delete the memory.

Applicable Scenarios and Notes

Who is it for

dsh-tui-pro is suitable for the following users:

  • Those who want to maintain multiple project sessions in one terminal
  • Those who need a long-term available Assistant
  • Those who want to see transcript, editor, current plan, live status, model, and context usage simultaneously
  • Users of DeepSeek Harness who want to extend the terminal experience via DSH plugins

Terminal Requirements

This TUI requires an ANSI-capable terminal.

Additionally:

  • When terminal inner columns are below 65, the sidebar is hidden
  • Recommended terminal height is at least 24 rows

Permissions and Security

As a DSH plugin, dsh-tui-pro runs with the same permissions as the current dsh process. It is recommended to check the source code, dependencies, and license before installing. The project license is MIT.

Release and Compatibility

dsh-tui-pro follows the developer-preview dsh release line. Each release is checked against source, packed npm artifact, clean public dsh profile, and real Linux PTY before release.

Cross-session Visibility

The Assistant can read completed user/assistant dialogue in active project sessions, but hidden reasoning, tool traffic, and unfinished output are not exposed across sessions.

Related Links

  • GitHub: https://github.com/lk251066/dsh-tui-pro
  • Directory Page: It is recommended to refer to the external directory entry provided in the repository README, with specific information based on the actual page content.