DeepSeek-TUI

dsh --profile tui: a terminal chat interface for DeepSeek Harness (dsh). Install one plugin and hold an ongoing conversation with your agent in the terminal — review tool execution, steer mid-turn, queue follow-ups — with the interaction aligned to the official web client, no browser needed.

The headless dsh form fits one-shot tasks (submit, run, print the result to stdout); for an ongoing session, use dsh --profile tui.

中文版 · Feature-alignment baseline: [FEATURE-CHECKLIST.md](FEATURE-CHECKLIST.md) · Choosing between clients: [see below](#choosing-between-dsh-clients)

---

Highlights

The same agent as the official web client: session records, settings, and permission/plan/workflow plugins are all shared — the agent you talk to in the terminal is the one from the web, with no HTTP hop and no feature degradation.

Aligned feature-by-feature against the web baseline: a 148-point comparison (≈ 93% coverage); bilingual UI (zh/en): copy reused verbatim and visual colors taken from the web implementation; status-area layout carried over — the terminal experience converges on the web client instead of inventing a separate one.

Rendering & tool-execution visualization: streaming Markdown, graded reasoning blocks, syntax highlighting, TeX math, Mermaid diagrams; tool cards with exit codes, highlighted Read cards, grep/glob grouping, web_search citations, run_code sub-call trees; produced files get OSC 8 links (Cmd-click to open).

Install and go — dsh itself untouched: mounted as a plugin into the tui profile, no dsh source changes, no dependency patches; the rendering engine pi (the independent open-source terminal UI library from earendil-works) is embedded as a vendored snapshot — pinned version, controllable upgrades.

Keyboard-driven: Tab focus ring + Enter expand/collapse (thinking blocks / tool cards / long messages); Ctrl+Enter interrupts the current turn and sends, Shift+Tab cycles session modes (default / plan / full access); three keymap presets — Claude Code / pi / OpenCode style (/keymap to switch); /model and /permission support enum picking or direct arguments; @ file-reference completion (content auto-attached on send), $EDITOR editing for config and the current input, command aliases, OSC 52 copy.

Session-level panels: goal / todo / jobs / workflow run tree (full run→member hierarchy); /status, /tokens, /cost session info; /config provider management (list / add wizard / $EDITOR settings.yaml).

Installation

Prerequisites: a working dsh environment (Node ≥ 22.19, pnpm).

# Install from npm (recommended)
dsh plugin --profile tui add @mcswift/dsh-tui

# Or develop locally: mount the source (lib/ is the profile's load entry;
# pnpm build after each change)
git clone https://github.com/TheMcSwift/DeepSeek-TUI.git
dsh plugin --profile tui add link:/path/to/DeepSeek-TUI
cd DeepSeek-TUI && pnpm install && pnpm build

Quick start

$ dsh --profile tui                     # new session (regular rendering by default)
$ dsh --profile tui --resume <id>       # resume a specific session
$ dsh --profile tui -c                  # resume the most recent session
$ dsh --profile tui                     # default regular: main-screen output stays in terminal scrollback (no in-app scroll/mouse; `[` exports the transcript)
$ dsh --profile tui --fullscreen        # switch back to the alt-screen viewport (the pre-2026-08-20 default: in-app scroll/mouse/search-jump)

dsh tui — DeepSeek Harness terminal client
Esc/Ctrl+C interrupt (busy) · Ctrl+C press twice to quit (idle) · Ctrl+Enter interrupt & send · `/` slash menu · Ctrl+/ command palette
Ctrl+R sessions · Ctrl+G model · Ctrl+P presets · Ctrl+F search · Ctrl+B fork · Ctrl+Y rate
Ctrl+X edit input in $EDITOR · Ctrl+W workspace · Ctrl+T thinking · Ctrl+K fold · Ctrl+E exit plan
Ctrl+O fold/expand jobs · Ctrl+L trajectory · Alt+Enter steer · Alt+Up retrieve queue · Tab focus ring/follow-up · Enter send (busy=steer)/expand-collapse

Usage

Commands

Command aliases: exit→quit · clear→new · ?→hotkeys · r→resume · m→model · perm→permission · language→lang (resolved in the slash chain; the menu still shows the canonical names).

Environment variables

Choosing between dsh clients

Our trade-offs: runs only on the machine where dsh is installed (no remote mode); pi version pinned (0.84.1 vendored snapshot), upstream fixes need manual follow-up; browser abilities (images/drag-drop/settings forms) degrade to terminal shapes — images → placeholder rows, settings page → /config; regular rendering by default (output stays in terminal scrollback), in-app search-jump/scrolling unavailable (use the terminal's native Cmd+F), --fullscreen switches back to the viewport mode.

For developers

Data flow: SessionEvent → fold() → ViewDocument → app.render() one-way; fold() is pure (no cordis, no pi), and every new event type gets a regression in tests/projection.spec.ts.

Out-of-tree constraints: cordis.patch.yml is required (its absence is a hard error); insert rows may only reference plugins already shipped with the dsh install. More in [DESIGN.md](DESIGN.md) §10 and [ARCHITECTURE.md](ARCHITECTURE.md).

pnpm typecheck        # strict tsc
pnpm test             # vitest units (395)
pnpm build            # tsc build into lib/
python3 scripts/e2e-pty.py           # 9-scenario PTY end-to-end (real dsh + mock LLM)
python3 scripts/e2e-pty.py --only-questions   # one scenario

Docs

Credits

This project was written entirely with dsh and the DeepSeek model: planning, implementation, review, and documentation were all done in dsh-driven deepseek-v4-pro sessions (every commit carries an Assisted-by: dsh trailer).

Inspired by: the official web client (feature baseline, copy and design tokens), pi (rendering engine), Claude Code / pi interaction style, and the community ccch1mneyyy/dsh-TUI (brand block: DeepSeek pixel whale + gradient DEEPSEEK wordmark + 探索未至之境！).