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.
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.
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.
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 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.