huiliyi37/dsh-tianshu-tui
A terminal UI (TUI) for DeepSeek Harness.
Install
via npm
Resolves a published tarball rather than cloning the repository, and installs without any extra setup. Swap `web` for your profile name if you run another one.
via GitHub · npm package
Installing from GitHub runs the project's build script, which pnpm blocks until you allowlist it — run the command once and pnpm prints the exact key to add under `allowBuilds` in ~/.dsh/profiles/web/pnpm-workspace.yaml.
What happened when we ran it
Installed cleanly when we ran it
Every command here is run in a throwaway container against a clean profile, and the result is whatever the harness recorded — not a guess from the source. Last run yesterday.
Due diligence
What it is — dsh-tianshu-tui is a terminal UI plugin for DeepSeek Harness, evolved from the Tianshu-Tui rendering core. The UI is a pure presentation layer where all agent states originate from session event streams, with personalized modifications at the harness engineering level.
Who it is for — People using DeepSeek Harness for coding work and needing to manage agent states and sessions are suitable for installing it. Those who do not need a terminal UI to display agent states or are already in an independent integrated distribution do not need to install this plugin.
Watch out — This plugin requires the official DeepSeek Harness CLI to be installed first. Sandbox testing confirms successful installation and registration into the profile in a fresh profile. No obvious issues were found.
The verdict — I would install it because it supports real-time theme previews and session cost summaries.
Generated by grok-4.6, and a starting point rather than a verdict. Where it says a plugin installs or does not, that is from a real run in a clean profile — everything else is read off the repository. Trust the source over this.
dsh-tianshu-tui is a DeepSeek Harness plugin that provides an interactive terminal UI for the official DeepSeek Harness CLI. It is a presentation layer rather than a separate agent runtime: the UI receives agent state from the session event stream and renders it through a lightweight ANSI engine derived from Tianshu-Tui. The package also includes harness-level bridges for images and vision, code-oriented retrieval, and memory and cross-session recall. These features depend on the capabilities available in the surrounding harness and any separately installed companion plugins.
The plugin runs inside the official @deepseek-ai/dsh tui profile, reads session events, and handles terminal input for commands such as /exit, /restart, /model, /theme, /session, and /cost. npm installations may check npm latest at startup and write an updated package into the profile; DSH_TUI_SKIP_UPDATE=1 disables that check. Its profile and harness data live under DSH_HOME, which defaults to ~/.dsh.
This is intended for developers who want a terminal-based interface for official DeepSeek Harness sessions. It is not a standalone executable and requires the official CLI, Node.js ^22.19 || >=24, and pnpm on PATH. It is the wrong choice for the separate oh-my-tianshu ecosystem, whose TUI uses different @huiliyi37 packages. As a terminal-surface plugin, it reaches the terminal to render a full-screen interactive interface and process keyboard input, and may write packages into the configured profile during updates.
dsh-tianshu-tui is loaded by the official @deepseek-ai/dsh CLI, not run as an independent program. The README requires:
@deepseek-ai/dsh version 0.1.0-rc.7^22.19 || >=24pnpm available on PATH, because dsh plugin forwards package operations to itThe intended profile is tui. The harness data home is DSH_HOME; its documented default is ~/.dsh. The README advises using the versioned npx form of the official CLI when an older dsh executable may already be present on PATH.
The UI consumes agent state from the session event stream and renders it with an ANSI terminal engine. It handles terminal keyboard input, including Ctrl+Q for exit, Ctrl+C for interruption, Esc for interruption or the rewind panel, Ctrl+X for cycling sessions, and Alt+1 through Alt+9 for direct session selection.
The command surface includes:
| Command | Behaviour |
|---|---|
/exit |
Exits the TUI |
/restart |
Restarts the same process |
/help |
Lists registered commands; /help <cmd> shows one command |
/theme |
Opens theme selection; an argument can select a theme |
/model |
Opens model selection without an argument; an argument retains the parameterised form |
/session |
Opens session selection without an argument |
/cost |
Shows accumulated usage and estimated cost by model |
For npm installations, startup checks npm latest and can write a newer package into the profile. Set DSH_TUI_SKIP_UPDATE=1 to skip the online update check. The package manager used for updates is selected from the profile’s lock file. Updates can restart automatically when no session work has begun; /restart is available for a manual restart.
The optional vision-ask/ companion adds image-questioning capability. The community dsh-lsp plugin adds LSP model tools; the TUI can consume its lsp service for diagnostics and shares its LSP server set.
The plugin must be used with official DeepSeek Harness packages and should not be placed in the oh-my-tianshu or @huiliyi37 TUI profile. The README does not describe this package as a standalone CLI.
Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub
Same category
zhu1090093659
Plugin and skin collection for the DSH Web UI: task board, Git graph, right-side panel, remote mobile UI, pet, live token stats, and a skin center.
No one-line install — this plugin lives inside a larger repository and publishes no npm package.
omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
Installs, but needs a build approved first
ccch1mneyyy
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
Installed cleanly when we ran it
omdsh-dev
Codex-style `@file` mentions: search workspace files in the composer and attach their contents to prompts.
Installed cleanly when we ran it
omdsh-dev
Interactive UI components rendered inline in replies: layout, charts, forms, quizzes, mermaid, 3D scenes, and an action event loop back to the model.
Installed cleanly when we ran it
Nagi-ovo
In-conversation generative UI: the model renders interactive HTML cards into the chat stream, with streaming preview and sandboxed rendering.
Installed cleanly when we ran it