# dsh-TUI

> A Claude Code-style fullscreen terminal UI plugin for DeepSeek Harness with live agent status, session management, and image preview.

dsh-TUI is an open-source terminal interface for DeepSeek Harness (DSH), published under the MIT license by ccch1mneyyy and currently in public beta. It provides a fullscreen, Claude Code-style experience with streaming Markdown, tool cards, live work status, and session management, installed through npm.

## What It Is

dsh-TUI is a plugin that mounts onto DeepSeek Harness and supplies the interactive terminal layer. The project states it makes zero core changes: it consumes DSH's public exports, and uninstalling leaves no patches behind. Model calls, tool execution, fork/resume, compaction, and persistence remain with DSH services, while the TUI handles interaction and presentation.

## Terminal Interaction and Agent Status

The interface includes streaming Markdown, structured tool cards, slash-command and @ file completion (with line ranges such as #L12-14), history search, and inline or alternate-screen rendering. Kitty and Sixel terminals get image previews, and Mermaid diagrams and LaTeX math can be rendered. A status area shows live activity, context usage, tokens per second, cache hit rate, reasoning effort, token counts, and Git and session information. A pixel-whale header and a Chinese/English UI switch are included.

## Session Workflow and DSH Integration

Sessions are managed with commands such as /new, /resume, /compact, /export, and /btw, plus a double-Esc rewind or fork. A unified session manager covers /resume, /agentview, and /bg. The plugin connects to DSH agent presets, skills, MCP, goals, todos, subagents, and questionnaires. The README also documents experimental Claude and Codex backends, and a migrate command that imports conversation histories from other coding agents.

## Setup Path

Install with npm globally, then run dsh-tui. Node.js ^22.19 or 24+, pnpm 10+, and a terminal TTY are required, and running models with the DeepSeek API-key route needs DEEPSEEK_API_KEY. Windows, macOS, and Linux are supported. dsh-TUI adds no sandbox of its own and follows the active DSH profile's filesystem, shell, and approval policies.

## Features
- Fullscreen Claude Code-style terminal UI
- Streaming Markdown and structured tool cards
- Slash-command and @ file completion with line ranges
- Kitty/Sixel terminal image preview
- Mermaid diagram and LaTeX math rendering
- Live status: context bar, TPS gauge, cache hit rate, tokens
- Session manager with resume, compact, export, fork and double-Esc rewind
- Session import from Claude Code, Codex and other agents
- Pixel whale pet and themes
- Chinese/English UI
- Experimental Claude and Codex backends
- Virtualized rendering for long sessions

## Integrations
DeepSeek Harness, MCP, VS Code, Claude Code, Codex, Herdr

## Platforms
WINDOWS, MACOS, LINUX, WEB, API, VSC_EXTENSION, CLI

## Pricing
Open Source

## Version
v0.14.0

## Links
- Website: https://dshtui.com/
- Documentation: https://github.com/ccch1mneyyy/dsh-TUI/blob/main/docs/getting-started.md
- Repository: https://github.com/ccch1mneyyy/dsh-TUI
- EveryDev.ai: https://www.everydev.ai/tools/dsh-tui