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

On DSH 0.1.2-rc.1, the official PTC preset id is ptc. Pressing Esc in the resume picker cancels without opening another session.

Version 0.2.0 requires DeepSeek Harness 0.1.3-alpha.2 or a compatible later build. Session listing, resume and export use the current handle API. Live reasoning and text consume the transient assistant stream, while the log stores final messages.

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 ….