Introduction

In the plugin extension model of DSH, terminal interaction often needs to handle the model, context, tool activities, subagents, sessions, and topics simultaneously. dsh-tui-pi aggregates these terminal-side capabilities into a single plugin package: it provides DSH with a set of pi-style terminal UIs, including a pi-tui look & feel, DSH slash commands, GitHub light/dark themes, and a powerline footer.

Below, it introduces its positioning, installation methods, typical usage, and things to note. Please note that the community directory is an independent site and is not equivalent to the official app store.

What is it

dsh-tui-pi is a plugin for DeepSeek Harness (dsh). The package name used for installation is:

@aiwayds/dsh-tui-pi

Verified version and environment information are as follows:

  • Requires dsh version no lower than 0.1.2-rc.1
  • The alpha line is no longer supported
  • package.json declares engines as node >=22.19.0
  • License is MIT

When starting, there is a host version check: if the current DSH version is lower than the required version, the plugin will execute the startup guard and exit cleanly. If skipping this check is indeed necessary, set:

DSH_TUI_SKIP_HOST_CHECK=1

Core Features

Below lists the verified functional points:

  • Footer: The bottom displays a live session overview, including provider/model, context pressure, and session cache-hit rate.
  • Think & tool panels: Provide the Think panel and tool panel.
  • Subagents: Provide a status line for running subagents and support live steering.
  • Ask User Question: The model can pause and ask structured questions; the answering process does not leave the TUI.
  • Feishu integration: Provide Feishu integration; the optional plugin is @aiwayds/dsh-feishu.
  • Dynamic context pruning (DCP): Provide dynamic context pruning.
  • Persistent context: Provide persistent context.
  • Model profiles & favorites: Provide model configuration and favorites.
  • Agent preset switching: Provide agent preset switching.
  • Sessions & resume: Provide session and resume capabilities.
  • Themes: Provide GitHub light/dark palettes, supporting hot-switching; auto follows the terminal.
  • Search, selection & images: Provide search, selection, and image-related capabilities.
  • Slash commands: Provide slash commands.
  • Startup plugin tree: Display the plugin tree at startup.

Installation and Enabling

First, confirm that the environment meets the requirements:

dsh >= 0.1.2-rc.1
node >=22.19.0
alpha line is not supported

Install the plugin:

dsh plugin --profile tui add @aiwayds/dsh-tui-pi

Start the corresponding TUI profile:

dsh --profile tui

If already installed and the plugin upgrade requires handling existing profiles, you can execute:

node scripts/dev-upgrade.mjs

You can also preview the upgrade plan first:

node scripts/dev-upgrade.mjs 1.0.5 --dry-run

Default companion plugins are provided with the package, but whether to enable them is still processed according to the profile’s bundles list.

If you want to additionally install the topics memory plugin, you can use:

dsh plugin --profile tui add @aiwayds/dsh-topics-memory

Typical Usage

Common keys are as follows:

  • Tab: Switch agent presets
  • Ctrl+Shift+F: transcript search
  • Ctrl+G: Open subagent picker
  • Esc: Double-click to stop

Key mappings can be adjusted via the config file:

~/.dsh/keybindings.json

You can also use the interactive slash command:

/hotkeys

Session-related configurations are placed in:

~/.dsh/settings.yaml

The two configuration items related to the dsh-tui namespace are:

  • dsh-tui.retention: Acts as a startup janitor for ~/.dsh/sessions and will delete old logs.
  • dsh-tui.resume: Only hides picker rows and does not delete.

Suitable Scenarios and Notes

Suitable for the following scenarios:

  • Already using DSH and wish to centralize terminal interaction into a TUI.
  • Need footer, subagents, sessions, themes, slash commands, and other terminal-side capabilities.
  • Need Feishu integration and are willing to evaluate the optional plugin @aiwayds/dsh-feishu.

Notes before use:

  • The plugin runs with the current DSH process permissions. It is recommended to check the source code and license before installing.
  • The license declared by this plugin is MIT.
  • It targets DSH 0.1.2-rc.1 and above and does not support the alpha line.
  • dsh-tui.retention has deletion behavior; please confirm the contents in ~/.dsh/sessions before enabling.
  • The community directory is not the official app store and has no official affiliation with DeepSeek / FanHua.

Related Links

  • Community directory: https://www.skillhub.cn/plugins/fan56/dsh-tui-pi
  • GitHub: https://github.com/fan56/dsh-tui-pi