dsh-tianshu-tui

Turn DeepSeek Harness into a complete, fluid coding workspace in your terminal.

中文 · English

dsh-tianshu-tui is an interactive terminal UI plugin for the official DeepSeek Harness. Its lightweight, purpose-built ANSI renderer delivers streaming Markdown, tool cards, session restore and rewind, image and vision bridging, LSP diagnostics, 16 themes, and a complete slash-command and keyboard interface.

It is a presentation-only plugin: agent state comes from the session event stream. It does not run a second agent loop or silently inject its own prompts or tools.

What you get

Quickstart

Requirements

Use the host @next tag explicitly. Do not substitute the host @latest tag (currently 0.2.1-rc.2, below the required version). The @alpha release 0.2.2-alpha.2 has known API incompatibilities and is not supported yet. This package is not a standalone CLI.

One-click install (recommended)

The installer checks Node/pnpm, installs the official CLI, wires the plugin, and launches it:

# macOS / Linux
bash <(curl -fsSL https://raw.githubusercontent.com/huiliyi37/dsh-tianshu-tui/main/scripts/install-tui.sh)

# Windows PowerShell
powershell -ExecutionPolicy Bypass -Command "irm https://raw.githubusercontent.com/huiliyi37/dsh-tianshu-tui/main/scripts/install-tui.ps1 | iex"

To install without launching, append --no-launch on macOS/Linux. On Windows, clone the repository and run powershell -ExecutionPolicy Bypass -File scripts\install-tui.ps1 -NoLaunch.

Manual install

# 1. Add the plugin to an isolated tui profile
pnpm dlx @deepseek-ai/dsh@next plugin --profile tui add @huiliyi37/dsh-tianshu-tui

# 2. Launch
pnpm dlx @deepseek-ai/dsh@next --profile tui

Follow the first-run guide to configure an API key, or enter /key. The dsh-tianshu-tui welcome screen confirms a successful install. Quit with Ctrl+Q or /exit.

If an old global dsh causes ERR_FS_EISDIR, or npm 11 runs out of heap while installing the large host dependency tree, use the pnpm dlx commands above. See Getting started for alternative setups and troubleshooting.

Everyday commands

Common commands

Keyboard shortcuts

See the interaction guide for every command, approval action, Vim binding, and terminal-protocol detail.

Updating

npm installs check for updates at startup. You can also run /update inside the TUI. Set DSH_TUI_SKIP_UPDATE=1 to disable the startup check.

pnpm dlx @deepseek-ai/dsh@next plugin --profile tui add @huiliyi37/dsh-tianshu-tui

Current release: 1.0.0-rc.4, adapted to host 0.2.1-rc.4. This release fixes #61: WSL/native API-key paste, provider directory and account entry behavior, plus custom pi-ai endpoints, model discovery, and existing-route editing. See CHANGELOG.md for release history, or run /changelog inside the TUI.

Documentation

Design principles

• Event-driven: all rendered state derives from session events; live rendering and restored transcripts share the same bridge.
• Presentation boundaries: no private prompt, tool, or context surfaces, and no direct mutation of agent request bodies.
• Explicit degradation: missing optional host services produce an actionable message instead of a blank panel or a startup failure.
• Terminal-friendly: supports narrow screens, 16-color terminals, and NO_COLOR, with handling for wide CJK text, long output, and streaming refreshes.

See the architecture guide and ADAPTER.md for implementation details and boundary constraints.

Known limitations

• Re-interrogating images with ask_image requires the companion vision-ask plugin; basic image submission and vision bridging do not.
• LSP servers start lazily but may remain resident in large repositories; rootUri follows the first session's working directory after a session switch.
• Upstream schedule depends on the Web sessionController, so this TUI does not mount that tool surface yet.
• Host 0.2.2-alpha.2 changes model-selection and preset APIs. Stay on host 0.2.1-rc.4 until dedicated adaptation work is complete.

Contributing

Issues and pull requests are welcome. Read the contribution guide first, then run:

npm run typecheck
npm test
npm run build

Official site and community

Community ecosystem

License and provenance

Open source under Apache-2.0. The terminal renderer evolved from the author's Tianshu-harness. See SOURCE-MAP.md and NOTICE for file-level provenance and modification notices.