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 13d ago.
Show it in your README
For maintainers: the badge serves this listing's latest sandbox verdict, so a re-run updates it on its own — and it links readers to the full result here.
Due diligence
What it is — dsh-tianshu-tui is an official DeepSeek Harness terminal UI plugin. It uses a self-developed ANSI minimal engine to render agent status streams and includes engineering-layer customizations such as image bridging and code retrieval.
Who it is for — Developers monitoring agent states in a DeepSeek Harness TUI profile are suitable for installing it. Users not using the terminal interface do not need this plugin.
Watch out — Sandbox testing passed: installed in a clean profile and registered with harness. It executes shell commands and requires manual approval of the build script. No obvious issues found.
The verdict — I would install it because it supplies engineering-layer customizations for agent monitoring in terminal workflows.
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
Task board for the dsh web GUI: a sidebar multi-column kanban whose cards run in real DSH agent sessions and can also be scheduled with cron expressions, executed host-side even with the browser closed.
Installed cleanly when we ran it
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.
Installed cleanly when we ran it
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.
Installed cleanly when we ran it
ccch1mneyyy
Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.
Installed cleanly when we ran it