Getting started

Install and Start dsh-TUI

Everything required to open your first DeepSeek Harness session in the dsh-TUI terminal interface.

On this page
  1. Requirements
  2. Installer bundle (recommended)
  3. Install from npm
  4. Start or resume a session
  5. Updates and troubleshooting

Requirements

dsh-TUI runs in a real terminal TTY. A modern terminal such as Windows Terminal, iTerm2, kitty, WezTerm, Ghostty, or a common Linux terminal is recommended.

  • Node.js ^22.19 or version 24 and newer
  • pnpm 10 or newer
  • The official @deepseek-ai/dsh CLI
  • A DEEPSEEK_API_KEY for model access

Installer bundle (recommended)

Prefer not to type commands? Download the bundle from the homepage, extract it, and double-click install.bat (or run sh install.sh on macOS / Linux). The script checks and installs Node.js (winget on Windows), pnpm, the official dsh CLI, and dsh-TUI, then guides you through the DEEPSEEK_API_KEY — just press Enter a few times.

  • Direct link: https://dshtui.com (accessible in mainland China)
  • GitHub mirror: dsh-tui-setup.zip in ccch1mneyyy/dsh-TUI Releases
  • Falls back to the npmmirror registry when the npm official source fails

Install from npm

Install the official CLI and the TUI plugin globally. The package provides the dsh-tui command and does not require edits to the DSH core.

npm install -g @deepseek-ai/dsh @deepseek-harness-tui/dsh-tui

Start or resume a session

The first run initializes the dsh-tui profile automatically. Use --resume to reopen the latest session.

dsh-tui

# Resume the latest session
dsh-tui --resume

Updates and troubleshooting

When an npm update is found, run /update to upgrade and restart into the current session. If startup fails, verify that Node.js, pnpm, dsh, and the API key are available in the current shell.

  • Check versions with node --version and pnpm --version
  • Run /doctor for environment diagnostics
  • Verify the API key in the active shell
  • Prefer Windows Terminal or PowerShell 7 on Windows