GETTING STARTED

Install and Start dsh-TUI

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

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

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