Dsh Tui

@dsh-tui/dsh-tui

English | [中文](README.zh.md)

An interactive terminal (TUI) front door for [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) agents — a Claude Code / Codex-style chat interface in your terminal, installed as an out-of-tree dsh plugin bundle. Built on [`@earendil-works/pi-tui`](https://www.npmjs.com/package/@earendil-works/pi-tui).

It composes over the official `@deepseek-ai/dsh-base` bundle, so the whole plugin ecosystem — shell and filesystem tools, skills, subagents, workflows, sandbox approvals — is the same one the official web surface uses. Nothing is forked.


Features

• Streaming model output and reasoning, rendered as Markdown
• Tool-call cards with terminal / diff / generic render intents; Ctrl+O cycles collapsed → expanded → hidden
• Approval and ask_user_question dialogs, plan-mode review included
• @file path autocomplete and @session reference cards
• Slash commands: /model (with reasoning-effort selection), /resume, /compact, /details, /help, and every command other plugins register
• Standing todo panel, token usage and context-pressure status line, session titles
• Configurable theme; truecolor detected from COLORTERM

Install

Requires Node `^22.19 || >=24` and the `dsh` CLI (`npm i -g @deepseek-ai/dsh@next`).

dsh plugin --profile tui add @dsh-tui/dsh-tui
dsh --profile tui                                      # start a session in the current directory
dsh --profile tui --resume                 # resume a persisted session

To track the repo instead of the npm release, use `add github:dsh-tui/dsh-tui`. Git-hosted plugins build on install via their `prepare` script, which pnpm blocks until you allow it: if that `add` fails, append the key it prints under `allowBuilds` in `~/.dsh/profiles/tui/pnpm-workspace.yaml` and re-run —

allowBuilds:
  "@dsh-tui/dsh-tui": true

Set `DEEPSEEK_API_KEY` in your environment (or a `.env