dsh-TUI

Name: ccch1mneyyy/dsh-TUI
Author: ccch1mneyyy

ccch1mneyyy/dsh-TUI

Claude Code-style full-screen terminal UI: pixel-whale header, live status line, and streaming thought expansion.

1,50763TypeScriptMITSource

Install

Add dsh-TUI to DeepSeek Harness

via npm

Resolves a published tarball rather than cloning the repository.

via GitHub · npm package

Due diligence

Before you install dsh-TUI

Source of record: ccch1mneyyy/dsh-TUI — present in the community registry that DSH's own plugin market installs from.
Licensed under MIT.
Detected: terminal surface. Read the source before granting these.
A listing here is not a security review. Plugins run with your agent's permissions.

What dsh-TUI does

Event streams pass through a projection lattice and converge on a bounded terminal surface.

dsh-TUI is a DeepSeek Harness plugin that provides a full-screen, Claude Code-style terminal interface for agent sessions. It adds a pixel-whale header, live work status, streaming thought expansion, context progress, TPS and token information, while retaining DSH’s existing session and tool services.

The plugin mounts as a Cordis patch in the dsh-tui profile rather than modifying the DSH core. Session and tool events are projected into React components and rendered through Ink/Yoga; the persistent session log remains the source of truth, while activity tracking supplies TUI-only status data. DSH services continue to own model calls, tool execution, fork/resume, compaction and persistence. It also reads and writes named local settings such as ~/.dsh-tui/agent-preset.json and ~/.dsh-tui/model.json, and can load themes from ~/.dsh-tui/themes/<name>.json.

dsh-TUI is intended for developers who want terminal-native interaction, message search, file and command completion, slash commands, session rewind/fork and detailed agent telemetry. It is a poor fit where a plain DSH interface is preferred, or where no usable TTY is available. The terminal surface is the plugin’s main reach: it captures keyboard and mouse input, renders session content, and supports terminal clipboard paths including OSC 52 and local clipboard utilities. Running a model also requires DEEPSEEK_API_KEY; startup requires the official dsh CLI and pnpm 10 or later.

dsh-TUI documentation

How it behaves

The dsh-tui profile applies a Cordis patch to DSH and projects session and tool events into terminal-rendered React components. Ink/Yoga handles rendering. Session logs remain the source of truth; model calls, tool execution, fork, resume, compaction and persistence remain with DSH services. TUI-only activity data is kept in an in-memory ActivityTracker.

The interface supports streaming Markdown, structured tool cards, message and session search, @ file completion, text and image attachments, inline or alternate-screen rendering, and /lang language switching. Long sessions use event-driven projection, differential terminal output, message virtualisation, replay merging and bounded caches.

Configuration

Setting	Behaviour
`DSH_TUI_THEME`	Takes precedence over the persisted theme and automatic terminal-background detection.
`~/.dsh-tui/agent-preset.json`	Persists the selected agent preset.
`~/.dsh-tui/model.json`	Persists the model selected through `/model`.
`~/.dsh-tui/themes/<name>.json`	Stores custom JSON themes.

Built-in themes include auto, light, dark and dark-ansi. The liangshen preset is shipped with the TUI alongside the official standard, code, minimal and cordis presets. A preset cannot be changed after a conversation has produced messages; it can be changed in a blank conversation.

Commands

Session commands include /new, /resume, /rename, /workspace resume|rename|open, /clear, /compact, /export, /trace and /btw. Status and setup commands include /status, /cost, /doctor, /config, /init, /tokens, /permissions and /add-dir. Model and interface commands include /model, /thinking, /theme, /lang, /vim, /terminal-setup, /help and /exit. /mcp reports MCP connection status, while /agents, /plan and /goal expose agent or registry features. /update updates and restarts the TUI, restoring the current session.

Requirements and limits

A usable terminal TTY, the official dsh CLI and pnpm 10+ are required. Model use requires DEEPSEEK_API_KEY. Windows can use the repository’s dsh-tui.cmd; macOS extended ⌘ bindings require terminal support for the extended keyboard protocol. Full-screen mouse mode is enabled by the profile patch, although fullscreen: true is otherwise off by default. The plugin operates on the terminal surface, including keyboard and mouse input and clipboard handling.

Written from the project's own documentation and kept in sync with it. Where the two disagree, the source is authoritative — read the README on GitHub

Same category