dsh-tui: A Claude Code-style Terminal Interface for DeepSeek Harness

dsh-tui is a terminal interface plugin (DSH plugin) for DeepSeek Harness (DSH), maintained by ccch1mneyyy under the MIT license, crafted for TUI-loving geeks. It solves the problem of DSH's default terminal UI being less intuitive and lacking visibility into agent state, delivering a Claude Code-style immersive experience: pixel whale top bar, dual flowing-glow title, real-time status line, streaming thought expansion, double-Esc time rewind, and a blue-white context progress bar with TPS gauge. As a featured plugin in DSH's official WeChat account (selected for internal beta users), it requires zero core changes—pure plugin mounting, install to enable, uninstall leaves no patches.

What core features does the dsh-tui DSH plugin support?

• Terminal-native interaction: streaming Markdown, structured tool cards, command and file completion, @ file references (with PNG/JPEG/WebP/GIF as persistent image blocks), history search, message selection, inline/alternate-screen rendering modes, and /lang for Chinese/English UI switching.
• Observable agent state: real-time working status, segmented context progress, TPS, cache hit rate, reasoning level, input/output tokens, and Git/session info.
• Complete session workflow: /resume, /new, /compact, /export, /btw side questions, model switching, and session rewind/fork triggered by double-Esc.
• DSH official capability integration: Agent presets, Skills, MCP, Goals, Todos, subagents, and ask_user_question surveys all connect via existing services or registries.
• Designed for long sessions: event-driven projection, differential terminal output, message virtualization, replay merging, and bounded caching to prevent rendering cost and memory from growing unboundedly.

How do I install dsh-tui?

Prerequisites: a usable terminal TTY, the official dsh CLI, and pnpm 10+. Running models also requires DEEPSEEK_API_KEY. Recommended: global npm install (includes the dsh-tui direct command), or install via the DSH plugin command:

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui
dsh-tui

Alternative—manual profile install (the repo's install.sh wraps this, including pnpm pre-check):

sh install.sh
# or: dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui

After install, dsh-tui is equivalent to dsh --profile dsh-tui; dsh-tui --resume restores the last session; Windows users can use dsh-tui.cmd. The TUI checks for npm updates in the background; type /update to auto-update and restart, restoring the current session.

What keyboard shortcuts and mouse operations does dsh-tui support?

Shortcuts cover high-frequency actions: Enter to send (Shift+Enter for newline), Ctrl+C to interrupt/exit, Esc to close menus (double-tap on empty input triggers time rewind), Ctrl+O to expand details, Ctrl+R for history search, / for in-session full-text search, Tab/Enter for completion, Ctrl+V to paste (images show as [Image #N]), Ctrl+X to edit with $EDITOR, ? for the shortcut menu, Shift+↑ for message selection. On macOS, Ctrl can be replaced with ⌘ (except Ctrl+C/Ctrl+D), requiring a terminal that supports the extended keyboard protocol (iTerm2 / kitty / WezTerm / ghostty / tmux). In fullscreen mode (fullscreen: true), mouse drag selects text and releases to copy (OSC 52 + wl-copy/xclip/xsel).

Which DeepSeek Harness versions and platforms does dsh-tui support?

As an officially featured DSH plugin, dsh-tui deeply integrates with the DSH ecosystem, depending on many @deepseek-ai/* official packages (e.g., dsh-agent, dsh-session, dsh-tools) to ensure seamless collaboration with DSH core capabilities. It supports Linux, macOS, and Windows (via dsh-tui.cmd), and can run in VS Code's built-in terminal with the companion extension dsh-tui-vscode (available on the VS Code Marketplace) for an experience nearly identical to the official extension. The project was last updated in 2026-08, is in public beta, and is actively maintained by the author.

View more DSH plugins at dsh-plugin.org