MIT-licensed, keyboard-first TUI for DeepSeek Harness — installed via the official `dsh plugin` CLI and run through `deepseek`, with native Agent/Session/model/permission services, `/clarify` → `/plan` workflows, theme/language switching and a plugin center.
DSH integration
Native runtime
Author-claimed
Safety audit
Unaudited
Last verified
2026-08-27
License
MIT
01What can it help you accomplish?
Run the full DeepSeek Harness agent workflow in one keyboard-first terminal workspace
Native Agent, Session, model, permission, Settings, Profile, plugin and persistence services in a live TUI, with streaming Markdown/GFM, syntax-highlighted code, tools/files views, native scrollback and session resume
Developers who run DeepSeek Harness (dsh) and want a keyboard-driven terminal surface instead of a web or GUI client
Move an idea through Clarify and Plan without leaving the terminal
A `/clarify` guided workflow that asks focused questions, updates a reviewable Draft after each answer, and returns the accepted Draft to the composer; Harness-native `/plan` then proposes an implementation plan
DeepSeek Harness users who want to lock requirements and get implementation plans before writing code
Administer plugins, Skills, MCP servers, Profiles and Settings from the TUI
Plugin center with list/search/info/install/remove/update/reorder/source/doctor subcommands, dynamic Skill commands, MCP instances, Profile and Settings editing, and live theme/language switching
Operators who want to configure and diagnose their DeepSeek Harness agent without leaving the terminal
02How to install into DeepSeek Harness
Prerequisites
- Official DeepSeek Harness CLI — the README Quick start runs `pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8`, and `deepseek` requires `dsh` on `PATH` or `DSH_BIN`
- Node.js `^22.19.0 || >=24` and a Harness Host at or above the declared minimum `0.1.0-rc.6`
Installation steps
- 01
Install the official dsh CLI: `pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8`
- 02
Add SeekTTY to a Profile through native plugin reconciliation: `dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`
$ dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz
- 03
Optionally add the two host plugins that enable `/clarify`, then launch: `dsh plugin --profile tui add .../dsh-plugin-auxiliary-runtime-0.1.0.tgz` and `dsh plugin --profile tui add .../dsh-plugin-clarify-0.2.1.tgz`, then `dsh --profile tui`
$ dsh plugin --profile tui add .../dsh-plugin-auxiliary-runtime-0.1.0.tgz
- 04
For the bare `deepseek` launcher instead: `pnpm add --global https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`, set `export SEEKTTY_SPEC=https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`, then run `deepseek`
Verify the integration
- Run the maintained checks: `pnpm run check`
- Run stock lifecycle tests against a real dsh binary: `DSH_BIN=/path/to/dsh SEEKTTY_SPEC=/path/to/seektty.tgz pnpm test:stock`
Rollback
- Remove SeekTTY from the target Profile only (the dsh installation is untouched): `dsh plugin --profile tui remove seektty`
03DSH integration and capability boundaries
Installed as a native DeepSeek Harness plugin via the official `dsh plugin` CLI; SeekTTY is the terminal surface while Harness owns runtime state (Agent, Session, model, permission, Settings, Profile, plugin, persistence).
Keyboard-first terminal workspace
DeepSeek Harness (dsh) running in a project directory→live TUI with composer/status pinned at the bottom, native scrollback, streaming Markdown/GFM, syntax-highlighted code, tool-card views, retries, compaction, cancellation and error states
Clarify and Plan workflow
seed text via `/clarify` (whole composer, an argument, or a trailing draft token)→one focused question at a time, a Draft preview refreshed after every answer, an accepted Draft written back to the composer, and Harness-native `/plan` implementation proposals
Auxiliary usage is stored in the official `storageDomain` under `auxiliary_runtime`; prompts, answers, model output, credentials, and filesystem paths are excluded.First-run API key setup
an active Profile with no usable model Provider, when the official DeepSeek Provider exposes a writable missing credential→a centered, write-only credential prompt whose input is passed directly to Harness `credentials.set`
SeekTTY does not read it back or put it in Settings, logs, screenshots, or Session data.Saving does not make a paid validation request.Themes and live language switching
`/theme` and `/language` commands; local VS Code JSON/JSONC theme files via `/theme import`→independent interface/code themes, light/dark candidates from a 3–16 color palette, contrast checks, and live Chinese/English switching
Definitions live in the revision-protected `seektty-appearance` Harness Settings namespace.The explicit preference is stored by the official locale plugin as `locale.preference` and shared with Harness Web.Plugin center and Bundle reconciliation
npm names, Git URLs, tarballs, file URLs, local directories, JSON/HTTP catalogs→list/search/info/install/remove/update/reorder/source/doctor subcommands with preflight checks, and restart that restores workspace, Session, draft and attachments
TUI `/plugin` and native `dsh plugin` reconcile the same Profile dependencies, Bundle order, and pnpm lockfile.
04Who is it for? When not to use it?
Good for
- Developers who run DeepSeek Harness (dsh) and want a keyboard-driven terminal surface instead of a web or GUI client
- DeepSeek Harness users who want to lock requirements and get implementation plans before writing code
- Operators who want to configure and diagnose their DeepSeek Harness agent without leaving the terminal
Not for
- Node.js must be `^22.19.0 || >=24` and the Harness Host must be at or above the declared minimum `0.1.0-rc.6` — Hosts older than the declared minimum are rejected. Newer-than-tested Hosts may boot with a notice, but automatic updates install only an explicitly compatible range.
- There is currently no npm Registry release. SeekTTY `1.2.1` is only a source candidate with no `v1.2.1` release tarball published; installs use prebuilt tarballs attached to matching GitHub Releases, or you can build with `pnpm run build && pnpm pack` and point `SEEKTTY_SPEC` at the resulting tarball.
05Compatibility, maintenance and safety notes
- Node.js must be `^22.19.0 || >=24` and the Harness Host must be at or above the declared minimum `0.1.0-rc.6` — Hosts older than the declared minimum are rejected. Newer-than-tested Hosts may boot with a notice, but automatic updates install only an explicitly compatible range.
- There is currently no npm Registry release. SeekTTY `1.2.1` is only a source candidate with no `v1.2.1` release tarball published; installs use prebuilt tarballs attached to matching GitHub Releases, or you can build with `pnpm run build && pnpm pack` and point `SEEKTTY_SPEC` at the resulting tarball.
- `deepseek --update` is self-first: it checks SeekTTY before dsh, installs at most one compatible component per run, and never installs an untested gap or future Host. `DSH_BIN`, local installs, and `SEEKTTY_SPEC` overrides are left unchanged, and update failures do not block startup.
- Clarify questions, options, previews and refine feedback stay in Host memory and go stale after 15 minutes without interaction by default. The main Session receives only the Draft you explicitly submit, and auxiliary usage excludes prompts, answers, model output, credentials and filesystem paths.
MIT · actively maintained (latest release v1.2.1, 2026-08-22)
06Frequently asked questions
How do I install SeekTTY for DeepSeek Harness?
The Quick start installs the official CLI with `pnpm add --global @deepseek-ai/dsh@0.1.0-rc.8`, then adds SeekTTY through native plugin reconciliation with `dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`. Optionally add the Auxiliary Runtime and Clarify host plugins for `/clarify`, then launch with `dsh --profile tui`.
Is there a simpler launcher than dsh?
Yes — the bare `deepseek` launcher. After installing dsh, install the same SeekTTY release globally with `pnpm add --global https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz`, set `SEEKTTY_SPEC` to that tarball, and run `deepseek`. `deepseek` requires `dsh` on `PATH`, or `DSH_BIN` pointing to its executable.
Which Node.js and Harness versions are required?
Node.js must be `^22.19.0 || >=24`. The declared minimum Harness Host is `0.1.0-rc.6` and the current tested Host is official `0.1.1-rc.2`. Hosts older than the declared minimum are rejected; newer-than-tested Hosts may boot with a notice, but automatic updates install only an explicitly compatible range.
How does SeekTTY handle my API key?
When the active Profile has no usable model Provider and the official DeepSeek Provider exposes a writable missing credential, SeekTTY opens a centered, write-only prompt. Input is masked and passed directly to Harness `credentials.set` — it is not read back or stored in Settings, logs, screenshots or Session data.
How do I remove SeekTTY later?
Removing SeekTTY changes only the target Profile, never the dsh installation: run `dsh plugin --profile tui remove seektty`.
07Related DSH workflows
dsh-better-sidebar
by omdsh-dev
Full sidebar workbench with file rendering and editing, terminal, Git, and subagents; third-party plugins can register new tabs.
dsh-tui
by ccch1mneyyy
Claude Code 风格全屏终端 TUI：像素鲸鱼顶栏、双流光大字、实时工作状态行、思考流式展开、双击 Esc 时间回溯、上下文进度条 + TPS 仪表；接入 Agent preset（standard/code/minimal/cordis）、Skills、MCP、Goals、Todos、子代理，/ 命令注册表与随附技能（audit/bug/review/practice/pr_comments/release-notes/vuln-check）；纯插件挂载零核心改动。
dsh-tianshu-tui
by huiliyi37
DeepSeek Harness 交互式终端 UI 插件：会话工作区、图片端到端（剪贴板/视觉桥）、slash 下拉、审批卡片、推理可视化，纯展示层
dsh-damage-pulse
by wssfk12138
Game-style token-usage / balance damage-pulse visualization for DeepSeek/DSH.
08Data and sources
SeekTTY is the terminal surface; Harness remains the owner of runtime state.
These commands install prebuilt tarballs through native `dsh plugin` reconciliation.
dsh plugin --profile tui add https://github.com/Hilbert-beinghappy/seektty/releases/download/v1.2.0/seektty-1.2.0.tgz
This page is generated from the project’s public documentation, repository metadata and a structured parse of DSH Plugins; last verified on 2026-08-27. Found an error? Submit a correction.
Best DeepSeek Harness Plugins
Twelve plugins worth installing first — picked from the whole catalog, across every category.