ccch1mneyyy/dsh-TUI

dsh‑TUI – a terminal UI for DeepSeek Harness

What it is – dsh‑TUI is a plug‑in that turns the command‑line into a rich, interactive UI for the DeepSeek Harness (DSH) AI‑assistant platform. It runs entirely inside a terminal (via Ink/Yoga) and adds visual elements such as a pixel‑whale mascot, live status bars, markdown rendering, image thumbnails, Mermaid diagrams, LaTeX math, and a clickable timeline.

Key features

• Pixel‑whale pet – animated “whale” mascot that reacts to the first task.
• Terminal‑native UI – streaming markdown, tool‑card panels, slash (/) and @ completions, history search, bilingual (zh/en) interface.
• Rich media – Kitty/Sixel image previews, Mermaid diagrams rendered as Unicode, LaTeX formulas shown as Unicode or terminal images.
• Live session stats – TPS gauge, token usage, cache hit rate, cost estimate, model‑switching, sub‑agent tracking.
• Session workflow – commands like /new, /resume, /compact, /export, /rewind, /bg, and a full‑screen draft editor.
• Integration – works as a pure DSH plug‑in (no core changes), supports VS Code terminal, Herdr panes, and can import conversation histories from other agents (Claude Code, Codex, OMP, etc.).
• Extensible – plug‑in ecosystem for browser interaction, computer‑use tools, and custom extensions.

Who might use it

• Developers who already use DeepSeek Harness and want a richer, visual experience without leaving the terminal.
• Power‑users who run long‑running AI sessions and need live metrics, timeline navigation, and easy session management.
• People who prefer a text‑based environment but still want to view images, diagrams, or LaTeX output.

Installation & quick start

# Global install of DeepSeek Harness CLI and the TUI plugin
npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

# Launch the UI (alias `dst` works too)
dsh-tui

Prerequisites: Node ≥ 22 (or 24) and a configured DEEPSEEK_API_KEY. The plug‑in targets DSH 0.2.0‑rc.1 but retains compatibility with older hosts.

Typical workflow

1. Start dsh‑tui – the whale greets you.
2. Type prompts; use Enter to send, Tab for completion, Ctrl+Enter to interrupt.
3. Navigate the timeline rail to revisit earlier turns (double‑Esc rewinds).
4. Run built‑in commands (/model, /new, /bg, /export, etc.) to manage sessions.
5. View live stats (TPS, token count, cost) on the status bar.
6. Use /migrate to import histories from other agents, then resume them with /resume.

Configuration – Settings are stored in a DSH profile; you can adjust presets, themes, MCP servers, and permission presets via the /settings UI or the configuration docs.

Security note – On Windows the default profile grants “danger‑full‑access”; users should review the profile’s permission presets before handling sensitive data.

Development – The project uses TypeScript, builds with pnpm, and runs CI on Node 24. Contributions are welcomed via the usual GitHub workflow; a plugin ecosystem (dsh‑tui‑ecosystem) is provided for community extensions.

Where to learn more – Full documentation lives under docs/ (getting‑started, keys & commands, architecture, plugin development, roadmap, etc.). Community chat is available on WeChat and QQ.

---

All information above is taken directly from the repository’s README.