dsh-left-sidebar-collapse

English | 中文

Auto-collapse / fully-collapse the DSH left sidebar when you select a conversation. A standalone, installable DSH plugin (pure client, no ui-layout framework changes).

Two independent preferences appear in Settings → General:

1. Auto-collapse sidebar — after you select a conversation, the left sidebar collapses to its 56px rail. Deterministic: a plugin-internal state machine drives ctx.layout and reads the stable data-sidebar-collapsed frame signal, holding against the layout's own feedback so it never double-toggles. 2. Fully collapse — when the sidebar is collapsed, tuck it completely away (the rail is removed, the grid's first track collapses to 0) and show a single floating expand button in the top-left. Clicking it restores the full sidebar. The conversation pane stays at full width — nothing else is disturbed.

The preferences are persisted in localStorage (process-local browser preference), so the toggles are always writable and survive reloads.

Install

Requires DSH (DeepSeek Harness) dsh CLI.

dsh plugin --profile web add git+https://github.com/condaThinker/dsh-left-sidebar-collapse

Then restart the profile:

dsh --profile web
# or whatever your run command is for the profile you installed into

After install, open Settings → General and toggle Auto-collapse sidebar (and optionally Fully collapse).

Git install and the prepare build

This plugin ships a self-contained prepare build script (tsdown), per the DSH plugin distribution convention. When installed by git, pnpm runs that script to build lib/ in the profile, so it needs network access to resolve the DSH peer/dev dependencies and the profile must allow the build script: add dsh-left-sidebar-collapse to the profile's allowBuilds (see pnpm ≥10 allowBuilds/strictDepBuilds), then re-run the dsh plugin add. For a zero-build alternative, a maintainer may instead commit a freshly built lib/ into the repo and drop prepare — but the recommended path is prepare.

Build

pnpm install
pnpm build
pnpm test

How it works

• Auto-collapse: a listener on ctx.sessions.list notices when the

current session moves to a different real session; the [AutoCollapseMachine](src/client/collapse-machine.ts) then collapses the sidebar via ctx.layout.toggleSidebar() only while the frame renders it expanded (reading data-sidebar-collapsed), and suppresses further flips until the frame confirms the collapse — no double-toggle, no flip-back.

• Fully collapse: a shell.overlay occupant (FullCollapseButton)

reactively watches data-sidebar-collapsed; when collapsed and "fully collapse" is on it injects a tiny grid-template-columns: 0 minmax(0,1fr) 0 !important override (so the sidebar track → 0 and the center reclaims the width) and shows the single expand button.

The client bundle respects DSH's module-table purity: only platform modules (ui-primitives, the documented dsh-client-runtime exemption) are value-imported; everything else is a type-only contract pull.

Model Experience

None, as the plugin only moves the browser layout column and never enters the append-only Session log, the model context, or telemetry.

#### KV Cache effect

None; the collapse gesture does not touch the history tail.

Known Limitations and Deferred Work

• dsh-better-sidebar coexistence — both plugins manage sidebar state

independently; if the toggle looks like it fires without the flag on, check whether another sidebar plugin (e.g. dsh-better-sidebar) is also collapsing. This plugin is strictly off when its toggle is off.

• The collapse gesture is a toggle, not a store write — because

ctx.layout exposes only toggleSidebar(), the plugin keeps the state machine above to avoid double-toggling, but it cannot move the layout store directly.