deepseekplugins

DeepSeek Harness plugin

dsh-tui-pro

Interactive terminal UI plugin for DeepSeek Harness

Development & Runtime
Jump to install

Source facts

Repository
lk251066/dsh-tui-pro
Latest update
Aug 21, 2026
Category
Development & Runtime
GitHub stars
1
Format
plugin
Package path
packages/dsh-tui
Catalog evidence
Upstream dsh.bundle evidence
Evidence path
packages/dsh-tui/package.json#dsh.bundle
Checked against
0.1.0-rc.8
Upstream check date
2026-08-20

This evidence comes from the upstream catalog. This site has not installed, run, or security-reviewed the plugin.

Install

Start with a prompt that asks an agent to review the GitHub repository and source. Switch to the command if you want to install it yourself.

Copy this prompt into DSH, Codex, or another agent and ask it to review the GitHub repository and source first.

Do not install or run any commands yet. Read this plugin's GitHub repository, README, and relevant source code. Then answer the questions below clearly and directly so I can decide whether it fits my needs:

1. What is this plugin, and what problem does it solve?
2. Who is it for, and what are its typical use cases?
3. How is it used after installation? Include one minimal example.
4. What known limitations or privacy, security, compatibility, or maintenance risks does it have?
5. Give a clear recommendation: recommend, conditionally recommend, or do not recommend, with reasons.

Distinguish statements documented by the repository, inferences from source code, and unknowns. If evidence is insufficient, say so explicitly. Do not guess or simply repeat the README.

GitHub: https://github.com/lk251066/dsh-tui-pro/tree/HEAD/packages/dsh-tui
Plugin: dsh-tui-pro
Author: lk251066

Check the source files

Read the README and other files from this plugin directory before installing.

File explorer3 files
README.mdSource · read only

@lk251066/dsh-tui

English | 简体中文

A multi-session terminal workbench plugin and profile bundle for DeepSeek Harness.

![dsh-tui-pro switching between persistent project sessions](./assets/session-workbench.gif)

Install

This package requires Node.js ^22.19.0 || >=24.0.0, the dsh CLI, and DEEPSEEK_API_KEY configured outside the package.

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

Without a global dsh installation:

npx -y @deepseek-ai/dsh@latest plugin --profile tui add @lk251066/dsh-tui
npx -y @deepseek-ai/dsh@latest --profile tui

The package declares its own dsh.bundle.patch; a separate bundle package is neither required nor supported.

Runtime behavior

  • Only the transcript scrolls; the input, live status, plan, and sidebar remain fixed.
  • The terminal title shows the mounted session and animates the process-wide running-session count; supported terminals also expose taskbar progress.
  • One durable Assistant remains outside project workspaces, uses a permanent working directory, and manages active project sessions.
  • Project sessions are grouped by workspace, retain their ordering, and resume from the launch directory.
  • Enter steers a running turn, Tab queues the next turn, Esc recovers queued input, and double Esc browses checkpoints.
  • Model, reasoning effort, image draft, input draft, and memory state remain independent per live session.
  • Thinking, tools, code, diffs, plans, todo progress, and subagents use structured renderers.
  • Final replies always render in full. Tool bodies have compact and expanded states; tool identity, status, and failures never disappear.
  • Model, effort, skill, theme, setting, permission, question, and approval selectors use the fixed bottom area.
  • Transcript selection copies plain text without ANSI styles; Alt+V attaches clipboard images.

Starting in a project directory resumes its first manually ordered active session or creates one when none exists. /new creates another session for the current project, /new <path> opens another project, and /assistant opens the fixed Assistant. /quit closes the current project session while preserving history; /exit closes the TUI.

Use /sessions for complete history and /switch for the compact active-session selector. Alt+Left and Alt+Right cycle active project sessions. Empty-input Delete closes the selected project session.

Input and media

While the agent runs, Enter sends immediate steering and keeps a receipt visible until the current turn claims or discards it. Tab queues the next turn. Empty Up recalls the latest submission. With an empty editor, Esc restores the latest queued message before a later Esc can cancel the turn.

Drag across transcript text to copy it. Alt+V reads a clipboard image into the current session draft. PNG, JPEG, WebP, and GIF are supported; Windows uses PowerShell, macOS requires pngpaste, and Linux uses wl-paste or xclip.

Commands

The TUI owns /help, /model, /effort, /clear, /details, /theme, /rename, /fork, /status, /context, /agents, /jobs, /settings, /memory, /skill, /export, /sessions, /switch, /new, /assistant, /quit, and /exit. The selected dsh composition may register additional commands.

/skill opens a searchable bottom selector. /memory on|off persists memory state per session; the Assistant defaults on and project sessions default off. Enabled sessions share durable user facts through plugin-local save, search, correction, and deletion tools. The store has no fixed-count eviction; automatic recall remains bounded to keep model context finite.

Configuration

- id: tui
  name: '@lk251066/dsh-tui'
  config:
    sidebarWidth: 32
    assistantCwd: '/absolute/path/to/assistant'
    showReasoning: false
    maxToolOutputLines: 6

assistantCwd defaults to $DSH_HOME/assistant, or ~/.dsh/assistant when DSH_HOME is unset. It is recorded when the fixed Assistant is created; a persisted Assistant resumes with its recorded directory. sidebarWidth accepts values of 24 or greater. The sidebar hides below 65 inner columns, and a height of at least 24 rows is recommended.

The package also exports @lk251066/dsh-tui/prompt, @lk251066/dsh-tui/invariant, @lk251066/dsh-tui/memory, and @lk251066/dsh-tui/workspace-agent-loop for the bundled composition. Treat cordis.patch.yml as the supported entry path.

Development and support

See the repository development guide, verification guide, and issue tracker.

License

[MIT](./LICENSE). Based on the original TUI implementation from DeepSeek Harness.

Back to searchOpen GitHub repository

More related plugins

View category