mrkeyoor.com_
Tue 01 Sept 17:43 UTC
AI Toolsevaluationupdated 25 Aug 2026

dsh-TUI review

dsh-TUI is a Chinese-first terminal interface plugin for DeepSeek Harness, with a full English README and English reference pages. It gives the official DSH agent a Claude Code-style conversation screen, tool cards, session controls, context meters, rewind, themes, MCP status, and a VS Code companion without patching the DSH core.

+196stars / 7d
Verdict

Our dsh-TUI install completed in 33 seconds, but its source build failed after 41 seconds on an exact pnpm 11.21.0 versus 11.23.0 check, and the repository exposed no test target. Existing DeepSeek Harness users may still find it the best interface upgrade because it preserves DSH services while adding serious session navigation and visibility. Everyone else should compare complete agents first, and Windows users should treat the documented no-approval sandbox fallback as a stop sign for sensitive work.

We ran it

Lab card: what happened when we ran dsh-TUIScreenshot of dsh-TUI (dshtui.com)
Install✓ · 33s332 packages · 236 MB
Build✗ · 41s
Testsn/ano test script
Repo752 files~134,612 lines of source · 11.6 MB · 3 CI workflows

Answers from our run

Does dsh-TUI build from source?

Dependencies installed in 33 seconds (332 packages), and the build failed. We cloned commit 7646ef6 into a clean Debian container with 3 CPUs and no project-specific setup.

Does dsh-TUI have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Who should not use dsh-TUI?

Users who do not want DeepSeek Harness: dsh-TUI is an interface plugin and still requires the official dsh CLI.

What are the alternatives to dsh-TUI?

DeepSeek Harness, Codex, Crush. Our dsh-TUI install completed in 33 seconds, but its source build failed after 41 seconds on an exact pnpm 11.

Setup2/5Install passed, but exact pnpm mismatch blocked the build
Docs4/5Long bilingual guides cover setup, commands, security, and limits
Community5/5Release and push on Aug 25 with active issue handling
Maturity2/5Public beta with no repository test target in our run

Who it’s for

DeepSeek Harness users who want a full-screen terminal workflow instead of its default interface.
Developers who need visible context use, token counts, cache status, reasoning state, and session metadata during long agent runs.
DSH plugin authors who want a reference interface built on Cordis and the official agent services.
Bilingual Chinese and English teams that can use the maintained documentation in either language.

Who it’s NOT for

Users who do not want DeepSeek Harness: dsh-TUI is an interface plugin and still requires the official dsh CLI.
Windows users working with sensitive credentials or untrusted repositories: the README says Windows lacks the corresponding sandbox backend and falls back to danger-full-access without approval prompts.
Noninteractive automation: the quickstart requires a terminal TTY, and the product is designed around keyboard, mouse, streaming, and session interaction.
Teams requiring stable production software: the project labels itself public beta, and same-day reports cover task folding, terminal copying, and long-output rendering.
Contributors unable to pin pnpm exactly: our build stopped because 11.23.0 did not match the required 11.21.0.

Setup reality

Our pnpm install succeeded in 33 seconds, adding 332 packages and using 236 MB on disk. The checkout measured 11.6 MB, 752 files, and about 134,612 source lines. That covers the TUI and vendored workspace code, not the separate DSH service it needs at runtime.

Normal use requires the official dsh CLI, pnpm, an interactive TTY, and a DEEPSEEK_API_KEY for model requests. The first start initializes a profile; optional providers, MCP servers, themes, editor integration, and file permissions add their own configuration. The TUI inherits the profile's sandbox and approval policy.

The build failed in 41 seconds because a vendored workspace required pnpm 11.21.0 while Corepack supplied 11.23.0. The log explicitly recommends aligning the package-manager declarations or changing invocation. No test script or target existed, so our lab skipped tests rather than reporting a pass.

dsh-TUI changes the interface while DSH keeps control

dsh-TUI mounts as a Cordis plugin over DeepSeek Harness. The session log remains the source of truth, and official DSH services continue to own model calls, tools, compaction, persistence, forks, and resume behavior. The plugin handles presentation and interaction: a React terminal tree, an Ink and Yoga-derived renderer, live activity projection, selection, scrolling, menus, and status displays.

That boundary is the project's best design decision. Removing the plugin leaves no core patch, according to the README. It also means dsh-TUI is useless without DSH. Our checkout contained about 134,612 source lines across 752 files, yet it still relies on a separate agent runtime, profile, model access, and service registries. Buyers should evaluate the combined stack instead of judging the whale-themed screen alone.

Long sessions get real navigation tools

