dsh-tui — a full-screen terminal UI for the DeepSeek Harness agent

[nexlineai]

---

dsh-tui — the DeepSeek Harness web UI, reimagined for the terminal.

The official dsh ships a web UI and a one-shot headless mode, but no
interactive terminal agent. dsh-tui fills that gap as an installable plugin.

❯ read the LICENSE file and tell me its license

✻ thinking
  · The user wants me to read the LICENSE file and tell me its license.

┌─ ⏱ read ──────────────────────────────────────────────────────────────────┐
│ {"file_path": "~/project/LICENSE"}                                         │
└─ ✓ done ───────────────────────────────────────────────────────────────────┘

The project is licensed under the MIT License — free to use, copy, modify…

────────────────────────────────────────────────────────── 5s · 12→45 tok

What it is

• A full-screen Claude Code / opencode-style TUI for the DeepSeek Harness agent — tools, file editing, shell, subagents, sessions, permissions, plan mode. Not a model wrapper.
• Live token streaming, reasoning blocks, boxed tool cards, markdown rendering, scrollback, prompt history, tab-complete.
• Slash commands: /model (live switch + reasoning effort), /resume, /compact, /permissions, /plan, /trajectory, /settings, /doctor, /version, /status, /reasoning, /stream.

Get it

npx @deepseek-ai/dsh web --help          # install the official dsh first
dsh plugin --profile tui add @nexlineai/dsh-tui
dsh --profile tui

Published on npm as @nexlineai/dsh-tui — use v0.1.1 or later; v0.1.0 could not be imported from a clean install.

Repo: https://github.com/nexlineai/dsh-tui · MIT · macOS + Linux · Node ≥ 20.

Feedback and PRs welcome.

[nexlineai]

Update — now on npm, v0.1.1.

The install line above changed from the git path to the npm package:

dsh plugin --profile tui add @nexlineai/dsh-tui

If you tried this earlier and it failed to load, that was a real packaging bug on my side, not your setup: three packages it imports at runtime (dsh-agent, dsh-llm, dsh-session) were declared only as devDependencies, so a clean install threw ERR_MODULE_NOT_FOUND. Fixed in v0.1.1 — sorry for the noise.

Also in this release:

• Tool cards now correlate results by callId, so parallel tool calls no longer leave the first card spinning forever while the second takes the wrong result.
• Card borders are measured from the status text instead of a fixed width — ✖ error and ⠋ running cards were rendering 1 and 3 cells too wide.
• Text is measured in terminal cells rather than UTF-16 code units, so CJK and emoji no longer break box alignment or wrapping.
• Long paths/URLs hard-break instead of overflowing the pane.

One thing worth flagging for other plugin authors here, since it cost me a while to track down: several @deepseek-ai/dsh-* packages still point their npm latest tag at an older 0.0.1-rc.x line, while dsh-agent requires ^0.1.0-rc.6 peers. npm view <pkg> version therefore reports a version that produces an unresolvable tree — list all versions and pin the current generation instead.

CI now installs the built tarball into a clean project and imports every entry point on Node 20/22/24, which is the check that would have caught this before it shipped.