dsh-tianshu-tui: An Interactive Terminal UI Plugin for DeepSeek Harness
huiliyi37/dsh-tianshu-tui
An interactive terminal UI plugin for DeepSeek Harness, featuring smooth ANSI rendering and built-in workflows like TDD, evidence gates, and vision.
Provides a silky-smooth terminal interface for DeepSeek Harness, enhanced with TDD, evidence gates, image query, and other advanced workflows.
dsh plugin --profile web add github:huiliyi37/dsh-tianshu-tui- Category
- UI & Experience
- Platform
- DSH-Plugin
- Author
- huiliyi37
- Distribution
- Plugin
dsh-tianshu-tui Key Features
dsh-tianshu-tui Repository
dsh-tianshu-tui Repo Summary
dsh-tianshu-tui is an interactive terminal UI plugin (DSH plugin) for DeepSeek Harness, maintained by huiliyi37 under the Apache-2.0 license. It addresses the lack of smoothness and advanced workflow support in the official DSH terminal interface, delivering an extremely fluid experience with a self-developed ANSI rendering core. It adds TDD-driven workflows, evidence gates, visual image modules, code intelligence retrieval, memory, and cross-session recall on top of the official version. The plugin is a pure presentation layer; all agent states come from the session event stream, and it includes personalized harness engineering modifications.
What core features does the dsh-tianshu-tui DSH plugin support?
The plugin enhances the official DSH with several workflow capabilities: TDD-driven workflows, evidence gates (ensuring every step is traceable), visual image modules (requires the companion package vision-ask for image queries), code intelligence retrieval, memory, and cross-session recall. It also provides 16 built-in themes and custom theme options, and supports use within VS Code. For LSP model tool surfaces (e.g., lsp_goto_definition, lsp_find_references, lsp_diagnostics), you can install the community plugin omdsh-dev/dsh-lsp.
How to install dsh-tianshu-tui?
Before installation, prepare Node.js ^22.19 || >=24 and pnpm (dsh plugin forwards to it). This plugin is not a standalone program; it requires the official CLI @deepseek-ai/dsh (0.1.0-rc.6). The installation command is as follows:
npx -y @deepseek-ai/dsh plugin --profile tui add @huiliyi37/dsh-tianshu-tui
You can also install from Git:
npx -y @deepseek-ai/dsh plugin --profile tui add github:huiliyi37/dsh-tianshu-tui
To start, use:
npx -y @deepseek-ai/dsh --profile tui
You will see the welcome page with the dsh-tianshu-tui brand. If an older dsh is on your PATH, always use the npx command to avoid ERR_FS_EISDIR errors.
How to configure and customize dsh-tianshu-tui?
Configuration options, environment variables, and runtime settings are detailed in the official documentation's configuration.md. You can set the environment variable DSH_TUI_SKIP_UPDATE=1 to skip network update checks. For themes, 16 built-in themes are available, and custom themes are supported. The interaction manual (interaction.md) provides a complete list of shortcuts and commands.
How does dsh-tianshu-tui coexist with other distributions?
This plugin runs on the official DeepSeek Harness, with data home at ~/.dsh. The standalone integrated distribution oh-my-tianshu (formerly tianshu-public) uses a separate $DSH_HOME (default /.dsh-tianshu), so the two systems' homes are isolated and can be installed simultaneously without interference. To coexist, set export DSH_HOME=/.dsh-tianshu on the tianshu side. Note the naming differences: dsh-tianshu-tui is the TUI plugin for official dsh; oh-my-tianshu is a standalone integrated distribution; Tianshu-Tui is the upstream rendering core source.
What architecture and documentation resources does dsh-tianshu-tui have?
The architecture document (architecture.md) describes layering, data flow, and design decisions. ADAPTER.md defines the TUI-harness boundary contract. The contributing guide (CONTRIBUTING.md) and development notes (DEVELOPING.md) provide PR specifications and build/release processes. The plugin ecosystem document (plugins.md) lists companion plugins and extension points.