The interface exposes session resume, forks, rewind, compaction, export, a side-question command, search, and a turn rail that includes folded history. Users can steer a running turn with Enter, queue a follow-up with Tab, or interrupt with Ctrl+Enter. Tool cards, reasoning text, older messages, and loaded context can be folded so a long transcript stays navigable.

Operational data is unusually visible. The header can show context use, input and output tokens, throughput, cache hit rate, reasoning effort, Git state, and session identity. The project describes bounded caches and a 300-to-120-row fold window for long screens. Those are project claims rather than our measurements, but the controls solve a concrete problem: terminal agents become hard to trust when progress and context pressure are invisible.

The permission model belongs to the active profile

dsh-TUI does not implement an independent sandbox. File access, shell execution, approvals, and sandbox behavior come from the selected DSH profile. That is sensible because the interface should not create a second policy engine. It also places responsibility on the user to inspect profile settings before starting the agent in a repository containing secrets or untrusted code.

Windows is the sharp exception. The architecture warning says there is no corresponding sandbox backend there, so the provided composition falls back to danger-full-access and does not display approval prompts. That is a concrete reason to walk away or isolate the environment. A pretty terminal cannot compensate for a permission boundary that differs across operating systems.

MCP and editor support stay inside DSH conventions

MCP servers are mounted through DSH's MCP client, and tools appear under names shaped like mcp__server__tool. The /mcp command shows connection state. Skills, goals, todos, subagents, agent presets, provider login, and permission commands also use existing registries rather than parallel dsh-TUI implementations. This makes the plugin a real MCP client surface, so the mcp tag is functional rather than decorative.

VS Code users can run the TUI in its integrated terminal or add the companion extension. Terminal differences still matter. The English README documents alternate paste keys, macOS modifier behavior, tmux copying, external-editor support, and mouse tracking. Issue #439 reports copying trouble in a JetBrains terminal, while issue #545 covers repeated rendering and lost scrollback in PyCharm. Test the actual terminal combination, not only a standalone shell.

What happened when we ran it

Our sandbox installed 332 pnpm packages in 33 seconds at commit 7646ef6, and dependencies used 236 MB. The repository occupied 11.6 MB with roughly 134,612 source lines. Installation succeeded in an unprivileged Node 22 container, with no model key or DSH session needed for that dependency step.

The build stopped after 41 seconds during build:dsh-std. The error says the vendored project is configured for pnpm 11.21.0 while the current Corepack-invoked version was 11.23.0. It recommends aligning packageManager with devEngines.packageManager, invoking pnpm outside Corepack so it can switch, or explicitly weakening the check. No compiler diagnostic appears after that version guard.

Our lab found no test script or target, so tests were skipped. That is not a passing suite and should not be presented as one. The repository does have 3 CI workflow files, but the checkout did not give our generic harness a runnable test command. For a public-beta interface that can approve tools and manipulate sessions, a discoverable local verification path would make adoption easier.

Public beta status matches the current rough edges

Version v0.9.2 was released on August 25, 2026, the same day as the last push. Its title says it fixes the update path by preconfiguring the pnpm build-script allowlist. Issue activity that day included global npm install failures, macOS task folding, IDE selection, JetBrains copying, and weak CI settling conditions. The combined open count was 63 issues and pull requests.

dsh-TUI is a focused recommendation for someone already committed to DeepSeek Harness. Its interface treats agent sessions as durable work rather than disposable chat, and the profile boundary avoids a forked runtime. The public-beta label, exact pnpm friction, missing test target, and Windows permission fallback rule out a blanket recommendation. Try it in an isolated profile, run /doctor, and verify approvals before opening a sensitive repository.

Alternatives

ProjectWhat it isPick it when
DeepSeek Harness gh↗The official agent runtime that dsh-TUI wraps and still depends on.pick this instead when the standard DSH interface is enough or you want fewer plugin and profile layers.
Codex gh↗A terminal coding agent with its own interface, sandbox, approvals, and cloud integrations.pick this instead when you want a complete coding agent rather than a UI mounted over DeepSeek Harness.
Crush gh↗A terminal-first coding agent with a polished TUI and multi-provider model support.pick this instead when the terminal experience matters but you do not need DSH sessions, services, or plugins.

What people are saying

  1. [velocity-scout] ccch1mneyyy/dsh-TUI

Sources

  1. dsh-TUI Chinese README
  2. dsh-TUI English README
  3. dsh-TUI repository
  4. dsh-TUI v0.9.2 release
  5. Global install failure report #547
  6. JetBrains terminal copy report #439

More ai tools reviews

claudian · SkillSpector · robin · mjlab · MoGe · awesome-design-md · the whole board →