Preface¶

Running an Agent in DeepSeek Harness (DSH) typically involves two tasks for the terminal interface: receiving your input and displaying model responses and tool execution processes. Both official and community implementations offer various TUI solutions. Among them, dsh-TUI is feature-complete but consumes significant screen space with tool calls, status bars, and session information. If you prefer to prioritize reading model responses in the terminal and only expand tool details when needed, DSH Mini TUI (npm package name: dsh-mini-tui) is a terminal presentation layer plugin designed specifically for this need.

Below, we introduce its positioning, core capabilities, installation methods, and typical usage. All facts are derived from the project’s README and package.json (current version: 0.2.1).

What It Is¶

DSH Mini TUI is developed by community maintainer boxeryao and is classified as a DSH client plugin. It is not a standalone Agent framework but a terminal UI plugin for DeepSeek Harness: model routing, Agent lifecycle, scoped tools, permission approval, and session persistence are still managed by DSH. Mini TUI only determines how you input commands, view status, and read responses in the terminal.

The Mini in the name refers to reduced interface noise, not reduced Harness capabilities. Tools execute as usual; successful calls are hidden by default, while failures display a short one-line prompt. Complete logs remain in the DSH Session logs.

Relationship with DSH¶

After launching dsh --profile tui, the DSH runtime loads plugins under the tui profile. As the terminal presentation layer within this setup, Mini TUI belongs to the community terminal interface ecosystem alongside dsh-TUI; the two are independent implementations.

Installing or removing Mini TUI changes DSH’s interactive interface without replacing the underlying Agent or reducing model, tool, or session capabilities.

Core Features¶

Answer-First Conversation Flow¶

The interface design principle is: Tools work as usual; processes don’t need to fill the screen. The terminal primarily displays user input and the model’s final response. Successful tool calls are silent by default, while failures show only a short one-line prompt, preventing exceptions from being silently swallowed.

For troubleshooting, use /verbose to toggle limited tool output for subsequent calls, or /tool N to view the input and results of call number N. toolDetailMaxLines and toolDetailMaxCharacters default to 80 lines and 8,000 characters, respectively. /tool N retains details of the most recent 200 calls in process memory; earlier complete values remain in the DSH Session logs.

Restrained Terminal Visuals¶

• The startup interface displays the DEEPSEEK logotype using a cyan-to-deep-blue true color gradient.
• Below the logotype, only the current model, working directory, and /help prompt are shown; session IDs, platform versions, and other information are not stacked.
• Input borders, status labels, working paths, and thinking prompts share a low-contrast deep-sea color palette; file and directory paths in output have stable color coding.
• During model inference, a concise [thinking] status is displayed, but internal reasoning content is not output to the terminal.

Input and Terminal Commands¶

• Enter sends the current message; Shift+Enter or Ctrl+J inserts a newline.
• Ctrl+V accepts bracketed multiline pastes; on Windows, use /paste to directly read the clipboard.
• /cancel or Ctrl+C cancels the current task.
• /help displays commands; /exit or /quit closes the session.

Windows Right-Click Menu (Optional)¶

Mini TUI includes a current-user-level right-click menu installer. After installation, you can launch directly from empty space in a directory, the directory itself, or a disk drive:

• Open DSH TUI here — Opens the current directory in standard permission mode.
• Open DSH TUI full access — Opens in danger-full-access mode; only enabled when actively selecting this menu.

Installation and uninstallation only modify HKEY_CURRENT_USER and do not require administrator privileges. The right-click command ultimately runs dsh --profile tui, with models, Agents, and tools still provided by DSH.

Installation and Setup¶

Environment Requirements¶

• Node.js 22.19 or higher, or Node.js 24+
• pnpm 11+ (only needed for source code development)
• DeepSeek Harness 0.1.0-rc.6 installed
• Valid model credentials configured in DSH

Installation from npm¶

First, install the plugin, then start the tui profile:

dsh plugin --profile tui add dsh-mini-tui@latest
dsh --profile tui

Note: The deepseek-harness-tui on npm belongs to another project. The correct package name for this plugin is dsh-mini-tui.

Installing the Windows Right-Click Menu¶

After installing to the default tui profile via npm, run:

& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\install-dsh-tui-context-menu.cmd"

To uninstall the right-click menu:

& "$HOME\.dsh\profiles\tui\node_modules\dsh-mini-tui\scripts\uninstall-dsh-tui-context-menu.cmd"

Typical Usage¶

After installation, launch in the target working directory:

dsh --profile tui

Once in the session, type your question and press Enter to send. If a tool call fails, the terminal displays a short prompt. To view subsequent tool outputs, enter /verbose to enable detailed limited output, or use /tool N to check the input and results of a specific call.

When developing from the source directory, build and install locally first:

pnpm install
pnpm run build
pnpm test
dsh plugin --profile tui add .
dsh --profile tui

Here, dsh plugin --profile tui add . installs the current source directory; regular users should prioritize the npm quick install command.

Use Cases and Considerations¶

Who It’s For

• Users who run Agents in DSH and prefer a more restrained terminal interface with easier continuous reading of responses.
• Developers who need to launch DSH TUI via right-click in Windows File Explorer.
• Those who accept an interaction model where processes are hidden by default and expanded on demand, rather than viewing all tool outputs in real-time scrolling.

What to Note

• This repository only provides the terminal presentation plugin and does not offer web client graphic cards, session navigation, or full-screen scrolling areas.
• The plugin runs with the permissions of the current dsh process; before installation, review the source code and MIT license to ensure they meet your security requirements.
• The DSH community directory SkillHub is an independent site without official affiliation to DeepSeek or High-Flyer; plugin discovery and installation should be based on each project’s README.

Conclusion¶

DSH Mini TUI retains the complete Agent and tool capabilities of DeepSeek Harness in the runtime, making only an answer-first interface trade-off at the terminal layer: less noise, faster access to responses, and optional expansion via /verbose or /tool N when needed.

• Catalog page: https://www.skillhub.cn/plugins/boxeryao/dsh-mini-tui
• GitHub: https://github.com/boxeryao/dsh-mini-tui