dsh-tui-app

DSH TUI App

简体中文

A readline-based interactive terminal profile bundle for DeepSeek Harness.
It keeps DSH's model, Agent Preset, session, permission, command, and tool
services, and supplies a terminal chat surface over them.

This is an independent lightweight implementation. It is not the React/Ink
project published as ccch1mneyyy/dsh-TUI.

Preview

The image is cropped from a real local dsh --profile tui startup. Shell
history and window chrome were removed, and the workspace path was anonymized
as /workspace/demo; it contains no user name, home-directory path, session
ID, or personal project information.

Features

• Streaming assistant text, reasoning, tool calls, tool results, and
  Codex-style [Image #N] placeholders for image output/history.
• Native rc.1 image input through repeatable --image/-i startup flags or
  /image for the next prompt; pasted image paths are attached automatically,
  and Ctrl+V reads a copied Finder file or bitmap on macOS. This is the Control
  key, not Command/⌘V: Terminal does not forward a bitmap-only Command+V paste
  to the TUI process. Pending images use
  [Image #N] placeholders while attachment bytes remain in DSH's local store.
  Before sending, the TUI uses rc.1's model-capability preflight and retains
  the pending batch when the selected model is explicitly text-only.
• Direct MP4 input through repeatable --video/-v, /video, pasted paths,
  or a copied Finder file. Original video bytes are sent to a compatible
  OpenAI video_url endpoint without local frame extraction.
• Bordered TTY composer with command completion, history, resize reflow, and a
  plain line-loop fallback when stdin/stdout are pipes.
• New, resume, list, and delete session flows over DSH's durable session store;
  deletion goes through the official SessionController so workspace registration
  is cleaned up and sessions owned by another lifecycle are rejected safely.
• Blank-session Agent Preset selection; the preset is locked after the first
  model-loop turn.
• Model and reasoning-effort pickers, plus permission-preset cycling with
  Shift+Tab.
• DSH slash-command registry and user-invocable Skill integration, plus an
  explicit !<command> local shell shortcut.
• Optional Audit integration: unaccepted audits appear as separate green or
  red transcript blocks. a executes the proposal unchanged; e loads it into
  the composer for editing and Enter executes it. Warning is steered after the
  current tool call without canceling the Agent; critical is already paused and
  starts its accepted repair immediately. A paused Audit uses c to copy
  feedback through OSC 52.

Install

Requires DeepSeek Harness 0.1.1-rc.1 or a compatible later build.

dsh plugin --profile tui add github:yhfgyyf/dsh-tui-app
dsh --profile tui

The first command creates the tui profile when it does not exist, adds this
package as a standard dsh.bundle, and records it in that profile.

Startup options:

dsh --profile tui --help
dsh --profile tui --preset minimal
dsh --profile tui -i diagram.png
dsh --profile tui -i a.png -i b.jpg
dsh --profile tui --resume <session-id>

The standalone default is standard. To make first-prompt automatic routing
available and default, install the router bundle after this TUI bundle:

dsh plugin --profile tui add github:yhfgyyf/dsh-auto-preset-router
dsh --profile tui --preset auto

To add the explicit fifth Audit preset and its persistent Codex review,
install the Audit bundle too. It does not become an Auto Router target:

dsh plugin --profile tui add github:yhfgyyf/dsh-audit-mode
dsh --profile tui --preset audit

Commands and keys

Local commands include /help, /image, /video, /sessions, /resume, /preset,
/new, /model, /effort, and /exit. /image a.png,b.jpg attaches images
to the next prompt and /image clear removes the pending batch. /model lists
models from every configured provider; /model <provider>/<id> switches routes.
The shipped DeepSeek V4 Flash/Pro routes are text-only; rc.1 adds the official
deepseek-v4-flash-vision-exp image model. Select that model, or another route
that declares image input, before sending. DSH application commands such as /compact,
/goal, /feedback, and /export are merged from the shared command
registry when their providers are composed.
Audit adds /audit status|now|history|accept|resume through that same registry.

User-invocable skills from the active Agent Preset also appear in the / menu.
Type /skill-name, or select it and press Tab to insert /skill-name , then add
the task and send it. The literal prompt is passed to DSH unchanged so the
official agent/pre-step skill path injects the canonical skill content, just
as it does in Web. Skills marked model-disabled remain available with a
user-only label; skills marked user-disabled are hidden. If a host command
and a skill share a name, the host command takes precedence.

Main keys: Enter sends, Up/Down navigate history or pickers, Tab completes,
Shift+Tab cycles permission presets, Ctrl+V pastes a clipboard image on macOS,
Esc interrupts/closes, Ctrl+L clears, and Ctrl+D exits.
With a pending Audit review and an empty composer, a executes remediation
unchanged and e opens an editable draft; Enter executes it and Esc cancels.
While paused, c copies the latest feedback. r resumes only a failure/manual
pause that has no pending critical approval.

Security boundary

!<command> is an explicit human-operated shell escape. It launches the
user's shell directly in the current workspace and therefore does not pass
through the Agent tool sandbox or approval policy. Only run commands you trust.
The ordinary model-driven shell tools remain governed by the active DSH preset
and permission configuration.

Like any DSH plugin, this package runs with the permissions of the DSH process.

Remove

Remove the Auto Router first if it was installed into the same profile:

dsh plugin --profile tui remove dsh-auto-preset-router
dsh plugin --profile tui remove dsh-tui-app

Session data under $DSH_HOME is not deleted.

Development

npm test
npm run check
npm run pack:check

The repository follows the current DSH distribution contract: package.json
declares dsh.bundle.patch, and cordis.patch.yml composes the terminal app
through dsh plugin --profile … add ….