Preface

DSH extends its usage through plugins. dsh-terminal provides a persistent interactive terminal mode for DeepSeek Harness (DSH), enabling DSH to be used continuously in the terminal like a session-based coding CLI. Below is an introduction to its positioning, installation methods, common commands, and precautions.

What is this

dsh-terminal is a DSH plugin maintained by dongsheng123132, licensed under the MIT license, and requires Node.js 22 or higher.

It maintains the same DSH Agent and Session across prompts in the terminal and reuses DSH’s model selection, tools, permissions, session logs, commands, and lifecycle.

Core Features

  • Persistent terminal mode: Maintains the same DSH Agent and Session across prompts.
  • Normal text input: Continues the next round within the same session.
  • Common control inputs are as follows:
/new
/help
/exit
/quit

Where /new creates a new session, /help displays terminal commands and DSH’s registered slash commands, and /exit or /quit closes the terminal.

  • Other slash commands are directly dispatched to DSH.
  • Optional: Add dsh-cache-stabilizer to achieve cache prefix stability and cache statistics.

Installation and Enablement

Install using the terminal profile:

dsh plugin --profile terminal add github:dongsheng123132/dsh-terminal

After installation, start using the same profile:

dsh --profile terminal

Both the installation and startup examples use --profile terminal. The repository commits a pure JavaScript entry point, so Git installation does not require build script permissions.

Typical Usage

After entering the terminal, you can first enter normal text to continue the next round in the same session.

When you need to create a new session or exit, enter:

/new
/exit
/quit

To view available commands, enter /help.

Other slash commands will be directly dispatched to DSH, for example /compact, /plan, or /cache provided by dsh-cache-stabilizer.

Optional: Cache Prefix Stability and Statistics

If cache prefix stability and cache statistics are needed, you can additionally install dsh-cache-stabilizer:

dsh plugin --profile terminal add github:dongsheng123132/dsh-cache-stabilizer

After installation, commands provided by this plugin, such as /cache, are dispatched to DSH along with other slash commands.

Local Checks

When checking out a version from source, you can execute:

npm test
npm run check

These two commands are used for local testing and checking.

Applicable Scenarios and Notes

Suitable for developers who wish to use DSH as a terminal interactive tool.

The plugin runs with the permissions of the current dsh process. It is recommended to check the source code, dependencies, and MIT license before installation. The community directory in the DSH plugin ecosystem is an independent site with no official affiliation with DeepSeek or Huanfang (Fangfang); it should not be interpreted as an official app store.

GitHub Repository:

https://github.com/dongsheng123132/dsh-terminal