tianxiaz/dsh-recent-sessions

English · 中文

A Recent sessions section that lives in the DeepSeek Harness left sidebar exactly like the official Workspaces — favorites, running, waiting-for-you, unread completions and recently active sessions at a glance; collapse it to one line when you need the room, search it in place from the magnifier, and favorite any session with the ☆ on its row.

Illustration with demo data, not real sessions

Folded: the whole block is one 36px row; click the title to expand and the choice is remembered — Workspaces gets its height back right away

🌐 Landing page (illustrations + install entry): https://tianxiaz.github.io/dsh-recent-sessions/

It shares the official Workspaces grid and interactions (36px section header / 34px project row / 32px session row / 28px overflow row), so it reads as part of the sidebar: no extra page, no floating panel, and not one change to the official session browser.

Nice touches:

• every session row carries a ☆ — the official list included — so favoriting is one hover-click anywhere, no drag and no need to open the session;
• the whole block folds into a single line (with the choice remembered);
• the magnifier turns the header into an input that searches this section; matches are highlighted, Enter opens the first hit, and ↑ / ↓ walk the section from the keyboard;
• favorites can be reordered by dragging, and hovering a favorite reveals ↑ "move to top";
• a category you folded or expanded by hand keeps that state across hard reloads — so does the section's scroll offset;
• pending rows say "Approval" / "Question" instead of only a relative time.

The problem it solves: with a few tasks in flight, "what is running, what finished and I haven't read, what is waiting for my approval or answer, and which ones do I keep coming back to" takes a lot of scrolling. This section pins favorites / running / waiting for you / unread completions / recently active to the top, with yellow-blue-green status dots, so the next click is obvious — and favoriting is either a ☆ click or dragging the session row onto Favorites.

It takes over the left column shell, so the group sits above the workspace groups instead of living on its own page, and the official session browser (search, session … menu, drag reorder, archived filter, workspace management) keeps working unchanged inside it.

Layout details

• The section header matches the official section header: 36px tall, 14px/20 label-tertiary, 4px left padding, with the title always fully visible; the title is clickable, and three 28×28 icon actions sit on the right (search sessions, collapse/expand, open in the panel).
  • Collapse to one line: clicking the title (or Collapse) folds the whole block into a single 36px row, giving the workspace list its full height back; the choice is remembered in the browser.
  • The panel page no longer takes a row in the sidebar's panel list (it duplicated the section); open it from the ⤢ action instead.
• Search in place: the 🔍 action turns the title row into an input and filters this section's sessions by title or workspace; Esc or × closes it (results update as you type).
• Each category is a workspace-style project row: 34px tall, 16×20 glyph slot, 14px/20 title, a filled triangle that takes the glyph's place on hover, click to fold, plus a 10px count.
  • Defaults: Favorites always starts folded (with a "Drag in or ☆" hint while empty, and its count while it holds sessions); categories holding sessions waiting for you, running, or unread start expanded while Recently active starts folded; when none of those hold anything, Recently active starts expanded.
  • Your fold choices are remembered: once you fold or expand a category by hand, that choice is stored in localStorage and restored after a hard reload or a later visit — including "Favorites is expanded".
• Each session row matches the shipped row: 32px tall, status dot in the 16×20 slot, 14px/20 title, 10px relative time; on hover the time yields to the ☆ star; the session open in the main column keeps the selected background.
• The overflow row is the shipped Show N more sessions / Collapse (28px, 12px, label-tertiary).
• 2px between rows and 4px between groups, the same rhythm as the official list; a 1px divider separates this section from Workspaces.

Favorites

Three ways:

1. click the ☆ on a session row (a new hover button in the shipped row strip);
2. drag a session row onto the Recent sessions group (from the official list below);
3. open the panel page from the ⤢ action on the section header, then drop onto Favorites, or onto an existing favorite to reorder.

Favorites keep their display order and are stored in the browser (see Data).

Install

From the plugin market (recommended): Plugins → Discover → Add index source and paste

