dsh-agentbox
Mobile and small-screen fixes for the DeepSeek Harness (DSH) web shell, packaged as a plugin rather than a patch — so it survives DSH updates.
Born from running DSH as an always-on agent box driven mostly from a phone. DSH's web shell is desktop-first: its entire stylesheet contains exactly one media query (prefers-reduced-motion) and no responsive breakpoints, so at phone widths it renders the desktop three-column layout unreflowed.
What it does
Everything ships behind a toggle and defaults to on.
| Toggle | Effect |
|---|
mobileCss | ≤640px only: reclaims the 56px rail, lets the open sidebar overlay the chat instead of squashing it, makes tapping a session auto-collapse the sidebar, and stops the transcript bleeding through the composer. |
usageDockCompact | Keeps the usage indicator to one line. |
usageDockTerse | Rewrites the dock to glyphs (↓319M ·↑937K ·⚡100%), dropping the noisy metrics. |
enterNewline | On mobile, Enter breaks the line and the send button sends — the mobile convention. Stock DSH sends on Enter and only Shift+Enter breaks the line, which is two awkward taps on a phone keyboard. |
Plus small correctness fixes: the composer gets an opaque background so the transcript can't paint through the band around it, and the dock is set to wrap rather than clip.
Install
# into a profile — `dsh plugin` forwards to pnpm in the profile directory
dsh plugin --profile web add github:charysrinathsc/dsh-agentbox
# then sign the profile
dsh restart
The package carries a dsh.bundle.patch, so it is composed into the profile automatically. To disable a feature, override it in the profile's cordis.patch.yml:
- id: dsh-agentbox
config:
enterNewline: false
Requirements
- DSH with a web profile
- A browser at ≤640px for the mobile work; the rest applies at any width
Caveats, stated honestly
- The composer still sits behind the iOS keyboard. iOS Safari shrinks the visual viewport but not the layout viewport, so the composer's toolbar row ends up under the keyboard. A fix that resized the frame to
visualViewport.height made this worse and was reverted — see INTERNALS.md. Treat this as an upstream issue.
- Class names are hashed (
_3WPZCG_toggle, yhfFVG_card). They are matched by substring, which is inherently fragile. tools/health.mjs checks 25 load-bearing assumptions against a running instance and exits non-zero when DSH moves something.
- Developed and verified against one DSH version. It is CSS and DOM-shape dependent; expect to re-check after DSH updates.
Development
INTERNALS.md is the engineering log: every measurement, dead end, and trap — including three self-inflicted regressions and what caught them. If you are changing this plugin, read it first; it will save you the same afternoons.
Two harnesses live in the sibling tools/ directory of the origin workspace:
health.mjs — do the selectors this plugin depends on still exist? (assumptions)regress.mjs — do the features still work? (behaviour, in WebKit, since Chromium and iOS Safari do not measure text identically)
Both exit non-zero on failure.
License
MIT
