dsh-plugin-pin-session
Pin any DSH session to the top of your sidebar — one click, host-side persistence.
JSON API —
GET /pin-session/pins ·
POST /pin-session/pin ·
POST /pin-session/unpin
A DeepSeek Harness web plugin that pins sessions: a collapsible Pinned Sessions
group above the sidebar session list, plus Pin / Unpin entries in every
session row's ... menu. Pure client+host bundle — zero changes to DSH core,
pin order stored host-side so it follows you across browsers and origins.
✨ Features
- 📌 Pin / Unpin in the row
... menu — one entry per row, label reflects current state.
- 🗂️ Collapsible Pinned Sessions group directly above the session list:
- click a pinned row to open that session (
sessions.open);
- hover reveals an
× quick-unpin;
- header toggles collapse (persisted per browser via
localStorage);
- sessions no longer present in the list render dimmed and are not clickable.
- 💾 Host-side storage at
$DSH_HOME/storages/pin-session.json — pin order
is oldest-first and consistent across browsers and origins.
- 🧩 Zero core surgery — pinned sessions stay in the chronological list;
the shipped WorkspaceBrowser is left untouched.
🚀 Install
dsh plugin --profile web add github:NattoCB/dsh-plugin-pin-session
Then add "dsh-plugin-pin-session" to dsh.profile.bundles in the profile's
package.json. A DSH restart is required — new client bundles join the boot
graph only at process start.
Local checkout instead? dsh plugin --profile web add file:/absolute/path/to/dsh-plugin-pin-session
⚙️ How it works
| Half | Mechanism |
|---|
| Host | webServer.register({ kind: 'prefix', path: '/pin-session' }) JSON API over an atomic JSON file store |
| Row menu | The shipped session-row menu portals a role="menu" element to document.body; a MutationObserver matches each menu to its row via React fibers (props.node.id) and appends one Pin/Unpin item styled with the menu's own classes, closed by an outside pointerdown |
| Section | A React root planted before the [role="tree"] session list renders each pinned row's own real primitives.Menu, anchored at that row's ... button and wired to the same live callbacks (onRename(id, title) / onFork(id) / onArchive(id)) resolved from the row's fiber |
The shell freezes every vendor module it serves (Object.isFrozen(primitives) === true),
so shared components cannot be monkey-patched — but they can be called. The
section menu therefore opens at the pinned row (not wherever the original row
is scrolled) while rename/fork/archive stay single-sourced in the shipped
browser; the ... affordance hides while the real row is not rendered
(collapsed group / filtered list).
No pin icon ships in the primitives set, so the menu item embeds its own
pushpin SVG.
✅ Verify after refresh
- Sidebar shows Pinned Sessions above the list once at least one session is pinned.
- Hover a session row →
... → Rename / Fork / Archive + a pushpin-iconed Pin.
- Click Pin → row appears under Pinned Sessions; menu flips to Unpin.
- The pinned row's own
... opens right at that row with the same actions.
- Click a pinned row → that session opens; Unpin removes it.
- Collapse the group → reload page → collapsed state survives (
localStorage).
cat ~/.dsh/storages/pin-session.json shows the id list.
🔌 API
GET /pin-session/pins -> { pins: [{ id, title?, pinnedAt }] }
POST /pin-session/pin {id, title?} -> { pins }
POST /pin-session/unpin {id} -> { pins }
🧪 Test
npm test # node --test — 11 cases across store + HTTP router
License
MIT — see LICENSE.
