# dsh-recent-sessions

**Every session you have been working in, across every workspace, in one panel — plus a place to jot down a thought and have it come back to you when you reopen that conversation.**

A [DSH (DeepSeek Harness)](https://harness.deepseek.com) client plugin. 中文说明见 [README.md](README.md).

![The Recent sessions panel: one flat list of sessions across every workspace, with workspace chips, last-prompt previews, time grouping and the open-in-a-separate-window button](assets/screenshot-1.jpg)

---

## Why this exists

DSH's sidebar groups sessions by workspace, shows the newest few rows per workspace, and only lists workspaces you registered. Once you work in a dozen directories at once, a project you have not touched for a while is simply **not on screen** — and a session that lives in a directory you were not looking for is effectively lost.

There is a second, quieter problem: the thought you have about an answer **twenty minutes later**, while doing something else, has nowhere to go. You either remember it or you lose it.

This plugin adds a **global panel** that is not tied to any session — one flat list of every session across every workspace — and a way to capture a deferred thought without waking anything up.

## What you get

- **One flat list across all workspaces.** Every session, newest first, including sessions the sidebar is currently hiding (collapsed workspaces, unregistered directories). Each row carries its workspace as a **clickable chip** — click it to filter to that workspace, click the chip in the toolbar to clear.
- **"What was I asking?"** — a second line per row with that session's last human prompt, read from the host's `turnOutline` session projection. Hover it to see a preview of the last assistant reply.
- **Time grouping and two sort orders** — Today / Yesterday / This week / Earlier; sort by **most recent** or by **least recently touched** (for cleanup — the time buckets flip as well).
- **Filters** — only unfinished / include blank sessions / include subagent sessions; archived sessions stay hidden by default. Your view state is remembered locally.
- **Find it again** — full-text search over message content (host index), instant local title/path filtering, and per-row actions: open the session, **reveal its folder in your file manager**, copy the path.
- **Deferred thoughts.** Jot one line on any row. It is stored locally and nothing is sent. When you open that session, a **one-line strip** appears above the composer: expand it to **insert the text into your draft** (an official, undoable editor insertion), say *not now* (the thought stays, it just stops nagging), or discard.
- **A separate window.** Open the panel in its own same-origin window; it selects itself on load.
- **Quiet by design.** No notifications, no red badges, no auto-archiving. "Long untouched" is expressed by grouping, not by alarm.

## Install

From the plugin market inside DSH, or:

```bash
dsh plugin --profile <your-profile> add dsh-recent-sessions
```

## How it works

Everything goes through **documented extension points** — no DOM hacks, no monkey-patching:

| What | Where |
|---|---|
| Global panel | `main` keyed slot, key `recent-sessions` |
| Sidebar entry | `sidebar.panellist` (its `id` must equal the panel key) |
| Floating entry | `shell.overlay` (the layer is click-through; only the pill takes pointer events) |
| Thought strip | `conversation.input.dock` (session scope) |
| Draft insertion | `InputActions.captureInsertion()` + `insertText(text, span)` |
| Session list | root hooks `useSessions` / `useSessionStatus` / `useWorkspaces` |
| Prompt previews | `ctx.sessions.refreshProjections(id)` → the `turnOutline` projection |
| Content search | `ctx.sessions.search(query, signal)` |
| Reveal folder | `ctx.remote.session.canOpenWorkspacePath()` / `openWorkspacePath({ path, action: "reveal" })` |

## Privacy and footprint

- **The host half does nothing at all** (empty `apply`): no tools, no HTTP routes, no session events. The plugin never writes to your conversations.
- Notes, thoughts and view state live in your browser's `localStorage` only, under the key `dsh-recent-sessions:store:v1`.
- The only write path is one you trigger yourself: inserting a thought into a draft, and the message you then choose to send.
- **No build step.** `lib/client.js` is a hand-written bundle in the platform's own module format (`window.__ModuleLoader__.load({ id, factory })`), so the published tarball is two small JS files and nothing else runs at install time.

## Compatibility

- DSH `>= 0.2.0-rc.2`, declared in `engines.dsh`.
- No `@deepseek-ai/dsh-*` peer requirements are declared **on purpose**: a mismatched DSH peer range blocks activation, so the requirement stays advisory instead of becoming a hard gate.
- Node `^22.19.0 || >=24.0.0` for the host half.

## Known limitations

- The separate window still boots the whole DSH shell (it only switches to this panel). A chrome-less compact window is planned.
- Prompt previews are fetched for the first 30 rows only.
- Bundled UI strings are Chinese and English; more locales are welcome.
- *Reveal in file manager* depends on the host reporting a desktop; the button is hidden when it does not, and falls back to copying the path.

## Development

The client half is discovered from `exports["./client"]` and served by the platform's module loader:

```js
window.__ModuleLoader__.load({
  id: "dsh-recent-sessions",
  factory: (require) => {
    const React = require("react"); // ← the shell's PLATFORM_MODULES baseline
    // ...
    return module.exports;          // ← needs apply / inject
  },
});
```

Editing `lib/client.js` is picked up by a running browser within about a second (client HMR polls bundle revisions). Editing `lib/index.js` or changing the package version needs an app restart.

## License

MIT