https://tianxiaz.github.io/dsh-recent-sessions/market/index.json

GitHub Pages caches for about 10 minutes, so a release shows up quickly. If that host is unreachable on your network, use the jsDelivr mirror (branch cache ~12 hours): https://fastly.jsdelivr.net/gh/tianxiaz/dsh-recent-sessions@main/market/index.json

Command line:

dsh plugin --profile <profile> add "git+https://github.com/tianxiaz/dsh-recent-sessions.git"

From a local directory (development):

plugin_manager install_bundle  <absolute path>/dsh-recent-sessions

Reload the Web page afterwards (hard reload).

⚠️ Sidebar takeover

Both key seats of the left column are single-occupant slots, so a plugin cannot insert a section beside the shipped groups:

Slot	Shipped occupant	What it is
sidebar	@deepseek-ai/dsh-client-ui-sidebar SidebarRoot	the whole left column shell (brand row, New session, panel list, foot)
sidebar.workspaces	@deepseek-ai/dsh-client-ui-workspace WorkspaceBrowser	the session browsing region

So this plugin owns the shell and reuses the browser:

• its bundle patch disables ui-sidebar (- id: ui-sidebar + disabled: true);
• it registers the sidebar seat and declares the same eight child slots (brand.mark, brand.name, toggle.badge, panellist, panellist.actions, workspaces, settings, footer.action), then renders the official WorkspaceBrowser through sidebar.workspaces unchanged;
• it also provides shell.leading (the "open sidebar / new session" window chrome the frame mounts on macOS while the sidebar is fully collapsed) — without it a collapsed sidebar could not be reopened.

Consequences:

• the brand row, New session button, panel list and foot are rendered by this plugin (geometry and colors aligned with the shipped shell, not pixel-identical);
• if DSH changes its sidebar, this plugin needs a matching update (see below);
• to revert, disable or remove the bundle: the official sidebar returns (the panel page and the ☆ button go away with it).

Crash isolation: taking over the shell means "plugin down = no occupant for the column", so the whole sidebar is wrapped in an error boundary. A throw in any child degrades to: a one-line notice, a Reload button, and the official session list rendered as-is — sessions and workspaces stay usable.

Space budget: the Workspaces list always wins — it keeps at least 55% of the available height (and never less than 160px), while Recent sessions is capped at 45% / 420px and scrolls internally; on short windows it keeps only its title row and leaves the height to Workspaces. While you drag a session out of Workspaces, Recent sessions folds to a single line and its header becomes the drop target.

Compatibility and maintenance

• Target: DSH ^0.2.1-rc.5 (engines.dsh).
• Known failure mode: if a DSH release renames or drops the ui-sidebar row id, the patch is warned about and skipped, this plugin's sidebar registration then collides with the shipped shell and the whole plugin stays inactive (the official UI is untouched). Fix: update the row id in cordis.patch.yml and re-align the shell if needed.
• Post-upgrade checklist (all in the sidebar shell region of client.js):
  1. are the sidebar owner props still { collapsed, width };
  2. is the declared child set still those eight slots;
  3. did the shipped SidebarRoot geometry change (logo row 60/36px, new-session 38/36px, panel row 36px, collapsed padding 18/10/6) → update SHELL_CSS;
  4. owner props of sidebar.panellist (size/active) and sidebar.workspaces (wide/expandSidebar);
  5. shell.leading mount condition (macOS + collapsed);
  6. whether the official browser is still a single occupant of sidebar.workspaces.

Data and privacy

• Client-only plugin: no network requests of its own.
• Favorites, the section's one-line state and each category's fold choice live in the current browser's localStorage: dsh.recent-sessions.favorites.v1 (session ids in display order), dsh.recent-sessions.inline.open.v1 (section folded to one line or not) and dsh.recent-sessions.cats.v1 (per-category fold choices).
• Archived sessions are not listed (their favorite entries are kept and return when unarchived); favorites are per origin, so another browser or host does not share them.

License

MIT, see LICENSE.