npm

<p align="center"> <img src="https://raw.githubusercontent.com/openma-ai/deepseek-harness-tui/main/assets/tui-whale.svg" width="424" alt="DeepSeek Harness TUI whale" /> </p>

<h1 align="center">DeepSeek Harness TUI</h1>

<p align="center"> Terminal-native ACP client UI with a Cordis client plugin tree. </p>

---

Native binaries are packaged for macOS arm64, macOS x64, Linux x64, and Windows x64. Requires Node.js 18+.

Recommended

npm install --global @deepseek-ai/dsh
dsh plugin --profile tui add @openma/deepseek-harness-tui@latest
dsh --profile tui

The profile command is the recommended install and upgrade path. It creates a missing profile and installs the TUI plus its ACP dependency; no global dsh-tui installation is required.

The profile Host mounts the ACP plugin on Base, then starts a separate TUI Client process over standard ACP stdin/stdout. For standalone use, run dsh-tui and use --agent <cmd> plus repeated --agent-arg <arg> for another ACP server. The Node Client process owns a Cordis tree and starts the Rust painter. A sibling tui-cordis-client-runner publishes TUI Client capabilities and evaluates approved code.client packages from dsh-tool-cordis against that client tree.

ACP is a runtime dependency of this package. On a profile that already carries a different version through the standard ACP bundle, the package manager may retain both copies, but the TUI bundle replaces that surface's rows and mounts only the plugin resolved from TUI's own dependency graph. The supported profile shape never runs two ACP surfaces for one TUI.

The package carries ACP as a runtime dependency and exports its Creator Host overlay internally. The profile bundle mounts both on the Host Base tree; neither enters the Client tree. Creator adds TUI plugin guidance to the existing cordis preset and does not use ACP for skill registration.

Node and Rust use inherited pipes on Unix and an authenticated loopback TCP socket on Windows. This compositor channel carries theme/render data only; agent traffic remains ACP.

Demo

dsh-tui --demo
dsh-tui --demo-skin

dsh-tui is the primary command. dsb is a compatibility alias.

Highlights

• Streamed reasoning, replies, tool activity, subagents, run state, and

token/cache metrics in one terminal timeline.

• Agent-advertised models, compositions, permissions, authentication methods,

and invocable skills in one searchable slash menu.

• Up to eight editable image chips per prompt, with clipboard/file staging and

metadata previews on kitty-capable terminals.

• Terminal-aware Markdown for headings, lists, quotes, code, emphasis, links,

and mixed CJK/Latin text.

• Durable sessions, queued follow-ups, immediate steering, readline editing,

platform-native modifier bindings, mouse selection, and inline-expanded tools.

• Dark/light themes, clipboard routing for local, tmux, and SSH sessions, plus

the optional /liang pixel companion.

• A root chrome.right plugin rail for validated TuiNode trees, with live

update/unload and Client inspect support for Creator-authored plugins.

• Lifecycle-owned local commands and native slider overlays, plus transactions

over the current Session's standard ACP configOptions.

• Dynamic code.host + code.client Packages with inspect/run lifecycle and

package-private Host/Client RPC over a negotiated _dsh/cordis/* ACP extension. Ordinary ACP agents remain usable when they do not advertise it.

Plugin surface

TUI extensions are ordinary Cordis plugins on the Node Client tree. A single plugin may register a theme, chrome.right nodes, slash commands, overlays, timers, Session config transactions, and Host/Client RPC; all contributions leave together when its fiber stops or /theme replaces the selected Theme Plugin. Plugins submit semantic data and never receive the TTY, Ratatui, absolute coordinates, compositor fds, or private transport methods.

The versioned contract and examples live in the repository's plugin API.

The demo needs no API key or agent. Run dsh-tui --help for agent, model, credential, session, theme, and demo options.

Supported platforms

If installation succeeds but launch reports no native binary for ..., confirm that you installed the latest version and that your platform appears above.

Uninstall

npm uninstall --global @openma/deepseek-harness-tui

Source, screenshots, development commands, and architecture notes live in the GitHub repository.

MIT.