dsh-chat-ux

English | 中文

A chat-area UX plugin for the DeepSeek Harness (dsh) web GUI.

With it installed, reasoning rows fold themselves away when thinking ends, process groups open and close on their own, and the composer and readouts take on this plugin's own look—and none of it ever yanks a reader who scrolled away.

What it does

• Self-folding reasoning rows: a reasoning row expands while thinking and folds when it ends; once you touch it yourself, it stops moving.
• Self-folding process groups: a process group expands when a tool call starts and folds when that stretch ends, with a roller-blind transition in both directions. A row whose body holds several cards (run_code's program plus its output) rolls as one blind, not card by card. Both share one "Automatic folding" switch on the Plugins page. A height-capped process group in standard / compact scrolls vertically only — that rule is always on and is not behind any switch. When dsh's own collapse timing is set to "on next message", the collapse at the end of a stretch is left to dsh; while dsh's own fold animation is driving a row (data-chat-motion), the plugin stays out of the way too.
• File change rows: write / edit calls inside run_code show their diff lines right in the chat area For direct calls, the path, input size and +n -m appear while the arguments are still streaming, both counts growing as the content arrives (each starts counting as soon as its own field arrives, and neither waits for the path — a write puts file_path last); the digits at the end of the row pop on a beat so each reel turn plays out in full (same for a write and an edit), and switch to live following once the call settles (on by default; turn it off on the Plugins page).
• Caret motion: the input caret slides, 80 ms, whether you type, arrow around, or click. It covers the main composer, the answer box of a question card, and the inline editor for queued messages (the one you use for follow-ups to a running subagent).
• Send bubble morph (on by default): once sent, a slab the size and colour of the composer lifts off its top edge carrying the text you just typed, narrowing as it goes and re-wrapping to the shrinking width, then turning into the colour of the bubble it lands on — 350 ms in all. The composer itself stays put the whole time; the slab rises off it rather than the input being wiped and redrawn. A switch on the Plugins page turns it off.
• Work details default to Standard: on the web client, dsh's "Work details" setting is filled in as Standard (dsh's own web default is Detailed). Once you pick a mode yourself under Settings → General, your choice wins and the plugin leaves it alone.
• Cache-hit rate: the pill under the composer keeps one decimal, and its colour walks a six-stop ramp from 90% to 99% — red below 90, deep green at 99 and above; the label beside the reading takes the same colour (the token total and the separator dot in Detailed mode do not). When the reading changes, the digits that changed pop to their new values — each one drops back in from just below while the old digit fades out the other way (500 ms, lower digits starting later); a switch on the Plugins page turns it off.
• Context occupancy as a pie: the ring becomes a solid 16px pie on a 20%–40% ramp (green below 20, red at 40 and above), with the reading in the same colour. The occupied slice is cut along a fold line pivoted at the centre and slides out along the bisector, and the gap between the two pieces is a constant 1.2px wide; turn the whole pie off on the Plugins page and dsh's own ring comes back. The percentage beside it pops too.
• Composer glass (on by default): the input card keeps its own blue gradient — the same two-ends-tinted, middle-clear shape DSH uses on its sidebar, with the end tints kept faint enough to be only just visible — lets just under a tenth of it through, and adds a light blur plus a top highlight, an inner rim and a bottom inner shadow. The send button (stop while it runs) and the add button on the left wear the same material — a blue slice of that glass for the send circle, a neutral one for the add circle. The stats row below and the cards above are untouched, and the fade band above it still fades to the canvas colour. A switch on the Plugins page turns it off.
• Trajectory tab without the composer: on the Trajectory tab dsh floats the composer over the ledger; the plugin takes the whole composer seat out so the ledger runs to the bottom, and it comes back the moment you switch back to Chat.

Install

In the dsh web GUI, open Plugins → Add plugin and enter the package name:

@alm-allen/dsh-chat-ux

Or from the command line (this forwards to pnpm inside the profile directory):

dsh plugin --profile web add @alm-allen/dsh-chat-ux

Restart dsh and reload the page. To remove it, use the plugin page or:

dsh plugin --profile web remove @alm-allen/dsh-chat-ux

Install from the GitHub repository

You can also install straight from the repository — the build output is committed, so no build approval is required:

dsh plugin --profile web add github:Alm-Allen/dsh-chat-ux

Pin it to a commit so later pushes cannot change what you installed:

dsh plugin --profile web add github:Alm-Allen/dsh-chat-ux#<commit-sha>

Configuration

Every switch lives on the plugin's own row on the Plugins page:

"Work details" is not on the plugin card: it lives in dsh's own Settings → General, and the plugin only fills in Standard while you have not chosen a mode yourself.

Compatibility

• Developed and verified on dsh 0.2.1-rc.1 (web) and 0.2.1-alpha.2 (desktop). The minimum supported release is 0.2.1-alpha.1; 0.2.0-rc.2 and older are no longer supported — the 2026-10-17 drop removed the data-text-shimmer alias, the old dock-shape branch, the built-in stats pill takeover (legacy-usage-pill.ts), and the file-mutation row's raw-argument prefix scan.
• From 0.2.1-alpha.1 on, the stats dock carries data-composer-dock and every preparing block carries block.args; the plugin reads those directly. On anything older it leaves what it cannot recognise untouched instead of drawing it wrong.
• Node ^22.19.0 || >=24.0.0.

About this repository

This repository carries the plugin's source and release notes. Build scripts and internal design docs are not part of it, so a fresh clone cannot run npm run build; install the package from npm instead.

Every release is recorded in CHANGELOG.md — the tag-triggered workflow takes the release notes out of it.

License

MIT