dsh-TUI - Terminal UI Plugin for DeepSeek Harness
A Claude Code-style TUI plugin for DeepSeek Harness with pixel whale bar, live status, streaming thoughts, and time rewind.
- Source repo
- ccch1mneyyy/dsh-TUI
- Stars
- ★ 5.2k
- Last updated
- today
- License
- MIT
- Primary language
- TypeScript
- FA score
- 58/100 · Major gaps
At a glance
- How it runs
- Works with
- Platform-specific
- Cost
- Free software; you pay for model usage
- Setup effort
- Low · running in minutes
- You'll need
- Typical use
- Developers using DeepSeek Harness in the terminal who want a more visually appealing and informative interface without losing functionality.
- Not a fit if
- Users of Claude Code, Codex or other agents; this plugin only works with DeepSeek Harness
- Windows users working beside sensitive credentials or untrusted repos; the default profile is danger-full-access with approval set to never
- Source review
- 58/100 · Major gaps
What does this agent do, and when should you use it?
dsh-TUI is a plugin designed to enhance DeepSeek Harness with a Claude Code-like terminal user interface. It features a pixel whale top bar, dual flowing-glow title, real-time work status, streaming thought expansion, double-Esc time rewind, blue-white context progress bar, and TPS gauge. As a pure plugin, it requires no core modifications and can be cleanly installed or removed. It has been featured by the official DeepSeek Harness WeChat account and dshfind, and reached #7 on GitHub Trending. The UI supports mouse and keyboard interactions, terminal image previews (Kitty/Sixel), session management via /resume and /agentview, multiple themes, and VS Code integration. Installation is straightforward via npm.
Once installed, dsh-TUI runs as a plugin within DeepSeek Harness, providing a full terminal UI. It displays real-time work status, TPS, cache hit rate, reasoning level, token usage, and Git/session info. It supports displaying images in the terminal: when Kitty or Sixel is available, it renders thumbnails of user attachments and tool results; clicking opens a preview with zoom, pan, and navigation. For session management, it offers /resume to browse history, /agentview for an overview, plus /new, /compact, /export, and /btw commands. It features hot-swappable models, vim editing mode, mouse selection, and full-screen draft editing. Permission handling relies on DSH's profile system; it does not implement its own sandbox.
- Developers using DeepSeek Harness in the terminal who want a more visually appealing and informative interface without losing functionality.
- Users familiar with Claude Code who want a similar UX while staying on DeepSeek Harness.
- Users who frequently handle image attachments (e.g., screenshots, design files) and want in-terminal previews.
- Developers managing multiple sessions who need to quickly switch between past conversations using /resume and /agentview.
- Terminal enthusiasts who enjoy novelty, such as the pixel whale mascot.
- Users who prefer working inside VS Code's integrated terminal and want a companion extension.
How do you install or deploy this agent?
Prerequisites: Node.js, deepseek-harness, and a DEEPSEEK_API_KEY. Install globally: npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui. Run dsh-tui or dst to start. For manual installation, execute install.sh in the repo root, or use: dsh plugin --profile dsh-tui add @deepseek-harness-tui/dsh-tui.
How do you use this agent?
Run dsh-tui or dst from your terminal. Ensure DEEPSEEK_API_KEY is configured. The splash screen shows the whale animation; clicking may trigger interactions. Type / to see available commands like /resume, /agentview, /new. Mouse actions include clicking cards, dragging, and selection. Ctrl+Shift+E opens full-screen draft editor. See /settings and docs/interaction.md for shortcuts.
What are this agent's strengths and limitations?
- Zero core changes; pure plugin, clean uninstall.
- Rich feature set including live status, image preview, session management, vim mode, etc.
- Recognized by DeepSeek Harness official WeChat and available on VS Code Marketplace, adding credibility.
- Visually appealing with unique pixel whale animations.
- Multi-theme support and terminal image protocol adaptation (Kitty/Sixel).
- Only works with DeepSeek Harness; not portable to other model providers.
- Requires Node.js, deepseek-harness, and an API key, increasing setup complexity.
- Windows default permission preset is danger-full-access; users must harden configs to avoid security risks.
- As a third-party plugin, stability may be affected by upstream Cordis/DSH changes.
How does this agent compare with similar options?
Key facts side by side with the most closely related agents.
| Agent | Source review | Form / cost | Stars | Updated | Language | Full support on |
|---|---|---|---|---|---|---|
| dsh-TUI - Terminal UI Plugin for DeepSeek Harness This agent | 58 · Major gaps | CLIFree + model costs | ★ 5.2k | today | TypeScript | — |
| wcgw Local Coding Terminal | 45 · Major gaps | MCP serverFree + model costs | ★ 678 | 1mo ago | Python | Claude.ai |
| DeepSeek Harness for GitHub | 77 · Good | Chat botFree + model costs | ★ 46 | today | TypeScript | — |
| Codewhale Terminal Coding Agent | 75 · Some gaps | CLIFree + model costs | ★ 41k | today | Rust | OpenAI API · Claude API |
How does FollowAgents rate this agent?
Why each dimension lost points
Evidence shows: README explicitly states it uses DSH profile's permission policies, does not implement its own sandbox, and warns about Windows default danger-full-access and approval never, advising users to check configuration. This reflects consideration of least privilege, but actual permission grants are controlled by DSH, and the plugin itself does not demonstrate least privilege implementation. User confirmation: mentions approval policies and /permission command, but does not detail user confirmation flow. Data flow transparency: README mentions status line showing TPS, cache hit rate, etc., but does not explain where data flows. Sensitive data handling: mentions credentials and untrusted repository environments, but does not explain how sensitive data is handled. Dependency security: package.json lists many dependencies, but no security audit or vulnerability report is provided. External effects: plugin modifies terminal display, may invoke system image viewer, but does not explain specific impact scope. Rollback: explicitly supports double-Esc time rewind and uninstall leaves no core patches, but does not detail rollback mechanism. Source attribution: clearly acknowledges dsh-ui-whale author, but does not explain other code sources.
Evidence shows: README describes rich features, but no self-consistency test results. Dependency availability: depends on many @deepseek-ai packages, but does not state their availability. Failure messages: mentions error handling like ERR_PNPM_IGNORED_BUILDS, but does not provide user-friendly failure message examples.
Evidence shows: README clearly targets TUI enthusiasts, scenarios include terminal interaction, image preview, etc. Capability boundaries: states it does not preinstall generic skills, skills are managed by DSH. Trigger precision: mentions shortcuts and commands, but does not detail trigger conditions. Environment fit: supports Windows Terminal, Kitty, Sixel, etc., but does not cover all environments.
Evidence shows: Information architecture is clear, with documentation index. Install notes are detailed, including npm and install.sh. Naming stability: provides dsh-tui and dst commands. Examples and FAQ: has documentation links, but no concrete examples. Known limitations: mentioned in architecture doc, but not detailed in README. License: MIT license file exists. Versioning changelog: package.json has version, but no CHANGELOG. Maintenance responsibility: has community and issue links, but no explicit maintainer.
Evidence shows: Output usability: provides rich terminal interaction features, output format is aesthetic. Marginal value: as a plugin, provides additional features, but not compared with existing tools. Cost-benefit: simple installation, but many dependencies may increase complexity.
Evidence shows: Claim traceability: README claims official inclusion, but no verifiable links. Cross-source corroboration: mentions dshfind and GitHub Trending, but no concrete evidence. Fact-inference separation: README distinguishes feature descriptions and acknowledgments, but some claims like 'official inclusion' are not clearly separated.
- Publisher identity is unverified; proceed with caution.
- Many dependencies on @deepseek-ai packages; verify their security and availability.
- Windows default permission configuration is dangerous; users must tighten it themselves.
- Claims of official inclusion in README lack verifiable evidence.
Recent releases
Latest entries from the project's GitHub Releases. Notes are quoted from upstream as written, not rewritten or tested by FollowAgents.
-
v0.16.1 v0.16.1 — 独立入口启动回归与更新包体修复
Release notes excerpt
这是 v0.16.0 的补丁发版，修两个会影响启动和更新体积的问题。 修复 - 独立入口在装有第三方 bundle 的 profile 上启动失败 — #1577 把后端装配放到了延迟根守卫之前。profile 的 dsh.profile.bundles 里有 @deepseek-ai/* 和 dsh-tui 之外的包时，装配会提前解析组合根，根能力守卫立刻装上且撤不掉；DSH 0.2.0-rc.2 的基础行在 ctx.root.accessor('invocation') 处被拒，plugin-manager、llm、commands 等 9 个必需插件无法激活，agent-loop 等不到 llm。现在延迟紧跟在入口绑定根之后，排在装配和内核选择之前，恢复 0.15.0 的守卫时序。([#1598](https://github.com/ccch1mneyyy/dsh-TUI/pull/1598) by @MomentDerek；维护者修复 by @ccch1mneyyy) …View on GitHub ↗ -
v0.16.0 v0.16.0 — 实验性 Agent Teams、Auto review 与 DSH 0.2.1 适配
Release notes excerpt
自 v0.15.0 以来，dsh-TUI 跟进 DSH 0.2.1 版本线，加入实验性 Agent Teams 与 Auto review 权限预设，并继续完善插件安装、Codex/Claude 后端与终端交互。 亮点 - DSH 0.2.1 版本线 — 主适配线升到 0.2.1-rc.2（同时支持 0.2.1-alpha.5、0.2.0-rc.1/rc.2 等已验证版本）；启动时按已装 DSH 报告版本线，契约漂移会在 CI 失败。([#1593](https://github.com/ccch1mneyyy/dsh-TUI/pull/1593)、[#1580](https://github.com/ccch1mneyyy/dsh-TUI/pull/1580) by @CikeSeven) …View on GitHub ↗ -
v0.15.0 v0.15.0 — 独立入口、原生光标、模型与侧问改版
Release notes excerpt
自 v0.14.0 以来，dsh-TUI 有了自己的启动入口，带来重做的模型选择器、终端原生光标动画、任务完成通知、侧问面板改版和跨内核会话预加载。本版同时扩展插件查询命令、发布第一版冻结的插件契约，并补齐启动页图片输入、侧栏拖拽、樱花粉主题、权限记忆与上游断链重试。 升级与行为变化 - 插件命令改名：/plugins 改为 /plugin，本版已移除旧命令，没有保留弃用别名。手动命令、快捷调用和自动化请改用 /plugin，例如 /plugins check … 改为 /plugin check …。（#1504 by @Lucas2011wastaken） - TUI 设置迁移：/settings 的 dsh-tui 分区改存 ~/.dsh-tui/settings.json，DSH、Claude、Codex 共用。首次启动自动导入 profile 补丁和旧 ~/.dsh/settings.yaml 中的可编辑字段；!!js 表达式不导入。旧 profile 中残留的字段仍可能在 DSH 内核下提供部署默认值，建议迁移后清理重复配置。（#1441 by @MomentDerek；#1483 by @ccch1mneyyy） …View on GitHub ↗