dsh-session-vault: A Session Vault for Carrying DeepSeek Harness Sessions Across Machines

What Does It Do?

Session Vault is a DSH plugin for DeepSeek Harness that turns local DSH sessions into portable archives you can carry between machines. It solves the migration problem: after switching computers, changing workspace directories, or upgrading the harness, old sessions tend to stay stranded on the original disk. Maintained by jr-create under the MIT license, it ships both a host-side component and a browser settings UI, plus model tools so an agent can move sessions on its own.

Core Features

• Session export: select sessions and pack them into a single archive file, or export everything when nothing is selected; archives are written to the exports directory and downloaded to the browser.
• Partial success with per-item reporting: unreadable sessions are skipped with a stated reason while the rest still export, and only a total failure raises an error.
• Import and migration paths: upload or pick an archive, re-persist it through the harness persistence service, mount it in the workspace sidebar, and optionally point it at a new workspace directory.
• ID conflict handling: existing sessions are skipped by default, or imported under a new ID so both copies survive.
• Dry run and archive management: a preview mode outputs the plan without writing anything, while the archive tab lists, downloads, inspects, and deletes exported archives.
• Session cleanup: permanently remove unmounted and unarchived sessions, archived unmounted ones, and never-used empty shells, with preview and double confirmation first.

How to Use This Plugin?

After enabling it in DSH, open the Session Vault panel in settings, which has four tabs: export, import, archives, and cleanup. On the export tab, search and tick sessions, then export the selection and download it. On the import tab, click or drag in an archive; the panel lists its contents first, then you can set a new workspace directory, choose a conflict strategy, decide whether to create directories automatically, and finally preview or start the import. The cleanup tab gives each of the three junk categories its own scope label with always-visible counts, and deletion only unlocks after a preview and an explicit acknowledgement. Archives are gzip-compressed normalized JSONL holding events returned by the persistence service rather than raw disk bytes, so they survive format generations and import into newer harness versions; agents get the same round trip through session list, export, archive inspect, import, and delete tools.

How to Troubleshoot This Plugin?

A failed plugin tree load that stops dsh web from starting usually means host dependencies were introduced: a linked plugin resolves bare module names upward from its own real path, which sits outside the harness profiles directory and cannot reach the harness dependency closure, so the whole tree fails. Fix it per the official instructions by keeping the plugin dependency-free, not copying any dependency directory, and not adding dependency declarations; the plugin already replaces host packages with local implementations and obtains host services through the context.